What are fallbacks?

A fallback is a payment recovery service that is used when the primary processor fails and the payment is routed to a backup processor.

There are scenarios where a payment may fail or decline with one processor but be authorized with another, such as when the first processor has technical issues. By setting up fallbacks to route the payment to a second processor under certain conditions, you increase the chance of a successful payment.

How to set up fallbacks

Setting up fallbacks is very simple with Primer:

  1. 1
    Create a workflow with the Payment created Trigger. Learn more about this Trigger here.
  2. 2
    Add the "Authorize payment" Action to your workflow. In the configuration panel, you will see the option to select a fallback processor.
  3. 3
    Select your fallback processor from one of your existing connected processors and assign a merchant account.

Configuring fallbacks

Once set up, when this workflow is triggered and it processes a payment, the fallback service will be utilized during authorization.

Fallbacks with 3DS

Fallbacks can be configured with the following 3DS settings within the "Authorize payment" Action of the Payments App:

  • Primer 3DS
  • Adaptive 3DS

During checkout, your customer will complete the 3DS authentication and this data will be included in the first authorization request. When the second authorization request is sent to the fallback processor, the 3DS data is included so the customer won't have to complete the 3DS flow twice.

Fallbacks are not compatible with Processor 3DS. This is because the processor handles the 3D Secure authentication flow and Primer is not involved in the flow.

When are fallbacks triggered?

Primer standardizes decline codes and reasons from processors so you only need to rationalize about payments once.

Payments have the following fields which have been standardized across all processors:

  • status
  • error decision type
  • error decline type
  • error decline reason

Falllbacks will be triggered when the payment has one of the following sets of field values:

StatusError Decision TypeError Decline TypeError Decline Reason
DeclinedGateway RejectedN/AN/A
DeclinedGateway RejectedSoft DeclineDo Not Honor
DeclinedGateway RejectedSoft DeclineDeclined
DeclinedGateway RejectedSoft DeclineRefer to Card Issuer
DeclinedApplication ErrorN/AN/A
DeclinedIssuer DeclinedSoft DeclineDeclined
DeclinedIssuer DeclinedSoft DeclineRefer to Card Issuer
DeclinedIssuer DeclinedSoft DeclineIssuer Temporarily Unavailable
DeclinedIssuer DeclinedSoft DeclineDo Not Honor
FailedApplication ErrorN/AN/A

Fallbacks and Adaptive 3DS have overlapping triggers. If both features are activated for a payment, Adaptive 3DS always has priority. If the second authorization attempt still fails, a fallback may be triggered.

See your fallback payments

There are two ways to see your fallback payments:

🖥

Payments timeline

Easy-to-use UI to browse and review the details of your fallback payments.

🧑🏽‍💻

Payments API

Retrieve details of your payments programmatically via API.

Payments timeline

You can see all your Primer payments from the Payments timeline in the Primer Dashboard.

Navigate to the specific payment detailed timeline page. You will see the fallback details, where the first processor was unsuccessful and the fallback was triggered sending a second authorization request to your fallback processor.

Primer is not a black box, but rather your payments infrastructure. By selecting a specific event, you can see the requests and responses, providing full transparency into everything that’s happened to your payment throughout its journey.

Payment timeline event summary

Merchants will soon be able to filter for all fallback payments in the Payments list view.

See your fallback payments via the Payments API

For a programmatic solution, either:

Testing fallbacks