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.