Checkout Flow

  Customer          WooCommerce           Fungies             WooCommerce
  ────────          ───────────           ───────             ───────────
     │                   │                   │                     │
     │  1. Place Order   │                   │                     │
     │──────────────────►│                   │                     │
     │                   │                   │                     │
     │                   │ 2. Create pending  │                     │
     │                   │    order           │                     │
     │                   │                   │                     │
     │  3. Redirect to Fungies checkout      │                     │
     │◄──────────────────│                   │                     │
     │──────────────────────────────────────►│                     │
     │                   │                   │                     │
     │  4. Pay on Fungies│                   │                     │
     │──────────────────────────────────────►│                     │
     │                   │                   │                     │
     │                   │                   │ 5. Webhook           │
     │                   │                   │ payment_success      │
     │                   │                   │────────────────────►│
     │                   │                   │                     │
     │  6. Redirect back │                   │  Order completed     │
     │◄─────────────────────────────────────│                     │
     │──────────────────────────────────────────────────────────►│
     │                   │                   │                     │
     │  7. Thank-you page│                   │                     │
     │◄─────────────────────────────────────────────────────────│

Customers will see Fungies Checkout as one of the available payment methods

Customers will then be redirected to finish the payment on Fungies Hosted Checkout

Customers then await for payment to be finalized

After the payment, user is redirected to a Thank You page

Payment is finalized and you can start processing the order for your customer

In the Order Details - you'll also see Fungies Order Details on the right

Webhook Events

Fungies Event	WooCommerce Action
payment_success	Complete WC order, store Fungies metadata
payment_failed	Update order status to failed
payment_refunded	Create WC refund, set status to refunded
subscription_created	Store subscription ID in order meta
subscription_interval	Create renewal order
subscription_cancelled	Update subscription status in meta

Webhook Security

All incoming webhooks are verified using HMAC-SHA256 signature validation. Duplicate events are filtered via idempotency key tracking.

---

Order Metadata

When a payment succeeds, the following metadata is stored on the WC order:

Meta Key	Description
_fungies_order_id	Fungies order UUID
_fungies_order_number	Fungies order number
_fungies_payment_id	Payment UUID
_fungies_payment_type	one_time, subscription_initial, etc.
_fungies_subscription_id	Subscription UUID (if applicable)
_fungies_invoice_url	Invoice PDF link
_fungies_fee	Fungies processing fee
_fungies_tax	Tax amount

---

FAQ

Q: Does the Fungies store need to be published? A: Yes. The hosted checkout URL only works when your Fungies store is published. Go to the Fungies Dashboard and make sure your store is not in draft mode.

Q: Why don't customers get redirected back after payment? A: You need to configure the Instant Redirect URL in Fungies Dashboard → Settings → Store → Checkout tab. See Step 7 above.

Q: Can I use this alongside other WC payment gateways? A: Yes. Fungies registers as a standard WC payment gateway. Customers can choose it at checkout alongside any other enabled gateways.

Q: Which Fungies products are synced? A: Only OneTimePayment products and their offers are synced. Other product types (Digital Downloads, Subscriptions, Game Keys, etc.) are not imported. The product name and description from Fungies are used for the WooCommerce product listing.

Q: How often do products sync automatically? A: Every hour via WP Cron. You can also trigger a manual sync anytime from the settings page.

Q: How do I test without processing real payments? A: Enable Sandbox Mode, use staging keys from app.stage.fungies.net, and pay with Stripe test cards.