Skip to main content
Stripe is FunnelFox’s most feature-rich payment integration, offering global payment processing with advanced subscription management, tax handling, and extensive payment method support.

​
Key features

FunnelFox supports the following payment methods and transaction types with Stripe:
Transaction typeCardsApple PayGoogle PayPayPal*
Subscriptions
Subscriptions✅✅✅✅
Free & paid trials✅✅✅✅
Upsells
One-time products✅✅✅✅
Subscription upsells (upgrade)✅✅✅✅
Offers
Intro offers✅✅✅✅
Promo codes (Coupons)✅✅✅✅
Learn more about configuring each transaction type in your funnel.
PayPal is available via Stripe Connect for European Stripe accounts only. For other regions, use the direct PayPal integration.

​
Additional features

  • Cancellation funnels: Full support for cancellation flows with options to offer discounted subscriptions, gifts, or pauses instead of losing customers completely.
  • Wallet button: One-click payment button for Apple Pay and Google Pay. Includes a fallback option when Apple Pay or Google Pay isn’t available.
  • Failed payment recovery: Automatic support for Stripe retries to reduce revenue loss from failed payments.

​
Setup

You need an active, verified Stripe account to connect Stripe. If you have one, the connection takes just a few clicks.

​
1. Connect Sandbox account

  1. Go to Integrations > Stripe in FunnelFox.
  2. Click Stripe |Connect Account and select Sandbox.
  1. Log in to your Stripe account.
  2. Optionally, set up two-step authentication for Stripe, if you haven’t done that previously.
  3. Select the account you want to connect to FunnelFox and click Connect. You can also create a new account if needed.
  1. If your Stripe account isn’t fully configured, you’ll be prompted to complete the Stripe account details.
Once complete, you’ll see a success notification.

​
2. Connect Production account

  1. Click Stripe |Connect Account and select Production.
  2. Follow the same steps above to complete the connection.
Your Stripe integration is now active! Remember to republish your funnels to apply the changes.

​
Migrating from deprecated API keys setup

If you previously connected Stripe using the deprecated API keys setup, we recommend migrating to the new Stripe Connect functionality.
Do not delete your deprecated connections in Integrations > Stripe. Keeping them ensures that webhooks for existing subscriptions continue to work. Redundant connections will be hidden from the UI after the transition period.
  1. Follow the setup flow above and connect both environments:
  • Sandbox account: Used for testing in funnel previews. Create products there to select them later in the Sandbox section of the Checkout element.
  • Production account: Used for live traffic on published funnels. Create products there to select them later in the Production section of the Checkout element.
  1. Republish your funnels.
  2. Verify that all products from the previous setup are available in your Checkout element.
FunnelFox doesn’t support Stripe Sandboxes. Use your live Stripe account with Test mode enabled instead. Learn about Stripe testing environments.

​
1. Live API keys

You need to add both publishable and secret keys from your live Stripe account.Publishable key:
  1. Go to Developers > API keys in Stripe Dashboard.
  2. Copy your Publishable key (starts with pk_live).
  1. Go to Integrations > Stripe in FunnelFox.
  2. Paste the publishable key into the Live Public Key field under Production.
Keep your FunnelFox Stripe settings page open throughout the setup process.
Secret key:
  1. Go back to Developers > API keys in Stripe.
  2. Copy your Secret key (starts with sk_live).
  1. Go back to your Stripe settings in FunnelFox.
  2. Paste the secret key into the Live Secret Key field under Production.

​
2. Test API keys

Next, add your test keys for testing payments before going live.Test Publishable key:
  1. Go to back to your Stripe Dashboard.
  2. Click your account picker at the top left and toggle on Test mode.
  3. Go to Developers > API keys.
  4. Copy your test Publishable key (starts with pk_test).
  1. Go back to the Stripe settings in FunnelFox.
  2. Paste the test publishable key into the Test mode Public Key field under Test mode.
Test Secret key:
  1. Go back to Developers > API keys in Stripe.
  2. Copy your test Secret key (starts with sk_test).
  1. Go back to your Stripe settings in FunnelFox.
  2. Paste the test secret key into the Test mode Secret Key field under Test mode.
  1. Save changes.

​
Products configuration

FunnelFox automatically creates webhooks in your Stripe account and syncs your products after setup. Products created in your Stripe Sandbox account are available for funnel preview testing under the Sandbox section of the Element tab in your Checkout element. Similarly, products created in the production environment are available under the Production section. Configure Stripe products in your funnels:

​
Digital wallets

FunnelFox supports Apple Pay and Google Pay wallet buttons with Stripe for faster checkout. Apple Pay requires domain verification, while Google Pay works by default.

​
Apple Pay

Apple Pay for Stripe requires domain verification before you can use it. To enable Apple Pay:
  1. Go to Settings > Payments > Payment method domains in your Stripe Dashboard.
  1. Click + Add a new domain.
  2. Add your project domain from Settings > Domains in FunnelFox and click Save. If you have a custom domain, add it as well.
To use Apple Pay in funnel preview mode, add http://app.funnelfox.com/ as a domain.
  1. Go to Settings > Domains in FunnelFox.
  2. Select Stripe under Apple Pay domain verification.
  1. Click Save.
Apple Pay wallet button will become available in your funnels after domain verification completes.

​
Google Pay

Google Pay wallet buttons with Stripe works by default and requires no configuration.

​
Multiple Stripe accounts

Connect multiple Stripe accounts to support:
  • Different business entities
  • Geographic separation
  • Currency optimization
1

Add another Stripe account

  1. Go to Integrations > Stripe.
  2. Click Add Stripe account.
  3. Follow the setup steps for the new account.
2

Select account in your funnel

After adding accounts, you can switch between them in your funnel (separately for Sandbox and Production environments):
  • In the Element tab of your Checkout
  • In the Element tab of your Wallet Button

​
Stripe Tax

Stripe Tax automatically calculates taxes for you. Learn more about Stripe Tax and its pricing in the Stripe documentation. To enable Stripe Tax:
1

Activate in Stripe Dashboard

  1. Go to Stripe Dashboard.
  2. Set up Stripe Tax. Learn about setting up Stripe Tax in Stripe Dashboard.
2

Enable in FunnelFox

  1. Go to the Checkout element in your funnels.
  2. Set Stripe Tax to Yes in the Actions section of the Element tab.

​
Prevent duplicate payments

Users sometimes double-click purchase buttons accidentally. By default, if this happens before Stripe confirms the payment to FunnelFox, it creates a duplicate charge. To enable duplicate payment protection:
  1. Go to Integrations > Stripe.
  2. Set Prevent Duplicate Payments to Yes.
When enabled, FunnelFox blocks duplicate purchases that match all these criteria:
  • Same customer
  • Same product price
  • Same purchase date
Customers see this alert when a duplicate purchase is prevented: “You have already purchased this item. You won’t be charged again.”

​
Testing

Test your Stripe integration with simulated payments before going live.
  1. Configure the test in your Checkout element’s Sandbox section.
  1. Open your funnel in Preview mode.
  1. Use these Stripe test cards with any future expiry date and any 3-digit CVV:
Card NumberScenario
4242 4242 4242 4242Success
4000 0000 0000 0002Declined
4000 0000 0000 9995Insufficient funds
4000 0025 0000 3155Requires authentication
Learn more about Stripe test cards.

​
Metadata

FunnelFox sends the following customer metadata with purchases to Stripe: 
{
  "custom_user_id": "y62CGLhosCNtFt0CEbNoM7xRuS62",
  "ff_funnel": "welcome-flow",
  "ff_session_id": "xyz789",
  "utm_source": "google",
  "utm_medium": "cpc",
  "utm_campaign": "summer-sale",
  "utm_term": "subscription",
  "utm_content": "ad-variant-a"
}

​
Troubleshooting

  • Ensure you’re using Test mode (not Sandbox) in Stripe
  • Verify API keys are from the correct environment
Yes. To show relevant currencies for each user locale, follow our pricing localization guide.
Products used in funnel preview are fetched from your Stripe Sandbox account. Make sure the products are created there.
Stripe allows you to upsell both one-time products and subscription upgrades. By default, customers don’t need to provide their payment details again and will be charged with just one click.If the upsell payment is declined, for example due to insufficient funds after the initial purchase, the checkout pop-up is shown again so the customer can retry.

​
Next steps