Detailed refusal reason for failed payins

We've added better visibility into the reason a payin fails to process.

During the processing of the payin, if the payin fails to process a Refusal Reason is returned in the API and displayed in the Payin Details Component. The refusal reason returns in the API in the fields refusal_code and refusal_desc. The refusal reason can return as a generic "Declined", which does not give context into why it failed to process.

To help you and your merchants determine the reason the payin failed, a new Detailed Refusal Reason will be populating in the API and displayed in the Payin Details Component. These values are not immediately returned on failure and it can take up to 5 minutes for this information to populate in the API.

For example, the refusal reason could be "Declined", but the detailed refusal reason could be more descriptive, such as "Insufficient funds". For a full list of refusal reasons, see the refusal codes guide.

Payin Details Component

The DETAILED REFUSAL REASON in the Related info section will display as "--" until it is populated.

API

The following fields will be available in the list payments, list payins, and get payin endpoints to help you understand why a payin fails.

• detailed_refusal_code
• detailed_refusal_desc

These fields will be null until they are populated, which can take up to 5 minutes after the payin fails.