get https://payout-api.cashfree.com/payout/v1.1/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 status API version 1.
Response Codes
| Status | Sub Code | Message |
|---|---|---|
| SUCCESS | 200 | Details of transfer with referenceId (or transferId) XXXX |
| 403 | ERROR | Token is not valid |
| 403 | ERROR | IP not whitelisted |
| 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 |
Failure Reasons
| Reason (in API response) | Category | Description |
|---|---|---|
| BANK_GATEWAY_ERROR | Bank | Technical error at the bank |
| SOURCE_BANK_DECLINED | Bank | TPS exceeded at the bank/NPCI |
| FAILED | Bank | No explicit failure reason from the bank |
| INVALID_AMOUNT_FAIL | Merchant | Amount is invalid for the given transfer mode |
| INVALID_AMOUNT_FAIL | Customer | Bank account is invalid |
| INVALID_REQUEST | Merchant | Request is invalid |
| RETURNED_FROM_BENEFICIARY | Bank | Immediate reversal from the beneficiary bank |
| INSUFFICIENT_BALANCE | 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 |
Reversed Reasons
| Reason (in API response) | Category | Description |
|---|---|---|
| ACCOUNT_FROZEN_OR_CLOSED | Customer | Account is closed or frozen |
| CREDIT_LIMIT_EXCEEDED | Customer | Transfer limit to beneficiary exceeded |
| ACCOUNT_CLOSED_OR_FROZEN | Customer | Transfer limit to beneficiary exceeded |
| ACCOUNT_ON_HOLD | Customer | Account is temporarily on hold |
| ACCOUNT_FROZEN | Customer | Account is frozen |
| IFSC_DOES_NOT_MATCH | Customer | IFSC does not match |
| FRAUD_REVERSED | Customer | Suspect fraudulent transfer |
| ANY OTHER REASON | Bank | Reason not specified by bank |
| INVALID_OR_NO_SUCH_ACCOUNT_TYPE | Customer | Invalid account |
| ACCOUNT_CLOSED | Customer | Account is closed |
| ACCOUNT_FROZEN_OR_BLOCKED | Customer | Account is frozen or blocked |
| BENEFICIARY_NAME_DIFFERS | Customer | Beneficiary name does not match (only for NEFT) |
| BENEFICIARY_BANK_NODE_OFFLINE | Bank | Beneficiary bank offline |
| ACCOUNT_DOES_NOT_EXIST | Customer | Account does not exist |