Get Transfer Status V1.2

Use these details to get details of a particular transfer. You can pass referenceId or transferId to fetch the details.

📘

Version 2 APIs

We provide version 2 APIs for Payouts that benefits you in multiple ways.

📘

You can view the version 1 of the Get Transfer Status API.

Please use this Authorization token in headers to call any payout API (Refresh this page if the token is expired)

Click to view the response codes.

Response Codes

Sub CodeStatusMessageNext Action
200SUCCESSDetails of transfer with referenceId (or transferId) XXXX-
403ERRORToken is not validVerify the generated token.
403ERRORIP not whitelistedWhitelist the IP address.
404ERRORReferenceId is invalid or does not existEnter a valid reference ID.
404ERRORTransferId is invalid or does not existEnter a valid transfer ID.
412ERRORToken missing in the requestEnter a valid token in the API request.
422ERRORPlease provide referenceId or transferId to fetch detailsEnter a valid referenceId or transferId.
520ERRORUnknown error occurredTry again after some time.
Click to view the failed reasons.

FAILED / REJECTED / REVERSED Reasons (reason field will be available only for these 3 statuses)

Reason (in API response)CategoryDescriptionNext Action
BANK_GATEWAY_ERRORBankTechnical error at the bank
BENE_BANK_DECLINEDBankRejected by Beneficiary bank due to business reasons
FAILEDBankNo explicit failure reason from the bank
INVALID_IFSC_FAILCustomerInvalid ifsc code provided for bank accountEnter a valid IFSC.
INVALID_ACCOUNT_FAILCustomerBank account is invalidEnter valid bank account information.
RETURNED_FROM_BENEFICIARYBankImmediate reversal from the beneficiary bank
INSUFFICIENT_BALANCEMerchantMerchant balance is exhausted, need to add funds
IMPS_MODE_FAILBankIMPS mode not supported for the beneficiary
RTGS_MODE_FAILBankRTGS mode not supported (only for RTGS)
REINITIALIZE_TRANSFER_LATERBankTechnical error at the bank, retry laterRetry after some time.
NRE_ACCOUNT_FAILCustomerCustomer bank account is an NRE account
ACCOUNT_BLOCKEDCustomerCustomer bank account is blocked
DEST_LIMIT_REACHEDBankTransfer limit to beneficiary exceeded
INVALID_MODE_FAILBankTransfer mode not valid for beneficiary
NPCI_UNAVAILABLEBankNPCI in unavailable
BENEFICIARY_BANK_OFFLINEBankBeneficiary bank is offline
INVALID_AMOUNT_FAILMerchantAmount is invalid for the given transfer modeEnter a valid amount for the provided transfer mode.
SUSPECTED_TRANSFERCustomerSuspicious transfer identified
BENE_NAME_DIFFERSCustomerBeneficiary name not matching with bank recordsEnter the beneficiary name as per bank records.
DISABLED_MODEMerchantTransfer mode not enabled for the accountEnter a different transfer mode for the account or enable the transfer mode before initiating the transfer request.
AMAZON_AMOUNT_EXCEEDMerchantAmount should be less than 10000 for Amazon Pay modeEnter a transfer amount that is lesser than Rs. 10000.
BENEFICIARY_BLACKLISTEDMerchantBeneficiary is blacklistedEnter a beneficiary that is not in the blacklist.
PAYOUT_INACTIVEMerchantPayout account is not active
INVALID_TRANSFER_AMOUNTMerchantTransfer amount is invalidEnter a valid transfer amount.
BENEFICIARY_NOT_EXISTMerchantBeneficiary does not existEnter valid beneficiary details.
BENEFICIARY_INVALID_MODEMerchantMode Not valid for BeneficiaryEnter a different transfer mode for the specified beneficiary.
INVALID_BENE_ACCOUNT_OR_IFSCMerchantInvalid bank account number or ifsc providedEnter a valid bank account number or IFSC.
BENEFICIARY_NAME_DIFFERSCustomerBeneficiary name not matching with bank recordsEnter the beneficiary name as per bank records.
ANY_OTHER_REASONBankNo reason provided for the failure/reversal
INVALID_OR_NO_SUCH_ACCOUNT_TYPECustomerInvalid account
List of possible transfer statuses returned by Cashfree Payments.

Transfer Statuses

Transfer StatusDescription
SUCCESSTransfer completed successfully. Acknowledged flag in the response tells whether the beneficiary bank has provided acknowledgement of the transfer request.
ERRORThere was an error while requesting the transfer. See sub status code received for more details on why the error occurred. Example: Wrong IFSC.
FAILEDThe transfer has failed.
PENDINGThe request is getting processed. Query transfer status (/getTransferStatus) after some time to see whether the request was successful/failed.
REVERSEDTransfer rejected by the beneficiary bank. The payout balance gets credited back with the amount charged. Note: You don't receive this when you are attempting a transfer but might see this when querying for transfer status (after a couple of hours). Configure the webhook endpoint to be notified in such cases.
Language
Authorization
Header
URL
Click Try It! to start a request and see the response here!