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 (upgrade)❌❌❌❌
Offers
Intro offers✅✅✅✅
Promo codes (Coupons)❌❌❌❌
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 Settings > 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 Settings > 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:

​
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

⌘I