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

To connect Stripe, you need an active, verified Stripe account. Keep both FunnelFox and Stripe dashboards open during setup—you’ll switch between them several times.
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).
  3. Go to Settings > Integrations > Stripe in FunnelFox.
  4. 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.
Your Stripe integration is now active! Remember to republish your funnels to apply the changes.

​
Subscription configuration

FunnelFox automatically creates webhooks in your Stripe account and syncs your products after setup. Products created in Stripe become available in the Element tab of your Checkout element. Configure Stripe products in your funnels:

​
Multiple Stripe accounts

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

Add another Stripe account

  1. Go to Settings > Integrations > Stripe.
  2. Click Add 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:
  • 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 Settings > 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 metadata with purchases to Stripe: 
{
  "ff_funnel": "welcome-flow",
  "ff_session_id": "xyz789"
}

​
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.

​
Next steps

⌘I