Integration Overview

Learn about the integration methods that connect your CRM with FlexPay’s payment recovery solution

To begin recovering failed payments through FlexPay, your CRM must first be integrated with our platform. FlexPay offers two main integration methods: API post (such as Enterprise Integration, Enterprise with Scheduler, and Recovery Advisor) and flat file (Quick Start Recovery). Each method provides a unique approach to payment recovery, tailored to meet your specific needs. This guide will walk you through the available options, helping you determine the best fit for your system and ensuring a smooth integration process.

Enterprise Integration

In this payment recovery method, FlexPay functions as an invisible intermediary between your system of record and the payment gateway. When a retry attempt is initiated, it is routed through FlexPay to your native gateway. We analyze both your request and the gateway’s response, returning an enhanced response payload in real-time. If the transaction is declined again, our response will include a recommended Retry Date & Time. FlexPay continues to process each subsequent rebill attempt until the transaction is either approved, hard declined, or determined by our AI to be unrecoverable.

Step-by-Step process
  1. A merchant attempts to rebill a customer, but the transaction is declined by the gateway.
  2. The merchant schedules to process the retry through FlexPay's API the next day.
  3. FlexPay reviews the transaction details and performs any data cleanup if it determines it will increase the likelihood of success. The transaction is sent directly from FlexPay to the Gateway.
  4. FlexPay receives the response from the Gateway.
  5. If the transaction was not approved and the recovery engine determines the transaction is recoverable, it sends a response back with the best date and time to retry the transaction.
  6. The merchant schedules the transaction and retries on the date and time provided by FlexPay.
  7. The transaction is resubmitted through FlexPay.

  8. The process continues until there is a successful recovery, a hard decline, or FlexPay no longer considers the transaction recoverable.

For details on how to integrate, please see the Enterprise Integration guide

Enterprise with Scheduler Integration

In this integration method, retry attempts are routed through FlexPay to your payment gateway. Similar to the standard Enterprise Integration, we analyze your request along with the gateway’s original response, generating and transmitting an enhanced payload. If a transaction is declined again, FlexPay evaluates the response and automatically schedules a new retry attempt on a future date, optimized by our recovery engine for the highest likelihood of approval. This scheduling and retry process continues, leveraging insights from our machine learning models, until the payment is either approved, hard declined, or deemed unrecoverable.

Step-by-Step process
  1. A merchant attempts to rebill a customer, but the transaction is declined by the gateway.
  2. The merchant sends details about the declined transaction to FlexPay, along with the decline code and decline message from the Gateway.
  3. FlexPay reviews the transaction details and performs any data cleanup if it determines it will increase the likelihood of success. The transaction is sent directly from FlexPay to the Gateway.
  4. FlexPay receives the response from the Gateway.
  5. If the transaction was not approved and the AI machine-learning engine determines the transaction is recoverable, it schedules the transaction to be retried on a future date.
  6. When the scheduled date arrives, FlexPay will send the transaction to the gateway for processing.
  7. The process continues until there is a successful recovery, a hard decline, or FlexPay no longer considers the transaction recoverable.
  8. The merchant will query FlexPay daily to obtain an up-to-date status of their transactions.

For details on how to integrate, please see the Enterprise with Scheduler Integration guide

Recovery Advisor Integration

In this integration method, FlexPay does not interact directly with your payment gateway. Instead, your CRM communicates with FlexPay via API, providing the details of transactions that have been declined by your native gateway. FlexPay analyzes the provided data and immediately returns a recommendation for the optimal time to retry the transaction in the future.

Step-by-Step process
  1. A merchant attempts to rebill a customer, but the transaction is declined by the gateway.
  2. The merchant sends details about the declined transaction to FlexPay, along with the decline code and decline message from the Gateway.
  3. FlexPay reviews the transaction details. If the transaction was not approved and the recovery engine determines the transaction is recoverable, it sends a response back with the best date and time to retry the transaction.
  4. The merchant schedules the transaction and retries on the date and time provided by FlexPay.
  5. The transaction is resubmitted to the gateway.

  6. The process continues until there is a successful recovery, a hard decline, or FlexPay no longer considers the transaction recoverable.

Quickstart Recovery

This integration method allows you to recover declined transactions by connecting to FlexPay’s servers via SFTP and uploading flat files with the relevant transaction data to a designated folder. FlexPay processes each transaction in the file, analyzing the data to determine the optimal retry date. We handle all communication with the payment gateway for each reattempt and provide a daily output file containing the results of the recovery process.

*These can be declines that have already been retried and abandoned by the merchant, or they can be fresh (i.e. new) declines.

**Transaction results will be exported regardless of status.

Step-by-Step process
  1. A merchant selects a cohort of failed payments to be treated by FlexPay. This can be a set period of failed payments from the past (for example the past 30 days), or newly failed transactions for a given day (ie, the failed payments from today's processing).
  2. The merchant generates a file with the failed transactions and uploads it to FlexPay's SFTP.
  3. FlexPay reviews each transaction in the file and performs any data cleanup if it determines it will increase the likelihood of success. The transaction is sent directly from FlexPay to the Gateway.
  4. FlexPay receives the response from the Gateway.
  5. If the transaction was not approved and the AI machine-learning engine determines the transaction is recoverable, it schedules the transaction to be retried on a future date.
  6. When the scheduled date arrives, FlexPay will send the transaction to the gateway for processing.
  7. The process continues until there is a successful recovery, a hard decline, or FlexPay no longer considers the transaction recoverable.
  8. FlexPay provides an output file every day at 15:00 UTC with the Payment Results of the transactions processed the previous day. Alternatively, you can generate a Payment export from FlexPay's Client Portal.

For details on how to integrate, please see the Quick Start Recovery Integration guide

Engage Recovery

The Engage Recovery integration method is an ideal complement to Invisible Recovery efforts. Once FlexPay's machine learning models determine that a payment is unlikely to be recovered, an Engage Recovery outreach campaign is initiated. This campaign leverages the principles of behavioral science to maximize the chances of payment recovery. Through a series of carefully crafted messages delivered via email and/or SMS, Engage Recovery aims to elicit emotionally positive responses from customers.

Step-by-Step process
  1. When Invisible Recovery determines a payment is unrecoverable, the Engage Recovery (ER) campaign is triggered. A retry date, typically 40 days later (depending on configuration), is provided to the CRM along with the response.
  2. The ER campaign initiates with automated email and SMS outreach to the customer.
  3. The customer follows the instructions in the outreach messages to update their payment information in the CRM.
  4. The CRM processes the payment directly through the gateway and updates the subscription status.
  5. The CRM notifies FlexPay of the successful recovery.
  6. FlexPay updates the transaction record and closes the outreach campaign.
  7. A final message is sent to the customer, thanking them for their payment.
  8. If the payment information is not updated throughout the campaign, the CRM retries the payment according to the schedule provided in Step 1.
  9. FlexPay's response confirms that the recovery campaign was unsuccessful.

For details on how to integrate, please see the Engage Recovery Integration guide