Stripe

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 type	Cards	Apple Pay	Google Pay	PayPal*
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 for API keys setup with European Stripe accounts only. PayPal is also not available when using Stripe via FunnelFox Billing. For other cases, use the direct PayPal integration.

Additional features

Stripe via FunnelFox Billing
Direct Stripe

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 FunnelFox Billing retries to reduce revenue loss from failed payments.

Stripe Link and Stripe Managed Payments are not available when using Stripe via FunnelFox Billing.

Setup

You need an active, verified Stripe account to connect Stripe. If you have one, the connection takes just a few clicks. FunnelFox offers two ways to connect Stripe. Setup is near-identical:

Stripe via FunnelFox Billing
Direct Stripe

Routes subscription processing through FunnelFox Billing’s Subscription engine instead of Stripe.

Lower cost: Avoids Stripe’s Billing fee, charged as 0.7% of Billing volume processed on Stripe.
No setup overhead: Connects with no extra configuration and no additional payments.
Products in FunnelFox: You create and manage products in FunnelFox instead of Stripe. See Products configuration.
Subscription engine only: Other FunnelFox Billing features, such as payments orchestration, are not available on this path.
You can enable this option only when creating a new connection. It cannot be changed for existing connections.

Install Stripe App for sandbox

Configure both environments using the same connection method: Stripe App or API keys.

Stripe via FunnelFox Billing
Direct Stripe

After connecting, FunnelFox Billing automatically creates your Billing workspace and emails a Reset your password link to the user who connected Stripe.

Once you connect Stripe via FunnelFox Billing, the other toggles on the Stripe integration page, such as Stripe Link, become unavailable.

Go to Integrations > Stripe > Stripe App in FunnelFox.
Click Open Stripe Marketplace.

Select your Stripe Sandbox account.

Stripe recommends using sandbox accounts for testing purposes instead of production accounts in test mode.

Keep the access rights as is and click Install app in sandbox.

Click Continue to app settings.

Copy your Publishable key.

Go back to the Stripe integration in FunnelFox and paste the key into the Test Publishable key field.

Reveal and copy your Restricted key in Stripe.

Go back to the Stripe integration in FunnelFox and paste the key into the Test Restricted API Key field.

Toggle on Process subscriptions via FunnelFox Billing.
Click Save & Connect.

To access your workspace, click the Reset your password link in the email, set a password, and sign in to the Support Tool. The link works once and expires in 3 days.To add teammates, an admin adds users from the Users page in the Support Tool. Detailed user management docs are coming soon.

Install Stripe App for production

Set up production using the same connection method you used for the sandbox environment.

Stripe via FunnelFox Billing
Direct Stripe

Click Open Stripe Marketplace.

Select your Stripe Production account.

Follow the same steps above to install the app and paste your keys into the Live keys fields in FunnelFox. Toggle on Process subscriptions via FunnelFox Billing before you save.

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 App installation.

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.

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.

Republish your funnels.
Verify that all products from the previous setup are available in your Checkout element.

Deprecated API keys setup flow

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:

Go to Developers > API keys in Stripe Dashboard.
Copy your Publishable key (starts with pk_live).

Go to Integrations > Stripe > API Keys tab in FunnelFox.
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:

Go back to Developers > API keys in Stripe.
Copy your Secret key (starts with sk_live).

Go back to your Stripe settings in FunnelFox.
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:

Go to back to your Stripe Dashboard.
Click your account picker at the top left and toggle on Test mode.
Go to Developers > API keys.
Copy your test Publishable key (starts with pk_test).

Go back to the Stripe settings in FunnelFox.
Paste the test publishable key into the Test mode Public Key field under Test mode.

Test Secret key:

Go back to Developers > API keys in Stripe.
Copy your test Secret key (starts with sk_test).

Go back to your Stripe settings in FunnelFox.
Paste the test secret key into the Test mode Secret Key field under Test mode.

Save changes.

Products configuration

Stripe via FunnelFox Billing
Direct Stripe

Products are not fetched from Stripe on this path, so create your products and prices in FunnelFox, then select them in your Checkout element. Learn about managing products.You can still manage subscriptions created on this path in your Stripe dashboard, or in your FunnelFox Billing dashboard (Support Tool).

Subscriptions on this path can’t yet be managed from the FunnelFox Subscriptions page.

If you have multiple Stripe accounts connected, use the Process via FunnelFox Billing toggle in your Checkout element to route a checkout through FunnelFox Billing.

Create one Stripe price per currency and select it per funnel locale to boost conversion. Visitors check out in the currency they expect. Learn about pricing localization.

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. Once your setup is complete, add a Wallet button to your funnels.

Apple Pay

Apple Pay for Stripe requires domain verification before you can use it. To enable Apple Pay:

Go to Settings > Payments > Payment method domains in your Stripe Dashboard.

Click + Add a new domain.
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.

Go to Settings > Domains in FunnelFox.
Select Stripe under Apple Pay domain verification.

When using Stripe via FunnelFox Billing, you still select Stripe here for Apple Pay domain verification.

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. Simply add the Wallet button to your funnels.

Stripe Link

Stripe Link lets returning Stripe customers pay faster using their saved payment details. They do not need to re-enter their card or billing information, which helps improve conversion rates. You don’t need to configure anything extra in the Checkout element. Enabling Stripe Link in your integration settings makes it available as a checkout payment method on all funnels automatically. Customers who have previously saved their payment details with Stripe Link, even if they are new to your funnel, can complete their payment in just a few clicks.

If a customer registers in your funnel using an Email input or OAuth button, Stripe customer and subscription are created with that email — not the one associated with their Stripe Link account.

Before enabling Stripe Link in FunnelFox, make sure the Stripe Link payment method is activated in your Stripe account. Note that Stripe Link is not available in India, Brazil, and Thailand.

To enable Stripe Link:

Go to Integrations > Stripe in FunnelFox.
Toggle on Stripe Link.
Click Save changes.
Republish your funnels.

If you disable Stripe Link, republish your funnels again to apply the changes live.

Multiple Stripe accounts

Connect multiple Stripe accounts to support:

Different business entities
Geographic separation
Currency optimization

Add another Stripe account

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

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:

Activate in Stripe Dashboard

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

Enable in FunnelFox

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

Prevent duplicate payments

Customers sometimes pay twice by double-clicking the purchase button or by starting a fresh checkout when they already subscribed. The Stripe integration offers three toggles that handle duplicates either before the payment is charged or after it completes. Before payment:

Prevent Duplicate Payments: Blocks a duplicate purchase that matches all of these: same customer, same product price, and same purchase date. Covers accidental double-clicks before Stripe confirms the first payment.
Limit One Subscription Per Email: Blocks a new purchase if the customer’s email already has an active, trialing, or paused subscription in your project. Plan upgrades, one-time payments, and customers whose previous subscription is canceled or expired are not affected.

After payment:

Refund Secondary Subscriptions: Automatically refunds a completed payment if the customer submits an email after checkout that already has an active, trialing, or paused subscription for the same product.

Limit One Subscription Per Email only works if the customer’s email is captured in the funnel before checkout. Refund Secondary Subscriptions applies when the email is submitted after checkout completes.

To enable these protections:

Go to Integrations > Stripe.
Toggle on Prevent Duplicate Payments, Limit One Subscription Per Email, or Refund Secondary Subscriptions.

Customers see these alerts when a duplicate is prevented:

Duplicate payment: “You have already purchased this item. You won’t be charged again.”
Duplicate subscription: “You already have an active subscription.”

Testing

Test your Stripe integration with simulated payments before going live.

Configure the test in your Checkout element’s Sandbox section.

Open your funnel in Preview mode.

Use these Stripe test cards with any future expiry date and any 3-digit CVV:

Card Number	Scenario
4242 4242 4242 4242	Success
4000 0000 0000 0002	Declined
4000 0000 0000 9995	Insufficient funds
4000 0025 0000 3155	Requires authentication

Learn more about Stripe test cards.

Metadata

FunnelFox sends the following customer metadata with purchases to Stripe:

{
  "fbc": "fb.1.1771647859500.test_click_id_123",
  "fbp": "fb.1.1768417255988.7307905378490303",
  "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

Can't find my production account with test mode when connecting Stripe

You will not see your production account in test mode when connecting a Stripe Sandbox account. Stripe recommends using sandbox accounts for testing purposes instead of production accounts in test mode.

Can I show customers multiple currencies with Stripe

Yes. Create one Stripe price per currency, then select it in each funnel locale. Learn about pricing localization.

I don't have products available for testing under the Sandbox section of my Checkout

Products used in funnel preview are fetched from your Stripe Sandbox account. Make sure the products are created there.

Checkout appears instead of one-click upsell with Stripe

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

Configure checkout element in your funnel
Set up Stripe Managed Payments

Getting started

Agentic solution

Integrations

Editor

Dashboard

Key features

Additional features

Setup

Install Stripe App for sandbox

Install Stripe App for production

Migrating from deprecated API keys setup

1. Live API keys

2. Test API keys

Products configuration

Digital wallets

Apple Pay

Google Pay

Stripe Link

Multiple Stripe accounts

Stripe Tax

Prevent duplicate payments

Testing

Metadata

Troubleshooting

Next steps

​Key features

​Additional features

​Setup

​Install Stripe App for sandbox

​Install Stripe App for production

​Migrating from deprecated API keys setup

​1. Live API keys

​2. Test API keys

​Products configuration

​Digital wallets

​Apple Pay

​Google Pay

​Stripe Link

​Multiple Stripe accounts

​Stripe Tax

​Prevent duplicate payments

​Testing

​Metadata

​Troubleshooting

​Next steps

Key features

Additional features

Setup

Install Stripe App for sandbox

Install Stripe App for production

Migrating from deprecated API keys setup

1. Live API keys

2. Test API keys

Products configuration

Digital wallets

Apple Pay

Google Pay

Stripe Link

Multiple Stripe accounts

Stripe Tax

Prevent duplicate payments

Testing

Metadata

Troubleshooting

Next steps