Payment Retries with FlexPay 

This feature is a Private Beta Release. Contact support  to enable FlexPay for your Test and Live site.

Chargebee's dunning suite offers a suite of options, encompassing payment retries, automated email notifications, Pay Now links, and final automated actions, all designed to streamline the recovery of failed payments and automate key processes. Expanding on these capabilities, Chargebee now allows integration of FlexPay into Chargebee's dunning framework, enhancing the efficiency of payment recovery efforts.

FlexPay stands as a leading payment retry management platform, dedicated to addressing the issue of failed payments and the ensuing customer churn experienced by subscription-based companies. In collaboration with Chargebee, FlexPay's retry functionalities seamlessly integrate with Chargebee's dunning system.

Within Chargebee's dunning settings, users can now configure distinct retry periods for Chargebee's internal retries and designate a period for FlexPay to intervene with its AI-powered retry engine for unresolved payments. Once a payment enters FlexPay's retry queue, its advanced engine determines optimal retry frequencies and time intervals. Importantly, all transactions attempted through FlexPay seamlessly synchronize back into Chargebee, ensuring a comprehensive overview of payment recovery efforts.

Reach out to Flexpay for more pricing and commercial details.

Retrieve FlexPay API Key 

While connecting FlexPay with Chargebee, you are required to enter the FlexPay API Key. Follow the steps below to retrieve the FlexPay API Key from your FlexPay account:

  1. Login to your FlexPay account .
  2. Go to Account Settings > Integrations > API Keys.
  3. Copy an existing API Key or click GENERATE API KEY to create a new one. Keep the key safe for using the key while configuring FlexPay in Chargebee.

Connect FlexPay to Chargebee 


FlexPay is disabled by default in Chargebee. Reach out to Chargebee support  to enable FlexPay for integration in Chargebee.

Once enabled, follow these steps to connect FlexPay to Chargebee:

  1. The FlexPay app is in beta and not listed in the Chargebee marketplace. Use the URL  to navigate to the Flexpay page in your Chargebee site.

  2. On the Apps > FlexPay page, click Get Started.

  3. Enter the FlexPay API Token and click Connect.

Important configurations in your Chargebee site 

The following configurations are crucial for using FlexPay with Chargebee:

  1. Gateway Mapping configuration
  2. Dunning configuration

Gateway Mapping configuration 

Before you configure mapping in your Chargebee site, retrieve the Merchant Account Reference ID from your FlexPay account. Follow these steps:

  1. Login to your FlexPay account .
  2. Click Payment Gateways from the FlexPay dashboard.
  3. Click on the desired gateway and copy the Merchant Account Reference ID.

Once you have the Merchant account reference ID, move to the Chargebee app and follow these steps to manage existing gateway mapping or add a new mapping:

  1. On the Configure FlexPay page, click Manage under the Gateways section.

  2. Edit any existing mapping or click Add to add a new mapping.

  3. Select the corresponding gateway account configured in your Chargebee site.

  4. Enter the Merchant Account Reference ID fetched from the gateway account created in FlexPay.

  5. Click Save.

  6. If you use more than one gateway, then make sure to retrieve the correct mapping for all gateways from Flexpay and configure it here for the setup to work properly


Ensure that the same underlying account is utilized for both Chargebee and FlexPay. In the above example in the screenshot, the same Stripe account is used to create both the Chargebee gateway account and the FlexPay gateway account. Integration to Flexpay will not work and payments will not reach for Flexpay for retries if the wrong credentials are mapped in this section.

Dunning Configuration 

Follow these steps to configure dunning:

  1. On the Configure FlexPay page, click on Go to Dunning.

  2. Enable Retry Payments via FlexPay to enable FlexPay dunning. You will get two additional options:

    • Payment Retry Period: Enter the number of days to specify the dunning period within Chargebee.
    • FlexPay Retry Period: Enter the number of days to specify the dunning period within FlexPay.

The sum of both these periods should be less than or equal to the Dunning period.

Transactions via FlexPay Dunning 

Once the configuration is done, now failed transactions are ready to be recovered via FlexPay.

The invoice will show an info panel at the top that says which payment method will be used for the next retry.

When a transaction is made through FlexPay, the transaction is shown in the merchant UI with the associated Payment Recovery Account.

  • If a payment is processed through FlexPay and a refund is requested, the refund will also be processed through FlexPay.
  • When dunning processes occur through FlexPay, it's important to note that if a customer updates their card details in Chargebee, retries will persist using the original card details initially sent to FlexPay.
  • The sequence for payment recovery follows a structured approach: Chargebee handles initial recovery attempts, followed by FlexPay, per the configured dunning periods within the dunning settings.
Was this article helpful?