Skip to main content
Our team handles most of the integration process, including connecting FunnelFox Billing to your FunnelFox projects, configuring workflows, and more. You only need to complete a few steps on your side. Start by setting up the Sandbox environment first, then move to Production.
Once integrated, you’ll be able to create products and select FunnelFox Billing as the payment provider for your Checkout element in FunnelFox.

​
Sandbox

Follow these steps to set up FunnelFox Billing in your Sandbox environment.

​
1. Get Primer invitation

Your Solution Manager will send you an email invitation to Primer.io. This is a dedicated Primer Sandbox account we create for your FunnelFox Billing setup.

​
2. Connect your Stripe to Primer

You can optionally connect a different payment provider instead of Stripe using similar setup steps.
  1. Go to the Integrations page in the Primer account we created for you.
  2. Click + New integration at the top right.
  1. Click Connect under Stripe.
  1. Click Connect with Stripe.
  1. Select your sandbox account and click Connect.
After connecting, you’ll see the Webhooks page in Stripe where you can proceed to the next step.

​
3. Set up Primer webhook

  1. Click + Add destination on the Developers > Webhooks page in Stripe.
  1. Select Your account under Events from.
  1. Ensure the API version is 2020-03-02 or later.
If you’re using an older Stripe API version, learn about Stripe API upgrades.
  1. Select the following events and click Continue:
  • payment_intent.succeeded
  • payment_intent.payment_failed
  • payment_intent.processing
  • payment_intent.canceled
  • payment_intent.amount_capturable_updated
  • payment_intent.partially_funded
  • charge.dispute.created
  • charge.dispute.closed
  1. Select Webhook endpoint under Destination type and click Continue.
  1. Go back to the Stripe integration in Primer and copy the endpoint URL under Set up webhook.
  1. Go back to webhook configuration in Stripe and paste the endpoint URL into the Endpoint URL field.
  1. Click Create destination.
Click Finish in the Stripe integration in Primer. You can skip the remaining steps about enabling raw card data handling—that section of the Primer guide is outdated.

​
4. Set up FunnelFox Billing webhook

Repeat the steps above to set up another webhook using a different endpoint URL and events.
  1. Click + Add destination on the Developers > Webhooks page in Stripe.
  2. Select Your account under Events from.
  3. Select the following events and click Continue:
  • charge.refunded
  • charge.succeeded
  1. Select Webhook endpoint under Destination type and click Continue.
  2. Request your Sandbox Organization ID (org id) from your Solution manager.
  3. Replace {ORG_ID} in https://billing.funnelfox.com/{ORG_ID}/v1/stripe/webhook?region=default with your Sandbox Organization ID.
Your complete endpoint URL will look like https://billing.funnelfox.com/sndbx_123a4b5678c9d0/v1/stripe/webhook?region=default.
  1. Go back to the Stripe webhook configuration and paste the endpoint URL into Endpoint URL.
  1. Click Create destination.

​
5. Configure field mapping

Map required fields in Primer to ensure FunnelFox Billing receives the necessary customer data from Stripe.
  1. Go to Integrations in Primer and open the Stripe integration you just set up.
  2. Click Manage at the top right and select Advanced mapping.
  1. Click Add field and map the following fields under the Authorization tab:
  • ff_org_id: metadata[ff_org_id]
  • ff_country_code: payment_method_data[billing_details][address][country]
  • postal_code: payment_method_data[billing_details][address][postal_code]
  • email: payment_method_data[billing_details][email]
  1. Click Save.

​
6. Get Support Tool access

Your Solution manager will reach out to provide access to the dedicated FunnelFox Billing dashboard with the Support Tool. Use the Support Tool to manage subscriptions, process refunds, and view payments, webhooks, and more.
Your FunnelFox Billing Sandbox setup is complete. Make test payments to verify that everything is configured correctly.

​
Production

After testing in Sandbox, set up FunnelFox Billing for your live environment to start accepting real payments. Repeat the setup process from the Sandbox section above using the Primer Production account we create for you. After completing the setup, proceed with configuring Apple Pay, Google Pay, and PayPal.
Before you begin, ensure you have:

​
1. Set up Apple Pay

  1. Go to the Integrations page in the Primer account we created for you.
  2. Click + New integration at the top right.
  1. Click Connect under Apple Pay.
  1. Click + Add new domain and add three domains:
  • cdn.fnlfx.com.
  • Your project domain from Settings > Domains in FunnelFox (for example, demo-app.fnlfx.com).
  • Your custom domain (if any).
  1. Go to Settings > Domains in FunnelFox.
  2. Select FunnelFox Billing under Apple Pay domain verification.
  1. Save changes.

​
2. Set up Google Pay

  1. Click + New integration on the Integrations page in Primer.
  2. Click Connect under Google Pay.
  1. Enter your Google Pay merchant details and click Connect:
  • Merchant ID
  • Merchant Name
  1. Go to the Business profile page in your Google Pay & Wallet Console and verify your business profile is complete.
  1. Go to Google Pay API > Web integration.
  1. Complete the form and click Submit for approval:
  • Website URL: Enter the domain you’d like to integrate with. If you have multiple domains, enter the main one.
  • Integration type: Gateway.
  • Screenshots of your buyflow: Upload screenshots of your buyflow with the Google Pay API (1MB max).

​
3. Set up PayPal

  1. Click + New integration on the Integrations page in Primer.
  2. Click Connect under PayPal.
  1. Go to Apps & Credentials in your PayPal Developer dashboard and open your app under REST API apps.
  1. Copy your PayPal API credentials and paste them in Primer:
  • Account: Email address associated with the PayPal app under the Account info.
  • Client ID: Public API identifier for the PayPal app under the API credentials.
  • Secret: API secret key for the PayPal app under the API credentials.
  • Landing Page: Billing page.
  1. Click Connect.
  2. Go back to your app page under Apps & Credentials in the PayPal Developer dashboard and ensure Save payment methods is enabled.
This allows the Vault API to save customer payment methods for faster checkout.
  1. Contact PayPal Support and request to enable Reference transactions.
Reference transactions allow you to charge customers using their saved payment method.
Your FunnelFox Billing Production setup is complete. Make test payments to verify that everything is configured correctly.