FunnelFox
Connect FunnelFox to your FastSpring account to build conversion funnels with popup and embedded checkouts, subscription management, and recurring billing.
Use FastSpring as your payment provider in FunnelFox. FunnelFox is a funnel builder that handles your conversion flow and checkout experience, while FastSpring acts as the merchant of record — processing payments, managing tax, and handling compliance. Together, they support web subscriptions, embedded or popup checkouts, and recurring billing.
Prerequisites
Before you begin, make sure you have the following.
- An active FastSpring account with API access enabled
- An active FunnelFox account
- At least one subscription product configured in your FastSpring catalog
Supported transaction types
The following payment methods and transaction types are supported with the FastSpring integration in FunnelFox.
| Transaction type | Cards | Apple Pay | Google Pay | PayPal |
|---|---|---|---|---|
| Subscriptions | ||||
| Subscriptions | ||||
| Free & paid trials | ||||
| Upsells | ||||
| One-time products | ||||
| Subscription upsells (2nd sub) | ||||
| Offers | ||||
| Intro offers |
Set up the integration
Keep both your FastSpring and FunnelFox dashboards open — you will switch between them several times during setup.
Configure products in FunnelFox
After setup, FunnelFox syncs your FastSpring products automatically. To connect a product to a FunnelFox Checkout element, you need two values from FastSpring.
FunnelFox requires a customer email before the paywall screen. Make sure you have an Email input element placed before your Checkout element in the funnel — without it, the checkout will not load.
-
Checkout ID: In FastSpring, go to Checkouts > Popup Checkouts or Embedded Checkouts and copy the ID of the checkout you want to use.
-
Product path: In FastSpring, go to Catalog > Subscription Plans and copy the path of the product you want to offer.
Enter both values in FunnelFox's Checkout element settings to complete product configuration.
Test the integration
Before going live, verify the full flow using FastSpring's sandbox environment.
Test a purchase:
- In FunnelFox, configure your test setup in the Sandbox section of the Checkout element.
- Open your funnel in Preview mode.
- Use the following test card numbers with any future expiry date and the CVV shown on the product page in FastSpring:
| Card number | Result |
|---|---|
| 4242 4242 4242 4242 | Success |
| 4000 0000 0000 0002 | Generic decline |
Verify webhooks are firing:
After completing a test purchase, confirm FastSpring delivered the event to FunnelFox:
- In FastSpring, go to Developer Tools > Webhooks > Configuration and open your FunnelFox webhook.
- Check the delivery log for a successful
order.completedevent (HTTP 200 response). - In FunnelFox, confirm the test subscriber appears in your subscriber list.
Troubleshooting
If something isn't working after setup, check the common issues below before contacting support.
Checkout doesn't load in FunnelFox preview
Make sure http://app.funnelfox.com/ is added to the authorized domains on your FastSpring checkout. See Step 3.
Webhook events aren't reaching FunnelFox
Confirm the Webhook URL in FastSpring matches exactly what FunnelFox provided, and that the HMAC secret is identical in both platforms. Check the delivery log in FastSpring (Developer Tools > Webhooks) for error details.
Subscriber doesn't appear in FunnelFox after a test purchase
Verify that all required events are enabled on the webhook endpoint (see Step 2). A missing subscription.activated event is a common cause.
"No domains allowed" error at checkout
Your funnel's domain isn't authorized. Add it to the checkout's allowed domains list in FastSpring (Checkouts > your checkout > domain badge).
For FunnelFox-side issues, refer to FunnelFox's FastSpring integration docs or contact FunnelFox support.