Configuration

Step 1: Choose Your Environment

Environment	API URL	Dashboard
Production	https://api.fungies.io/v0	app.fungies.io
Sandbox	https://api.stage.fungies.net/v0	app.stage.fungies.net

Important: Production and staging are completely separate. API keys, products, and webhooks are all independent. Staging keys will NOT work against the production API, and vice versa.

Configure Webhook URL + Post-Purchase Redirect URL in your Fungies Dashboard

Step 2: Get Your API Keys

1. Log in to your Fungies Dashboard (production or staging)

2. Go to Developers → API Keys

3. Click Generate API Key

4. Copy your Public Key (pub_...) and Secret Key (sec_...)

5. Copy your Webhook Secret from Developers → Webhooks

Step 3: Plugin Settings

Navigate to WooCommerce → Settings → Fungies and fill in:

Setting	Value
Sandbox Mode	Check if using staging
Public Key	Your pub_... key
Secret Key	Your sec_... key
Webhook Secret	From Fungies webhook settings
Fungies Store URL	Your store URL (see Step 4)

Step 4: Match Store Currencies

Your WooCommerce store currency must match the currency set in your Fungies workspace.

1. Check your Fungies currency in Fungies Dashboard → Settings → General (under "Currency")

2. Check your WooCommerce currency in WooCommerce → Settings → General (under "Currency options")

3. Make sure both are set to the same currency (e.g. both USD, both EUR)

If the currencies don't match, product prices will display incorrectly and checkout totals may be wrong.

Step 5: Publish Your Fungies Store & Get the Store URL

Your Fungies store must be published for the hosted checkout to work.

1. In the Fungies Dashboard, click "Go to Store" in the top menu

2. Make sure the store is published (not draft)

3. Copy the store URL — it looks like:

   • Production: https://yourname.app.fungies.io

   • Staging: https://yourname.stage.fungies.net

4. Paste it into the Fungies Store URL field in WooCommerce → Settings → Fungies

5. Click Save Changes

Step 6: Configure Webhook in Fungies

1. Go to Fungies Dashboard → Developers → Webhooks

2. Add a new endpoint with the Webhook URL shown on the plugin settings page (e.g. https://yoursite.com/wp-json/fungies/v1/webhook)

3. Select the events: payment_success, payment_failed, payment_refunded, subscription_created, subscription_interval, subscription_cancelled

Step 7: Configure Post-Purchase Redirect URL in Fungies

After a customer completes payment on Fungies, they need to be redirected back to your WooCommerce store. This is configured store-wide in the Fungies Dashboard.

1. Go to Fungies Dashboard → Settings → Store → Checkout tab

2. Scroll down to "Success redirection settings"

3. In the Instant Redirect URL field, paste the Post-Purchase Redirect URL shown on the plugin settings page:

   https://yoursite.com/?wc-api=fungies_return

4. In URL Parameters, add these system parameters from the dropdown:

   • Order id (appears as fngs-order-id in the URL)

   • User email (appears as fngs-user-email in the URL)

   Note: The dropdown list shows human-readable names (e.g. "Order id", "User email"). Once selected, they are automatically converted to the correct URL parameters (fngs-order-id, fngs-user-email). The names in the dropdown may differ from the final parameter names -- this is expected.

5. The final redirect URL will look like:

https://yoursite.com/?wc-api=fungies_return&fngs-order-id={fngs-order-id}&fngs-user-email={fngs-user-email}

1. Click Save

How it works: After payment, Fungies redirects the customer to this URL with the Fungies order ID. The plugin looks up the matching WooCommerce order and sends the customer to the WooCommerce "Order Received" thank-you page.

See the Fungies redirect documentation for more details on available system parameters.

Step 8: Test the Full Flow

1. Enable Sandbox Mode and use staging keys

2. Click Sync Now to pull products

3. Add a product to cart and proceed to checkout

4. Select Fungies Checkout and place order

5. You should be redirected to the Fungies hosted checkout page

6. Pay using Stripe test cards

7. After payment, you should be redirected back to the WooCommerce thank-you page

8. Check WooCommerce → Orders — the order should be marked as completed

9. Check logs at WooCommerce → Status → Logs → fungies-*

When ready to go live, uncheck Sandbox Mode, switch to production keys and store URL, and Save Changes.

Test Connection and Sync your One-Time Payment Offers from Fungies to WooCommerce using the buttons