Stripe

​

Key features

​

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.
• Stripe Link: Faster checkout for returning Stripe customers using their saved payment details.
• Failed payment recovery: Automatic support for Stripe retries to reduce revenue loss from failed payments.
• Stripe Managed Payments: Use the merchant of record (MoR) solution from Stripe in FunnelFox to offload tax compliance, fraud prevention, disputes, and post-purchase support to Stripe.

​

Setup

• Test mode: Required. Runs in funnel preview.
• Live mode: Optional at first. Takes real payments in published funnels.

​

1. Install Stripe App

1. Go to Integrations > Stripe in FunnelFox and click Install in Stripe, or select New Stripe account first if you see accounts from other projects.

2. Select your Stripe account.

3. Keep the access rights as is and click Continue to install the app.

4. Click Continue to app settings. You can view your test or live API keys depending on whether you’re logged in to your Stripe account in Test mode or Live mode.

5. Copy the Publishable key.

6. Paste it into the Test Publishable Key field in FunnelFox.

7. Copy the Restricted key in Stripe.

8. Paste it into the Test Restricted Key field in FunnelFox.

9. Click Save.

​

2. Add live mode keys

1. In Stripe, switch to live mode.

2. Go to Apps > Overview > FunnelFox.

3. Click View API keys.

4. Copy the Publishable key.
5. Select the account in Integrations > Stripe and click Add live keys.

6. Paste it into the Live Publishable Key field.
7. Copy the Restricted key in Stripe.
8. Paste it into the Live Restricted Key field.
9. Click Save.

​

Migrating from deprecated API keys setup

1. Follow the setup above for the same Stripe account. Add app keys for every mode the old connection uses: test, live, or both.
2. Click Save. FunnelFox replaces the old connection and keeps its settings.
3. Republish your funnels.

​

Products configuration

• Free trial
• Paid trial
• Offers (coupons & promo codes)
• Upsell

​

Digital wallets

​

Apple Pay

• Once you integrated with Stripe, FunnelFox adds your funnel domains to Payment method domains in Stripe and asks Stripe to verify them.
• Live mode gets your project domain and custom domain. Test mode gets the preview domain app.funnelfox.com.
• FunnelFox never removes domains from Stripe.

Add domains manually

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

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

4. Go to Settings > Domains in FunnelFox.
5. Select Stripe under Apple Pay domain verification.
   
6. Click Save.

​

Google Pay

​

Stripe Link

1. Go to Integrations > Stripe in FunnelFox and select the account.
2. Toggle on Link in Payment methods. If Link is off in Stripe, click Turn on in Stripe first.
3. Click Save.
4. Republish your funnels.

​

Multiple Stripe accounts

• Different business entities
• Geographic separation
• Currency optimization

1

Add another Stripe account

1. Go to Integrations > Stripe.
2. 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 Properties > Parameters of your Checkout

• In Properties > Parameters of your Wallet Button

​

Stripe Tax

​

Prevent duplicate payments

• Prevent Duplicate Payments: Blocks a second charge for the same price when a customer pays twice within 24 hours, for example after a double click or a page refresh.
• 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.

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

1. Go to Integrations > Stripe, select the account, and go to Advanced settings.
2. Toggle on Prevent Duplicate Payments, Limit One Subscription per Email, or Refund Secondary Subscriptions.
3. Click Save.

​

Unique statement descriptor

FF-FOX* XQ5XPCY09M

1. Go to Integrations > Stripe, select the account, and go to Advanced settings.
2. Toggle on Unique Statement Descriptor under Chargebacks. A preview shows what customers see.
3. Click Save.

​

Checkout form

FunnelFox Form

FunnelFox’s own payment form:

Stripe Form

Stripe’s payment form embedded in the funnel screen:

1. Request Checkout Form access for your account from Stripe support.
2. Go to Integrations > Stripe in FunnelFox, select the account, toggle on Checkout Form under Checkout, and click Save.

3. Set Checkout UI to Stripe Form in your Checkout element.

​

Region-based payment methods

​

Pix

1. Go to Settings > Payments > Payment methods in your Stripe Dashboard and enable Pix for both one-time and recurring payments.

2. Go to Integrations > Stripe in FunnelFox and select the account.
3. Toggle on Pix in Payment methods.

4. Click Save.
5. Toggle on Pix in Properties > Parameters of your Checkout element.

6. Customize Pix in Properties > Parameters of your Checkout element:
   • Button text: Text on the payment button. Defaults to Pay with Pix.
   • Name field: Label and placeholder for the full name field.
   • CPF/CNPJ field: Label, placeholder, and error message for the tax ID field. FunnelFox validates the number in the browser.
   • Customize email field: Label, placeholder, and error message for the email field. It appears only if the funnel has not collected an email yet.
   • Absorb the IOF tax: Off by default, so the 3.5% Brazilian tax on international payments is added to the customer’s charge. Turn it on to pay the tax from your settlement instead.
   • QR code lifetime: How long the QR code stays valid, in seconds. Defaults to 1800 (30 minutes).

1. They fill in their email (only if the funnel has not collected one), full name, and CPF or CNPJ.
2. Accept the disclosure below the fields. It states that this is an international purchase, how the 3.5% IOF tax is applied, and that Ebanx’s terms and conditions apply.
3. Submit the form to open Stripe’s QR code modal, then pay in their banking app. On a subscription, paying the code also authorizes the mandate for renewals.

​

Testing

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

2. Open your funnel in Preview mode.

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

​

Metadata

{
  "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

​

Next steps

• Configure checkout element in your funnel
• Set up Stripe Managed Payments