If your refund request was unsuccessful, you may receive one of the following errors:
- `403 Refund not allowed`: The refund option is currently not available, for example, the payment has not yet cleared.
- `404 Payment not found`: The specified payment was not found, for example, the authorization ID was sent instead of the payment ID.
- `422`: Refund authorization declined, for example, invalid data was sent in the request.
To help identify the issue, you can subscribe to refund webhook notifications, use our get payment actions endpoint, or view it in your Dashboard account.
This checklist below may help you with troubleshooting common refund problem:
- Has the payment cleared?
- Is the refund amount higher than the original payment?
- Has the payment already been refunded?
- Did you send the authorization ID instead of the payment ID?
Note
After a card payment has been authorized, the payment is not complete until it has been captured. If you are trying to refund a transaction that has been authorized but not yet captured, consider voiding the transaction instead. Learn more about voiding a transaction.
To learn more about refunding a payment, see our refund guide.