FunnelFox Billing 01 / 14
Onboarding Guide

FunnelFox
Billing

Your complete web payments infrastructure — orchestration, recovery, tokenization & subscriptions.

In this guide: How FunnelFox Billing works, what's active on your account, and your activation checklist.
Payment Orchestration Revenue Recovery Network Tokenization Adaptive 3DS Dispute Prevention Subscription Management

What You've Unlocked

Four layers of billing infrastructure — all connected, all working for you.

Payment Orchestration

Smart routing across 30+ PSPs. Geo and load-balance rules to maximize acceptance.

Revenue Recovery

Smart retries with grace periods, partial charges, and fallbacks to a backup PSP.

Tokenization

Opt-in network tokens (Visa/MC) that follow cards through expiry and reissues.

Dispute Prevention

Auto-refund before disputes become chargebacks. Protects your PSP account.

The Problems We Solve

Traditional payment processors weren't built for modern web funnels.

01

Single PSP = risking it all

Continue billing users and save subscriptions even if your PSP gets banned. Route payments to another PSP instantly.

02

Failed payments = lost revenue

Recover failed payments using fallbacks and retry logic. Most declines are soft — recoverable with the right strategy.

03

Chargebacks threaten your merchant account

Catch alerts before they become disputes. Auto-refund intercepts disputes at the source.

04

Fragmented billing stack

Control subscriptions and users in one place, regardless of PSP. No stitching together disconnected tools.

How It Works With FunnelFox

1

Your Funnel

FunnelFox page captures lead

›
2

Billing Checkout

Secure hosted checkout form

›
3

Orchestration

Routes to best PSP

›
4

Retries + Fallbacks

Smart recovery logic

›
5

Subscription Mgmt

Full lifecycle control

No-code setup

FunnelFox Funnels connect to Billing automatically. Configured by your Solutions Manager.

30+ PSPs supported

Stripe, Adyen, PayPal, Checkout.com and more — switch or add at any time.

Real-time webhooks

Every payment and subscription event triggers a webhook for downstream systems.

Payment Orchestration

Automatic routing to the right PSP — maximizing acceptance without manual intervention.

Geographic Routing

Route by customer country to the best-performing PSP for that region.
E.g. US → Stripe US · EU → Stripe EU · LATAM → Checkout.com

Lowers cross-border fees and improves acceptance rates.

Load Balancing

Split traffic across PSPs (e.g. 50/50).
Test different PSPs and benchmark performance.
Increase or shift ratios on the fly as data comes in.

Payment Cascading

When a primary PSP fails, FunnelFox instantly routes to a backup — before the retry schedule even starts.

Stripe
Declined
Checkout.com
Declined
Adyen
Succeeded ✓

Configured by your Solutions Manager. No code changes required.

Revenue Recovery: Smart Retries

Most failed payments are soft declines — recoverable with the right retry strategy.

Monthly Smart Retry Schedule

DayActionAmount
Day 0Grace periodSubscriber notified, card on file kept
Day 2Full charge retry100%
Day 7Full charge100%
Day 12Partial charge70% of subscription price70%
Day 20Final partial charge50% — last recovery attempt50%

Payment cascading also applies during retry — if primary PSP is down, backup is tried first.

Save up to

20%

of subscribers from churning

Short Retries

Faster cadence with fewer attempts. Ideal for higher-volume, shorter billing cycles.

Custom retry logic

Request a custom schedule — test different retry logic, amounts, and timing to optimize recovery for your subscriber base.

Tokenization

Keep card data secure and boost long-term acceptance rates — automatically.

DEFAULT — ACTIVE NOW
🔒
Platform Tokenization
PSP-generated tokens
  • ✓Card data never stored on FunnelFox servers
  • ✓PSP (e.g. Stripe) creates and holds the token
  • ✓Protects your business from PCI scope
  • ✓Works on all 30+ connected PSPs
  • ✓Enabled automatically — no action needed
OPT-IN — RECOMMENDED
🔗
Network Tokenization
Visa / Mastercard tokens
  • ✓Token issued by Visa / Mastercard directly
  • ✓Token follows the card through reissues & expiry
  • ✓No more lost subscriptions from expired cards
  • ✓Reduces fraud — cryptogram per transaction
  • ✓Higher acceptance rates from card networks
  • ✓Enable via Solutions Manager request

Adaptive 3DS

Maximize authorization rates — 3DS friction added only when the payment actually needs it.

What it does

Payments always attempt without 3DS first — keeping checkout fast. If a processor declines due to missing authentication, Primer automatically runs 3DS and retries the payment immediately.

When is it triggered?

  • Declined: do_not_honor
  • Declined: authentication_required
  • Declined: refer to card issuer
  • Failed: application error
OPT-IN — RECOMMENDED

Payment Flow Example

Without Adaptive 3DS, this payment would have been lost.

Payment request
Checkout → Stripe (no 3DS)
Pending
Authorization declined
Stripe → do_not_honor
Declined
3DS triggered
Adaptive 3DS activated automatically
Triggered
3DS authentication
Primer → 3DS 2.2.0
Passed ✓
Authorization confirmed
Primer → Stripe (with 3DS)
Authorized
Capture confirmed
Settled
Success ✓

Dispute Prevention

Auto-refund before disputes become chargebacks — protecting your PSP account.

Without Dispute Prevention

  • Customer disputes a charge
  • Card network opens a chargeback
  • PSP debits your account + chargeback fee
  • High ratio → PSP flags your account
  • Risk of account restriction or suspension

With Dispute Prevention

  • ✓Dispute alert received from network
  • ✓FunnelFox auto-refunds immediately
  • ✓No chargeback is filed
  • ✓PSP account stays clean and healthy
  • ✓Dispute ratio remains well below threshold
Covered networks: Visa RDR · Mastercard CDRN · Ethoca · PayPal

Subscription Management

Give your support team full control — without touching a developer.

↩

Unsubscribe

Cancel immediately. Webhook fires.

⏸

Pause / Resume

Freeze billing. Resume on demand.

💸

Refund

Full, partial, or soft refunds by request.

%

Discount

Retention offers. Time-limited or ongoing.

→

Defer

Push next charge date forward.

Subscription Lifecycle

INTRO
Trial or intro period active
RECURRING
Active paying subscriber
GRACE
Payment failed, day 0 grace
RETRY
Active retry schedule running
PAUSED
Billing frozen by support
AUTORENEW_OFF
Subscriber opted out of renewal
EXPIRED
All retries exhausted

Webhook events fire on every status change.

At a Glance

Everything in FunnelFox Billing

Payment
Orchestration
Geo rules & auto-failover

Smart routing across 30+ PSPs — geo rules, load balancing, and instant failover to backup processors.

Smart
Retries
Grace periods & fallbacks

Failed payments retried with smart logic — grace periods, partial charges, and automatic PSP fallback.

Network
Tokens
Visa & Mastercard

Tokens that follow cards through expiry and reissues — zero customer friction.

New
Delayed
Capture
Authorize now, settle later

Hold funds for up to 7 days before settling. Perfect for pre-orders and reservations.

Dispute
Prevention
Auto-refund before chargebacks

Intercept disputes before they escalate. Covers Visa RDR, Mastercard CDRN, Ethoca & PayPal.

Adaptive
3DS
Friction only when needed

Payments attempt without 3DS first. If declined, Primer auto-triggers 3DS and retries — maximizing auth rates.

Best
Checkout UI

Optimized payment forms with smart defaults — fewer fields, faster load, higher conversion.

Support
Tool
No code needed

Your support team manages refunds, subscriptions, and disputes from one dashboard — no developer needed.

Your Activation Checklist

Click any row to mark it live.

→
Connect Billing to FunnelFox Project
Link your FunnelFox funnels to the Billing integration.
FunnelFox
→
Confirm custom PSP routing rules
Set up geo / load-balance rules. Contact your Solutions Manager.
FunnelFox
→
Review Smart Retry schedule
Monthly or short cadence. Custom logic available on request.
FunnelFox
→
Enable Network Tokenization (opt-in)
Recommended — reduces lost subscriptions from expired cards.
Optional
→
Enable Adaptive 3DS (opt-in)
Increases authorization rates — 3DS triggered only when needed.
Optional
→
Set up Dispute Prevention
Provide BIN/CAID, billing descriptor, Stripe key, and webhook.
→
Train support team on Support Tool
Pause, defer, discount, and unsubscribe from a single interface.
Your team
Onboarding Timeline

FunnelFox Billing — Funnels Integration

⚠ Prerequisites before we begin: Stripe account (Sandbox + Production) · Stripe Public Key
Key Activity
PHASE 1 — FunnelFox Setup
PHASE 2 — Customer backend Integration
PHASE 3 — Post-Launch
CUSTOMER
EFFORT
CUSTOMER
RESOURCE
🦊 FunnelFox Setup · 1–2 business days
🦊Primer account creation
—
FunnelFox
🦊Configure FunnelFox ↔FF Billing
—
FunnelFox
👤Connect PSP (i.e. Stripe) + Stripe webhook
30 min
Payment Manager
🦊Stripe field mapping
—
FunnelFox
🦊Primer workflows/routing setup
—
FunnelFox
🤝Network Tokenization (optional)
optional
30 min
Payment Manager
🤝Adaptive 3DS configuration (optional)
optional
30 min
Payment Manager
🦊Support tool access & test payment
—
FunnelFox
🦊Sending docs to customer
—
FunnelFox
👤 Customer Integration · 3–7 business days
👤Integrate FF Billing into backend
3–5 days
Dev Team
👤Integrate PayPal with Primer (optional)
optional
3–4 days
Payment Manager
👤Integrate Google Pay with Primer (optional)
optional
3–4 days
Payment Manager
🦊 Post-Launch · Ongoing
🦊Monitor acceptance rate & decline reasons
—
FunnelFox SM
🦊Transfer to Customer Success Manager
—
FunnelFox CSM
🦊On-demand support (PSP integrations, workflows)
—
FunnelFox SM
Day 1 Day 2 Day 3 Day 5 Day 7 Day 7+
* Timeline may vary. Phase 2 duration depends on customer dev team. PayPal & Google Pay depend on third-party approval.
🦊FunnelFox
👤Customer
🤝Joint
Onboarding Timeline

FunnelFox Chargeback Prevention

⚠ Prerequisites before we begin: Active Stripe account (Sandbox + Production) · FF Billing org_id · BIN/CAID · Billing descriptor(s)
Key Activity
PHASE 1 — Initial Setup
PHASE 2 — Network Approvals
CUSTOMER
EFFORT
CUSTOMER
RESOURCE
👤 Initial Setup · 1–3 business days
👤Customer sends BIN / CAID + Descriptor(s)
1–2 days
Payment Manager
👤Customer creates Stripe Restricted Key & sends to FF
30 min
Payment Manager
👤Customer sets up FF Billing webhook in Stripe
15 min
Payment Manager
🦊FunnelFox registers account in networks
—
FunnelFox
🦊FunnelFox runs test payment in Sandbox
—
FunnelFox
🦊FunnelFox creates Slack channel for alerts
—
FunnelFox
⏳ Network Approvals · 3–10 business days
⏳Waiting for Mastercard CDRN approval
~3 days
—
Mastercard
⏳Waiting for Visa RDR approval
up to 10 days
—
Visa
🦊Go Live — real dispute alerts begin
—
FunnelFox
Day 1 Day 2 Day 3 Day 6 Day 10 Day 13
* Timeline may vary.
🦊FunnelFox
👤Customer
Go Live
Awaiting approval