Skip to main content
FastSpring is an all-in-one merchant of record and payment integration for FunnelFox that provides global payment processing and subscription management.

​
Key features

The FunnelFox integration with FastSpring supports the following payment methods and transaction types:
Transaction typeCardsApple PayGoogle PayPayPal
Subscriptions
Subscriptions✅✅✅✅
Free & paid trials✅✅✅✅
Upsells
One-time products✅✅✅✅
Subscription upsells (2nd sub)✅✅✅✅
Offers
Intro offers✅✅✅✅
Learn more about configuring each transaction type in your funnel.

​
Setup

You need an active FastSpring account to integrate with FunnelFox. Keep both FunnelFox and FastSpring dashboards open during setup—you’ll switch between them several times.

​
1. API keys

  1. Go to Developer Tools > APIs > API Credentials in FastSpring.
  2. Click Create or Reset Credentials to get your API Username and Password.
  1. Copy your Username.
  1. Go to Integrations > FastSpring in FunnelFox.
  2. Paste your Username into the API Username fields under both Production and Sandbox sections.
  1. Go back to your credentials in FastSpring and copy your Password.
  1. Paste your Password into the API Password fields under both Production and Sandbox sections in FunnelFox.
Don’t close your FastSpring integration settings in FunnelFox and proceed with the next section.

​
2. Webhook keys

  1. Go to Developer Tools > Webhooks > Configuration in FastSpring.
  2. Click Add Webhook.
  1. Configure the webhook and click Add:
  • Title: Name your webhook.
  • Get webhooks from: Live and Test orders.
  • Webhook expansion: Keep disabled.
  1. Click Add URL Endpoint on the webhook you just created.
  1. Go back to your integration settings in FunnelFox and copy your Webhook URL.
  1. Proceed with webhook configuration in FastSpring and click Add:
  • URL: Paste your webhook URL from FunnelFox.
  • HMAC SHA256 Secret: Generate your own webhook secret and paste here. Keep your secret saved — you’ll also need it later in FunnelFox.
You only need one secret. The same secret is used for both sandbox and production setups.
  • Select the following Events:
  • order.completed
  • subscription.activated
  • subscription.canceled
  • subscription.deactivated
  • subscription.updated
  • subscription.uncanceled
  • subscription.charge.completed
  • subscription.charge.failed
  • subscription.paused
  • subscription.resumed
  • return.created
  • chargeback.created
  1. Go back to FunnelFox and paste your webhook secret into the Webhook HMAC Secret fields under both Production and Sandbox sections.

​
3. Domains

  1. Go to Checkouts > Popup Checkouts in FastSpring.
Based on the checkout type needed, you can proceed with Embedded checkout instead. Learn about Checkout types.
  1. Click Create Popup Checkout.
  1. Enter a unique ID for your new checkout without spaces or special characters. This ID becomes part of your checkout URL.
  2. Click Create.
  1. Click No Website Domains Allowed badge on the checkout you just created.
  1. Paste the following domains and click Save:
  • Your project domain from Settings > Domains in FunnelFox.
  • http://app.funnelfox.com/ to use your checkout in funnel preview mode.
  • If you have a custom domain, add it as well.
  1. Click Place on your website on the checkout you just created.
  1. Copy your account subdomain from: data-storefront="YOUR_ACCOUNT_SUBDOMAIN.test.onfastspring.com/popup-demo".
  1. Go back to FunnelFox and paste your checkout ID into the Account subdomain and Account subdomain (sandbox) fields.
  1. Click Save changes.
Your FastSpring integration is now active! Remember to republish your funnels to apply the changes.

​
Checkout types

FunnelFox supports two FastSpring checkout types:
  • Popup: A modal checkout that opens over your funnel.
  • Embedded: A checkout embedded directly into your page layout.
Configure each checkout type before using it in the Editor:
  1. Go to Checkouts > Popup Checkouts / Embedded Checkouts in FastSpring.
  2. Create new checkout of the type needed.
  3. Click No Website Domains Allowed badge on the checkout you just created.
  1. Paste the following domains and click Save:
  • Your project domain from Settings > Domains in FunnelFox.
  • http://app.funnelfox.com/ to use your checkout in funnel preview mode.
  • If you have a custom domain, add it as well.

​
Subscription configuration

Due to FastSpring limitation, you need to collect customer email before the paywall screen with Checkout element. Add an Email input before configuring products.
After setup, FunnelFox automatically creates webhooks in your FastSpring account and syncs your products. To make each FastSpring product available in the Checkout element, you need:
  • Checkout ID: Go to Checkouts > Popup Checkouts / Embedded Checkouts in FastSpring and copy the ID of the checkout to configure (e.g. Popup / YOUR_CHECKOUT_ID).
  • Product path: Go to Catalog > Subscription Plans in FastSpring and copy the path of product to configure.
Use the Checkout ID and Product path values to proceed with product configuration in your Checkout element.

​
Testing

Test your FastSpring integration with simulated payments before going live.
  1. Configure the test in your Checkout element’s Sandbox section.
  2. Open your funnel in Preview mode.
  3. Use these FastSpring test cards with any future expiry date and the CVV from the product page in FastSpring:
Card NumberResult
4242 4242 4242 4242Success
4000 0000 0000 0002Generic decline

​
Next steps