added

Detailed refusal reason for failed refunds

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

During the processing of the refund, if the refund fails to process a Refusal Reason is returned in the API and displayed in the Refund 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 refund failed, a new Detailed Refusal Reason will be populated in the API and displayed in the Refund 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 "Card expired". For a full list of refusal reasons, see the refusal codes guide.

Refund 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, get refund, and get payin endpoints to help you understand why a refund 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 refund fails.