get https://payout-api.cashfree.com/payout/v1.2/getTransferStatus
Use these details to get details of a particular transfer. You can pass referenceId or transferId to fetch the details.
Click here to view details of the get transfer staus API version 1.
Click to view the response codes, failure, and reasons for reversal.
Response Codes
| Sub Code | Status | Message |
|---|---|---|
| 200 | SUCCESS | Details of transfer with referenceId (or transferId) XXXX |
| 403 | ERROR | Token is not valid |
| 403 | ERROR | IP not whitelisted |
| 403 | ERROR | APIs not enabled. Please reach out to [email protected] |
| 404 | ERROR | ReferenceId is invalid or does not exist |
| 404 | ERROR | TransferId is invalid or does not exist |
| 412 | ERROR | Token missing in the request |
| 422 | ERROR | Please provide referenceId or transferId to fetch details |
| 520 | ERROR | Unknown error occurred |
FAILED / REJECTED / REVERSED Reasons (reason field will be available only for these 3 statuses)
| Reason (in API response) | Category | Description |
|---|---|---|
| BANK_GATEWAY_ERROR | Bank | Technical error at the bank |
| BENE_BANK_DECLINED | Bank | Rejected by Beneficiary bank due to business reasons |
| FAILED | Bank | No explicit failure reason from the bank |
| INVALID_IFSC_FAIL | Customer | Invalid ifsc code provided for bank account |
| INVALID_ACCOUNT_FAIL | Customer | Bank account is invalid |
| RETURNED_FROM_BENEFICIARY | Bank | Immediate reversal from the beneficiary bank |
| INSUFFICIENT_BALANCE | Merchant | Merchant balance is exhausted, need to add funds |
| IMPS_MODE_FAIL | Bank | IMPS mode not supported for the beneficiary |
| RTGS_MODE_FAIL | Bank | RTGS mode not supported (only for RTGS) |
| REINITIALIZE_TRANSFER_LATER | Bank | Technical error at the bank, retry later |
| NRE_ACCOUNT_FAIL | Customer | Customer bank account is an NRE account |
| ACCOUNT_BLOCKED | Customer | Customer bank account is blocked |
| DEST_LIMIT_REACHED | Bank | Transfer limit to beneficiary exceeded |
| INVALID_MODE_FAIL | Bank | Transfer mode not valid for beneficiary |
| NPCI_UNAVAILABLE | Bank | NPCI in unavailable |
| BENEFICIARY_BANK_OFFLINE | Bank | Beneficiary bank is offline |
| INVALID_AMOUNT_FAIL | Merchant | Amount is invalid for the given transfer mode |
| SUSPECTED_TRANSFER | Customer | Suspicious transfer identified |
| BENE_NAME_DIFFERS | Customer | Beneficiary name not matching with bank records |
| DISABLED_MODE | Merchant | Transfer mode not enabled for the account |
| AMAZON_AMOUNT_EXCEED | Merchant | Amount should be less than 10000 for Amazon Pay mode |
| BENEFICIARY_BLACKLISTED | Merchant | Beneficiary is blacklisted |
| PAYOUT_INACTIVE | Merchant | Payout account is not active |
| INVALID_TRANSFER_AMOUNT | Merchant | Transfer amount is invalid |
| BENEFICIARY_NOT_EXIST | Merchant | Beneficiary does not exist |
| BENEFICIARY_INVALID_MODE | Merchant | Mode Not valid for Beneficiary |
| INVALID_BENE_ACCOUNT_OR_IFSC | Merchant | Invalid bank account number or ifsc provided |
| BENEFICIARY_NAME_DIFFERS | Customer | Beneficiary name not matching with bank records |
| ANY_OTHER_REASON | Bank | No reason provided for the failure/reversal |
| INVALID_OR_NO_SUCH_ACCOUNT_TYPE | Customer | Invalid account |