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

​
Features

​
Payment Methods

  • Cards - All major credit/debit cards
  • Digital Wallets - Apple Pay, Google Pay
  • PayPal - Via Stripe Connect (EU accounts only)
  • Bank Transfers - ACH, SEPA (selected regions)
  • Buy Now, Pay Later - Klarna, Afterpay (when enabled)

​
Subscription Management

  • Free and paid trials
  • Usage-based billing
  • Metered billing
  • Subscription pausing with deferred benefits
  • Upgrades/downgrades with proration
  • Multiple subscriptions per customer

​
Advanced Features

  • Stripe Tax - Automatic tax calculation globally
  • Stripe Billing - Invoice generation and management
  • Customer Portal - Self-service subscription management
  • Coupons & Discounts - Percentage and fixed amount
  • Payment Links - Direct checkout URLs

​
Configuration

​
Prerequisites

  • Active Stripe account (verified)
  • API keys from Stripe Dashboard
  • Products created in Stripe
  • Webhook endpoint access

​
Setup Steps

1

Get Your API Keys

  1. Log into Stripe Dashboard
  2. Navigate to Developers → API keys
  3. Copy your Publishable key (starts with pk_)
  4. Copy your Secret key (starts with sk_)
Never share your secret key. Use test keys (pk_test_, sk_test_) during development.
2

Configure in FunnelFox

  1. Go to Project Settings → Payment Providers
  2. Select Stripe
  3. Enter your Publishable key
  4. Enter your Secret key
  5. Choose environment (Test/Live)
  6. Click Save
3

Webhook Setup

FunnelFox automatically creates webhooks in your Stripe account. You’ll see a new endpoint at:
https://api.funnelfox.com/webhook/v1/stripe/[project-id]
Monitored events include:
  • checkout.session.completed
  • customer.subscription.updated
  • customer.subscription.deleted
  • invoice.payment_succeeded
  • invoice.payment_failed
4

Product Sync

Products automatically sync from Stripe:
  1. Create products in Stripe Dashboard
  2. Set prices (one-time or recurring)
  3. Products appear in FunnelFox within minutes
Only active products with prices sync. Archive unused products in Stripe to keep your list clean.

​
Stripe Tax Configuration

Enable automatic tax calculation:
1

Activate Stripe Tax

  1. In Stripe Dashboard, go to Products → Tax
  2. Enable Stripe Tax for your account
  3. Configure tax registrations for your regions
2

Enable in FunnelFox

  1. In checkout element settings
  2. Toggle “Enable automatic tax”
  3. Tax calculates based on customer location
Stripe Tax is a paid add-on (0.5% of transaction amount, min $0.25). It handles VAT, GST, and US sales tax automatically.

​
PayPal via Stripe

For EU-based Stripe accounts:
  1. Enable PayPal in Stripe Dashboard
  2. Complete PayPal onboarding
  3. PayPal appears as payment method in checkout
PayPal through Stripe is only available for European Stripe accounts. Use direct PayPal integration for other regions.

​
Subscription Features

​
Trial Periods

Configure in Stripe product: 
Trial period: 7 days
Trial type: Free or Paid ($1)
Auto-convert: Yes

​
Deferred Benefits

When pausing subscriptions:
  • Unused time carries forward
  • Credits applied on resume
  • Automatic proration
Example: 
Customer pauses on day 10 of 30-day cycle
20 days credit stored
On resume: Next charge in 20 days

​
Upgrade/Downgrade

Stripe handles proration automatically:
  • Immediate - Change takes effect now, prorated charge/credit
  • At period end - Change on next billing date
  • Custom - Define specific behavior

​
Coupons and Promotions

​
Creating Coupons

In Stripe Dashboard:
  1. Go to Products → Coupons
  2. Create coupon (percentage or amount)
  3. Set duration (once, forever, repeating)
  4. Optional: Set expiration date

​
Using in Funnels

Enable in checkout element: 
Allow coupons: Yes
Coupon field shows in checkout
Users enter code for discount
Use URL parameters to auto-apply coupons: funnel.com/offer?coupon=SAVE20

​
Testing

​
Test Cards

Common Stripe test cards:
Card NumberScenario
4242 4242 4242 4242Success
4000 0000 0000 0002Declined
4000 0000 0000 9995Insufficient funds
4000 0025 0000 3155Requires authentication
Use any future expiry date and any 3-digit CVV.

​
Test Mode

In preview mode:
  • Automatically uses test keys
  • No real charges
  • Full webhook flow
  • Test subscriptions created

​
Upsells with Stripe

After initial purchase:
  1. Use Purchase action on buttons
  2. Charges same payment method
  3. No re-entering card details
  4. Instant one-click upsells
Supported for:
  • One-time products
  • Subscription upgrades
  • Add-ons and extras

​
Multi-Currency

Stripe automatically handles currency:
  • Presentment currency (what customer sees)
  • Settlement currency (what you receive)
  • Automatic conversion at current rates
Configure accepted currencies in Stripe Dashboard.

​
Customer Portal

Enable self-service management:
  1. Configure portal in Stripe Dashboard
  2. Set allowed actions (cancel, pause, update payment)
  3. Generate portal links via API
  4. Embed in customer dashboard

​
Troubleshooting

​
Advanced Configuration

​
Multiple Stripe Accounts

Connect multiple accounts for:
  • Different business entities
  • Geographic separation
  • Currency optimization
Each needs separate configuration in FunnelFox.

​
Metadata

FunnelFox sends metadata with purchases: 
{
  "ff_funnel": "welcome-flow",
  "ff_session_id": "xyz789"
}
Use for reconciliation and analytics.

​
Invoice Customization

Configure in Stripe:
  • Invoice numbering format
  • Custom fields
  • Footer text
  • Tax details

​
Best Practices

​
Performance

  • Use Stripe’s Payment Element for fastest load
  • Enable Link (Stripe’s fast checkout)
  • Preload Stripe.js on previous page

​
Security

  • Always use HTTPS
  • Implement 3D Secure when required
  • Monitor fraud alerts
  • Use Stripe Radar rules

​
Optimization

  • A/B test payment methods shown
  • Use dynamic payment methods
  • Enable local payment methods
  • Optimize for mobile wallets

​
Next Steps