Refund Status and List of Refund APIs

Learn in detail about the various refund statuses and the list of APIs involved in refunds.

Refund Status

When you trigger a refund, a refund goes through various states, they are listed below:

Refund StatusDescription
PENDINGThis state indicates that the refund is pending.
SUCCESSThis state indicates that the refund is processed successfully to the customer account.
CANCELLEDThis state indicates that the refund has been cancelled.
ONHOLDThis state indicates that the refund has been put on hold.
FAILEDThis state indicates that the refund has failed. A few reasons why refunds fail are listed below:
1. If the beneficiary account is inactive or frozen, refunds cannot be processed.
2. If there is no sufficient balance in your account.

List of refunds APIs

The table below lists all the refund APIs along with their description.

API NameDescription
Create RefundUse this API to initiate a standard or an instant refund.
Get All Refunds for an OrderUse this API to fetch all the refunds processed against a particular order.
Get RefundUse this API to fetch the details for a specific refund processed on your Cashfree Payment account.