Soft Fail Recovery

Soft Fail lets orders with certain payment errors be created instead of being immediately rejected. The customer gets an email with a secure link to update their payment, and the order sits on hold in Magento — recovering payments without losing the order.

Step-by-Step Guide

1. 1

   Enable the Feature

   In the Magento Admin Panel, locate the Brippo section and find the Soft Fail setting. It's disabled by default — set it to Yes to turn it on.

   Once enabled, additional configuration options become available. The most relevant are:

   • Only After First Attempt: when enabled, the first failed attempt is blocked as usual and an error is shown to the customer. Soft Fail kicks in only from the second attempt onwards.
   • Affected Error Types: multi-select field where you choose which payment errors (insufficient funds, card declined, etc.) trigger the soft-fail flow.

   

   i

   More options below. Several additional options appear once the feature is enabled — review Soft Fail Recovery in full to tailor the behaviour to your store.
2. 2

   Test the Behaviour

   Simulate a soft-fail scenario with a known test card.

   Recipe:

   • Place a new order on the frontend.
   • At checkout, use the test card that simulates "insufficient funds": 4000 0000 0000 0002.
   • Complete the required payment fields and place the order.

   Expected result:

   • The order is created successfully, despite the payment failure.
   • The customer receives an email notification explaining the error and including a link to update the payment.
   • In the Magento Admin, the order shows the status "Brippo On Hold — Trying to Recover" until the payment is updated.

   

   i

   Other test cards or scenarios work too — as long as the resulting error type is included in the Affected Error Types config.