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 |