Skip to main content
Paddle is a payment integration for FunnelFox that provides global payment processing, advanced subscription management, and support for multiple payment methods.

​
Key features

The FunnelFox integration with Paddle supports multiple payment methods and transaction types:
Transaction typeCardsApple PayGoogle PayPayPal
Subscriptions
Subscriptions✅✅✅✅
Free & paid trials✅✅✅✅
Upsells
One-time products✅✅✅✅
Subscription upsells (2nd sub)❌❌❌❌
Subscription upsells (upgrade)✅✅✅✅
Offers
Intro offers✅✅✅✅
Discount codes✅✅✅✅
Learn more about configuring each transaction type in your funnel.

​
Additional features

  • Cancellation funnels: Full support for cancellation flows with options to offer discounted subscriptions, gifts, or pauses instead of losing customers completely.
  • Failed payment recovery: When payment fails for automatically-collected subscriptions, Paddle automatically retries the saved payment method.

​
Setup

To simplify Paddle account verification, use your FunnelFox project subdomain [your project].fnlfx.com as the domain in Paddle.
The following steps are for production setup using your verified live Paddle account. If you need to configure a sandbox environment for testing, the process is identical, but: Learn more about Sandbox in Paddle.

​
1. API key

  1. Go to Developer Tools > Authentication in Paddle.
  2. Click + New API key.
  1. Configure your API key with the following details, then click Save:
    • Name: FunnelFox
    • Expires at: Never expires
    • Permissions: Set the permissions as shown in the table below
PermissionReadWrite
Addresses✅
Adjustments✅
Businesses✅
Client-side tokens✅
Customer portal sessions
Customer authentication tokens✅
Customers✅
Discounts✅
Notification settings✅
Notifications✅
Notification simulations✅
Payment methods✅
Prices✅
Products✅
Reports✅
Subscriptions✅
Transactions✅
  1. Copy your API key.
You won’t be able to view the API key again in Paddle.
  1. Go to Integrations > Paddle in FunnelFox.
  2. Paste the API key into the API key field under the Production section.
Don’t close your Paddle integration settings in FunnelFox and proceed with the next section.

​
2. Client-side token

  1. Go to the Client-side tokens tab of Developer Tools > Authentication in Paddle.
  2. Click + New Client-side token.
  1. Name your token and click Save.
  1. Go back to Integrations > Paddle in FunnelFox.
  2. Paste the client-side token into the Client-side token field under the Production section.
  1. Click Save changes.
  1. Go to Settings > Domains in FunnelFox.
  2. Copy your project subdomain from the Hosted subdomain section (for example: https://demo-app.fnlfx.com/).
  1. Go to Checkout > Checkout settings in Paddle.
  2. Paste your subdomain into the Default payment link section.
  1. Click Save at the top right of the page.
Your Paddle integration is now active! Remember to republish your funnels to apply the changes.

​
Subscription configuration

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

​
Digital wallets

FunnelFox supports Apple Pay and Google Pay with Paddle for faster checkout. Apple Pay works without domain verification, but verifying your domain enables a smoother one-click experience. Google Pay works by default. Once set up, configure Apple Pay and Google Pay as payment methods for Paddle in your Checkout element.

​
Apple Pay

Apple Pay is shown in Paddle checkout only if the user has a card added to their wallet.
Paddle supports Apple Pay Express Checkout, which provides a seamless one-click payment experience. Customer email is resolved differently depending on whether an email is collected before the Checkout element:
  • If no email is collected before your Checkout element: Paddle creates the customer using the email from the Apple Pay wallet settings.
  • If an email is collected before Checkout element: That email takes priority over the wallet email.
Paddle doesn’t require domain verification to use Apple Pay. However, on unverified domains, Paddle opens a popup that launches the Apple Pay modal. Verify your domain for a smooth one-click experience without popups. To verify your domain:
  1. Go to Checkout > Website approval > Domain approval in your Paddle dashboard.
  2. Click + Add a new domain.
  1. Add your project domain from Settings > Domains in FunnelFox and click Save. If you have a custom domain, add it as well.
  1. Go to Settings > Domains in FunnelFox.
  2. Select Paddle under Apple Pay domain verification.
  1. Click Save.
One-click Apple Pay wallet button will become available in your funnels after domain verification completes.

​
Google Pay

Google Pay wallet buttons with Paddle checkout works by default and requires no configuration.

​
Testing

Test your Paddle 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 Paddle test cards with any future expiry date and 100 as CVV:
Card NumberResult
4242 4242 4242 4242Success
4000 0000 0000 0002Declined
4000 0027 6000 3184Successful initial transaction, subsequent declined transactions
Learn more about Paddle test cards.

​
Troubleshooting

This error often occurs when your setup is missing the default payment link:
  1. Go to Checkout > Checkout settings in Paddle.
  2. Check if you have the link set under the Default payment link.
  3. If not, go to Settings > Domains in FunnelFox.
  4. Copy your project subdomain from the Hosted subdomain section (for example: https://demo-app.fnlfx.com/).
  5. Paste your project subdomain under the Default payment link.
  6. Click Save at the top right, then republish your funnel.

​
Next steps