Skip to main content
POST
/
transfers
curl --request POST \
  --url https://sandbox.cashfree.com/payout/transfers \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '{
  "transfer_id": "JUNOB2018",
  "transfer_amount": 1,
  "beneficiary_details": {
    "beneficiary_id": "JOHN18011"
  }
}'
{
  "transfer_id": "JUNOB2018",
  "cf_transfer_id": "123456",
  "status": "RECEIVED",
  "status_code": "RECEIVED",
  "status_description": "The transfer has been received by Cashfree successfully for further processing. You should use Check Status API response or Webhooks to know the terminal state of the transfer request.",
  "beneficiary_details": {
    "beneficiary_id": "JOHN18011"
  },
  "transfer_amount": 1,
  "transfer_mode": "BANK",
  "fundsource_id": "CASHFREE_1",
  "added_on": "2021-11-24T13:39:25Z",
  "updated_on": "2021-11-24T13:40:27Z"
}
5XX error
When you get a 5XX response, do not initiate another transaction.
Check the status of the batch transfer using Get Batch Transfer Status V2 and then proceed further.
Get Transfer Status
Use the Get Transfer Status V2 API to get the status of the batch transfer request. The Get Transfer Status V2 API does not give you the status of the batch transfer requests.
HTTP Status CodeStatusStatus CodeStatus DescriptionNext ActionTry again via Cashfree Payments
200APPROVAL_PENDINGVELOCITY_CHECK_FAILEDThe transfer requires an approval as the count of transfers to a particular beneficiary etc have breached the limit. You can approve or reject the transfer request from the Cashfree Merchant Dashboard.You can approve/reject the transfer on the Merchant Dashboard. Go to: Transfers > Approve. Post the transfer is approved, the request is sent to the partner bank for further processing.-
200APPROVAL_PENDINGTRANSFER_LIMIT_BREACHThe transfer requires an approval as the transfer amount etc have breached the limit. You can approve or reject the transfer request from the Cashfree Merchant Dashboard.You can approve/reject the transfer on the Merchant Dashboard. Go to: Transfers > Approve. Post the transfer is approved, the request is sent to the partner bank for further processing.-
200APPOVAL_PENDINGAPPROVAL_PENDINGThe transfer requires approval. You can approve or reject the transfer request from the Cashfree Merchant Dashboard.You can approve/reject the transfer on the Merchant Dashboard. Go to: Transfers > Approve. Post the transfer is approved, the request is sent to the partner bank for further processing.-
200FAILEDWAIT_TIME_EXCEEDEDThe transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).You can reinitiate the transfer via Cashfree Payments to reattempt with the partner bank(s).Yes
200FAILEDBENE_BANK_DECLINEDThe transfer has failed because the beneficiary bank has declined the transfer. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again with the partner bank(s).-Yes
200FAILEDIMPS_MODE_FAILThe transfer has failed because the beneficiary account doesnot support IMPS transfers. This rejection is done by the partner bank for the specific beneficiary account. You can try NEFT or other channels to do the disbursals.You can try NEFT or other channels to do the disbursals.Yes, via a different mode.
200FAILEDSOURCE_BANK_DECLINEDThe transfer has failed because our partner bank has declined the transfer because of their internal checks, technical declines etc. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again with the partner bank(s).You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again with other partner bank(s).Yes
200FAILEDCONNECTION_TIMEOUTThe transfer has failed because there was a connection timeout between the bank and Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again with the partner bank(s).You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again with the partner bank(s).Yes
200FAILEDPAYOUT_INTERNAL_ERRORThe transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).-Yes
200FAILEDNPCI_UNAVAILABLEThe transfer has failed because NPCI was unavailable to complete the transfer request. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree. The success of the request is contingent on NPCI services being up.-Yes, after some time.
200FAILEDDEST_LIMIT_REACHEDThe transfer has failed because the beneficiary account has breached the limit of receiving funds. This rejection is done by the beneficiary bank for the specific beneficiary account. You can reinitiate the transfer after a while via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s). The success of the request is contingent on beneficiary’s limit being available to receive incoming funds.-Yes, after some time.
200FAILEDRETURNED_FROM_BENEFICIARYThe transfer has failed because the beneficiary bank has returned the transfer and has not need able to credit funds to the end beneficiary. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again with the partner bank(s).--
200FAILEDPAYOUT_INTERNAL_ERRORThe transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).--
200FAILEDINVALID_BENE_ACCOUNT_OR_IFSCThe transfer has failed because the beneficiary account or IFSC is invalid. After correcting the beneficiary account or IFSC, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).--
200FAILEDPAYOUT_INTERNAL_ERRORThe transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).--
200FAILEDFAILEDThe transfer has failed because there was an intermittent issue at the partner bank’s end. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after some time.
200FAILEDPAYOUT_INTERNAL_ERRORThe transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).--
200FAILEDINSUFFICIENT_BALANCEThe transfer has failed because of low balance in your Cashfree Wallet/ Bank Account. After recharging the account, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).After recharging the account, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after recharging.
200FAILEDINVALID_BENE_VPAThe transfer has failed because the beneficiary VPA is invalid. After correcting the VPA handle, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).After correcting the VPA handle, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after correcting VPA handle.
200FAILEDINVALID_IFSC_FAILThe transfer has failed because the IFSC is invalid. After correcting the IFSC, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).After correcting the IFSC, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after correcting IFSC.
200FAILEDBAD_GATEWAYThe transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes
200FAILEDINVALID_AMOUNT_FAILThe transfer has failed because the amount entered is invalid. After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after correcting amount
200FAILEDINVALID_ACCOUNT_FAILThe transfer has failed because the Account Number of the beneficiary is invalid, as per our partner bank. After correcting the account number, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).After correcting the account number, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after correcting account number
200FAILEDINVALID_REQUESTThe transfer has failed because the transfer request is invalid, as per our partner bank, because of exceeding the character limit of certain parameter, wrong input etc. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).--
200FAILEDACCOUNT_BLOCKEDThe transfer has failed because the account is blocked, as per our partner bank. After getting the account unblocked, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).After getting the account unblocked, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after unblocking the account number
200FAILEDDEBIT_FAILUREThe transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes
200FAILEDBENEFICIARY_BANK_OFFLINEThe transfer has failed because the respective beneficiary bank is offline. After some time, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).After some time, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after some time
200FAILEDAUTHENTICATION_FAILUREThe transfer has failed because there was an authentication failure at the partner bank’s end. After checking with the partner bank, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).This is a scenario when the API access is not working at the partner bank’s end. After checking with the partner bank, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes
200FAILEDNRE_ACCOUNT_FAILThe transfer has failed because the beneficiary account is an NRE Account and transfers to NRE Accounts are not supported, as per our partner bank.Get a new account(non-NRE account) from the beneficiary; you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes
200FAILEDSOURCE_LIMIT_REACHEDThe transfer has been failed by the partner bank as the source bank account has reached a limit of transferring funds. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).If you are on Cashfree Wallet, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s). If you are on Connected Bank, you need to recharge your bank account and then reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after some time
200FAILEDBANK_GATEWAY_ERRORThe transfer has failed because there was an intermittent issue at the partner bank’s end. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes
200FAILEDBAD_REQUESTThe transfer has failed because the details of the transfer request is invalid, as per our partner bank. After correcting the details in the transfer request, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).After correcting the details in the transfer request, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes
200FAILEDREINITIALIZE_TRANSFER_LATERThe transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes
200MANUALLY_REJECTEDMANUALLY_REJECTEDThe transfer has failed because it has been manually rejected by the merchant or any team member user who has the permissions to do the same on Merchant Dashboard. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again with the partner bank(s).If the merchant wants to reinitiate the transfer, they can reinitiate the transfer via Cashfree so that the transfer can be reattempted again with the partner bank(s).Yes, if you want to reinitiate the transfer
200PENDINGSENT_TO_BANKThe transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. This has been sent to the bank by our banking operations team. Please do check statuses or await webhooks to know the terminal state of the transfer request.Rely on Check Status API or Webhooks.-
200PENDINGBANK_GATEWAY_ERRORThe transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. You should rely only on Check Status API response or Webhooks to know the terminal state of the transfer request.Rely on Check Status API or Webhooks.-
200PENDINGNO_SUCH_REQUESTThe transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. The bank is not able to find the request at their end as of now, and it has been sent to the bank by our banking operations team. Please do check statuses or await webhooks to know the terminal state of the transfer request.Rely on Check Status API or webhooks.-
200PENDINGIN_PROCESSThe transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. Please do check statuses or await webhooks to know the terminal state of the transfer request.Rely on Check Status API or webhooks.-
200PENDINGERROR_FETCHING_STATUSThe transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. The response received from the partner bank has a new code. This has been raised with the bank to understand the new code. Please do check statuses or await webhooks to know the terminal state of the transfer request.Rely on Check Status API or webhooks.-
200PENDINGTRANSACTION_PROCESSEDThe transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. You should rely only on Check Status API response or Webhooks to know the terminal state of the transfer request.Rely on Check Status API or webhooks.-
200PENDINGREQUEST_TIMEDOUTThe transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. The bank is not able to find the request at their end as of now as the request between the partner bank has probably timed out, and it has been highlighted to the bank by our banking operations team. Please do check statuses or await webhooks to know the terminal state of the transfer request.Rely on Check Status API or webhooks.-
200PENDINGDUPLICATEThe transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. The bank claims of receiving a duplicate request at their end as of now. You should rely only on Check Status API response or Webhooks to know the terminal state of the transfer request.Rely on Check Status API or webhooks.-
200PENDINGPENDINGThe transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. You should rely only on Check Status API response or Webhooks to know the terminal state of the transfer request.Rely on Check Status API or webhooks.-
200PENDINGSCHEDULED_FOR_NEXT_WORKINGDAYThe transfer is currently in a Pending state, as the bank has scheduled the transfer for the next working day. This typically happens for NEFT/RTGS transfers if they are initiated beyond the cut-off hours or during bank holidays. You should rely only on Check Status API response or Webhooks to know the terminal state of the transfer request.--
200PENDINGSUSPECTThe transfer is currently in a Pending state, as the bank has scheduled the transfer for the next working day. This typically happens for NEFT/RTGS transfers if they are initiated beyond the cut-off hours or during bank holidays. You should rely only on Check Status API response or Webhooks to know the terminal state of the transfer request.--
200PENDINGIMPLEMENTATION_ERRORThe transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. You should rely only on Check Status API response or Webhooks to know the terminal state of the transfer request.--
200PENDINGUNKNOWN_ERROR_CODEThe transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. The response received from the partner bank has a new code. This has been raised with the bank to understand the new code. Please do check statuses or await webhooks to know the terminal state of the transfer request.--
200QUEUEDQUEUEDThe transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. You should rely only on Check Status API response or Webhooks to know the terminal state of the transfer request.Rely on Check Status API or webhooks.-
200RECEIVEDRECEIVEDThe transfer has been received by Cashfree successfully for further processing. You should use Check Status API response or Webhooks to know the terminal state of the transfer request.Rely on Check Status API or webhooks.-
200REJECTEDBENE_NOT_EXISTThe transfer has been rejected because the beneficiary, added in the transfer request, does not exist. After adding the right beneficiary, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).After adding the right beneficiary, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after adding the correct beneficiary.
200REJECTEDINSUFFICIENT_BALANCEThe transfer has been rejected because of low balance in your Cashfree Wallet. After recharging the account, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).After recharging the account, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after recharging.
200REJECTEDINSIDE_BLACKOUT_WINDOWThe transfer has been rejected because the transfer falls under the blackout window defined by you in Payout Protect. You can reinitiate the transfer via Cashfree, after the blackout window or after modifying the blackout window from the Merchant Dashboard, so that the transfer can be reattempted again by Cashfree with the partner bank(s).You can reinitiate the transfer via Cashfree, after the blackout window or after modifying the blackout window from the Merchant Dashboard, so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes
200REJECTEDINVALID_MODE_FOR_PYIDThe transfer has been rejected because the payment instrument does not support this mode of transfer. You should get this mode activated on the payment instrument ID by contacting Cashfree, and then initiate a new transfer request.You should get this mode activated on the payment instrument ID by contacting Cashfree, and then initiate a new transfer request.Yes, after activating model
200REJECTEDBENE_BLACKLISTEDThe transfer has been rejected because the beneficiary’s bank account and/or VPA handles have been blacklisted by Risk team. You should get a different bank account and/or VPA to send the transfer, or you can connect with Cashfree Team to understand more about this.You should get a different bank account and/or VPA to send the transfer, or you can connect with Cashfree Team to understand more about this.Yes, after correcting beneficiary details
200REJECTEDTRANSFER_NOT_ATTEMPTEDThe transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes
200REJECTEDINVALID_TRANSFER_AMOUNTThe transfer has been rejected because the amount entered is invalid. After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after correcting the amount
200REJECTEDTRANSFER_LIMIT_BREACHThe transfer has been rejected because the amount entered breaches the limits set for your payout account. After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s). You can connect with Cashfree if you are not sure about the transfer limits set for your payout account.After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s). You can connect with Cashfree if you are not sure about the transfer limits set for your payout account.Yes, after adhering to the transfer limits.
200REJECTEDINVALID_PAYMENT_INSTRUMENTThe transfer has been rejected because the payment instrument (fundsource_id parameter in the API request) used for attempting the transfer is invalid. After correcting the payment instrument, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).After correcting the payment instrument, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after correcting payment instrument
200REJECTEDPAYOUT_INTERNAL_ERRORThe transfer has been rejected because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes
200REJECTEDVELOCITY_CHECK_FAILEDThe transfer has been rejected because the amount entered breaches the limits set for your payout account. After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s). You can connect with Cashfree if you are not sure about the transfer limits set for your payout account.After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s). You can connect with Cashfree if you are not sure about the transfer limits set for your payout account.Yes, after adhering to the transfer limits.
200REJECTEDPAYOUT_INTERNAL_ERRORThe transfer has been rejected because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes
200REJECTEDPAYOUT_INTERNAL_ERRORThe transfer has been rejected because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes
200REJECTEDDISABLED_MODEThe transfer has been rejected because your payout account does not support this mode of transfer. You should get this mode activated on your payout account by contacting Cashfree, and then initiate a new transfer request.You should get this mode activated on your payout account by contacting Cashfree, and then initiate a new transfer request.Yes, after activating mode.
200REJECTEDBANK_ACCOUNT_INVALIDThe transfer has been rejected because there is a mismatch in the Bank Account Number of the beneficiary ID and the Bank Account Number in the transfer request. After correcting the Bank Account Number, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).After correcting the Bank Account Number, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after correcting the bank account number.
200REJECTEDBANK_IFSC_INVALIDThe transfer has been rejected because there is a mismatch in the IFSC of the beneficiary ID and the IFSC in the transfer request. After correcting the IFSC, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).After correcting the IFSC, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after correcting the IFSC
200REJECTEDVPA_INVALIDThe transfer has been rejected because there is a mismatch in the VPA handle of the beneficiary ID and the VPA handle in the transfer request. After correcting the VPA handle, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).After correcting the VPA handle, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after correcting the VPA handle
200REJECTEDPHONE_INVALIDThe transfer has been rejected because there is a mismatch in the Phone Number of the beneficiary ID and the Phone Number in the transfer request. After correcting the Phone Number, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).After correcting the Phone Number, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after correcting the phone number.
200REJECTEDBANK_ACCOUNT_DETAILS_MISSINGThe transfer has been rejected because the Bank Account Details are missing in the transfer request. After adding the Bank Account Details, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).After adding the Bank Account Details, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after adding the bank account details.
200REVERSEDACCOUNT_BLOCKEDThe transfer has been reversed by the beneficiary bank as the end-beneficiary’s account is blocked for receiving incoming funds. After correcting the account number or getting the account unblocked, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).After correcting the account number or getting the account unblocked, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after adding new details or getting account unblocked.
200REVERSEDFAILEDThe transfer has been reversed by the beneficiary bank as they were unable to credit the end beneficiary’s bank account. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).-Yes
200REVERSEDNRE_ACCOUNT_FAILThe transfer has been reversed by the beneficiary bank as they were unable to credit the end beneficiary’s bank account as it is an NRE Account and transfers to NRE Accounts are not supported.Get a new account(non-NRE account) from the beneficiary; you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).No
200REVERSEDRETURNED_FROM_BENEFICIARYThe transfer has been reversed by the beneficiary bank as they were unable to credit the end beneficiary’s bank account. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes
200REVERSEDBENE_BANK_DECLINEDThe transfer has been declined by the beneficiary bank and they were unable to credit the end beneficiary’s bank account. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes
200REVERSEDIMPS_MODE_FAILThe transfer has been reversed by the beneficiary bank because the beneficiary bank account doesnot support IMPS transfers. This rejection is done by the beneficiary bank for the specific beneficiary account. You can try NEFT or other channels to do the disbursals.You can reinitiate the transfer via Cashfree by changing the mode so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after changing mode.
200REVERSEDDEST_LIMIT_REACHEDThe transfer has been reversed by the beneficiary bank as the end-beneficiary’s account has reached a limit of receiving incoming funds. This rejection is done by the beneficiary bank for the specific beneficiary account. You can reinitiate the transfer after a while via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s). The success of the request is contingent on beneficiary’s limit being available to receive incoming funds.The limits on the beneficiary account are typically refreshed every 24 hours. Its not clear when the 24 hour window shall elpase so you can then reinitiate the transfer via Cashfree after some time so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after some time.
200REVERSEDINVALID_ACCOUNT_FAILThe transfer has been reversed by the beneficiary bank because the Account Number of the beneficiary is invalid. After correcting the account number, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).After correcting the account number, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after correcting the account number
200SUCCESSSENT_TO_BENEFICIARYThe transfer has been initiated via the partner bank successfully. The request is waiting to be processed at the beneficiary bank to do the credit to the end beneficiary.--
200SUCCESSCOMPLETEDThe transfer has been initiated via the partner bank successfully, hence your account is debited and the request is successfuly processed by the beneficiary bank and has been credited to the end beneficiary.--
200REJECTEDTRANSFERID_INVALIDtransferid can contain only alphabets, numbers, underscore (_), hyphen (-).After correcting the transferid, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after correcting transfer id.
200REJECTEDAMOUNT_INVALIDamount can contain only numbers.After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after correcting amount.
200REJECTEDREMARKS_INVALIDremarks can contain only alphabets, numbers and space.After correcting the remarks, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after correcting remarks.
200REJECTEDBENEID_INVALIDbeneId can contain only alphabets, numbers and underscore.After correcting the beneid, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after correcting beneficiary id.
200REJECTEDNAME_INVALIDname can contain only alphabets, numbers and space.After correcting the name, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after correcting name.
200REJECTEDEMAIL_INVALIDemail is not a valid email format.After correcting the email, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after correcting email.
200REJECTEDIBAN_INVALIDiban can contain only alphabet and numbers.After correcting the iban, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after correcting IBAN.
200REJECTEDTRANSFERMODE_INVALIDtransferMode can contain in one of banktransfer upi paytm amazonpay imps neft rtgs ppc.After correcting the transfermode, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after correcting mode.
200REJECTEDCURRENCY_INVALIDcurrency is invalid.After correcting the currency, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after correcting currency.
200REJECTEDACCOUNT_DOES_NOT_EXISTThe transfer has been rejected because the beneficiary account/ VPA does not exist as per our partner bank.After correcting the account number, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after correcting details.
200FAILEDACCOUNT_DOES_NOT_EXISTThe transfer has failed because the beneficiary account/ VPA does not exist as per our partner bank.After correcting the account number, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after correcting details.
200REJECTEDAMAZON_AMOUNT_EXCEEDThe transfer has been rejected because the amount entered breaches the limits set for the beneficiaries amazon account.After verifying the limits for beneficiaries amazon account, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after verifying limits.
200FAILEDAMAZON_AMOUNT_EXCEEDThe transfer has failed because the amount entered breaches the limits set for the beneficiaries amazon account.After verifying the limits for beneficiaries amazon account, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after verifying limits.
200REJECTEDANOMALY_DETECTIONThe transfer has been rejected as Cashfree risk product has detected an anamoly.You can reinitiate the transfer request after validation at your end.Yes, after validation.
200APPROVAL_PENDINGANOMALY_DETECTIONThe transfer requires approval as Cashfree risk product has detected an anamoly.You can approve/reject the transfer on the merchant dashboard. Post the transfer is approved, the request is sent to the partner bank for further processing.-
200FAILEDBAD_CONNECTIONThe transfer has failed because there was an intermittent internal error between Cashfree and the partner bank.You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after some time.
200REJECTEDBENE_INVALIDThe transfer has been rejected because the beneficiary added in the transfer request does not exist.After adding the right beneficiary, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after adding beneficiary.
200FAILEDBENE_INVALIDThe transfer has failed because the beneficiary added in the transfer request does not exist.After adding the right beneficiary, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after adding beneficiary.
200FAILEDBENE_NOT_REGISTEREDThe transfer has been rejected because the beneficiary added in the transfer request is not registered with the partner bank.After adding the right beneficiary, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after adding beneficiary.
200VALIDATION_PENDINGBENE_VERIFICATION_PENDINGThe transfer is pending because the beneficiary verification is pending. Once the beneficiary is validated we will attempt the transfers with partner bank(s).--
200FAILEDBENEFICIARY_BANK_UNAVAILABLEThe transfer has failed because the respective beneficiary bank is offline.After some time, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after some time.
200FAILEDBENEFICIARY_NAME_DIFFERSThe transfer has failed because the beneficiary name differs as per Cashfree’s partner bank.After adding the right beneficiary, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after correcting name.
200REJECTEDBENEFICIARY_NAME_DIFFERSThe transfer has been rejected because the beneficiary name differs as per Cashfree’s partner bank.After adding the right beneficiary, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after correcting name.
200REJECTEDBENEFICIARY_NAME_MISMATCHThe transfer has been rejected because the beneficiary name differs as per Cashfree’s partner bank.After adding the right beneficiary, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after correcting name.
200REJECTEDCARD_UNSUPPORTEDThe transfer has been rejected because the card is not supported.After changing the payment instrument details, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after changing instrument.
200FAILEDCARD_UNSUPPORTEDThe transfer has failed because the card is not supported.After changing the payment instrument details, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after changing instrument.
200FAILEDDUPLICATE_FAILEDThe transfer has failed as the bank claims of receiving a duplicate request at their end as of now.You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, with new id.
200FAILEDERROR_RETRIEVING_BALANCEThe transfer has failed because there was an intermittent issue at the partner bank’s end.You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after some time.
200REJECTEDINVALID_CARDThe transfer has been rejected because the card details are not correct.After changing the payment instrument details, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after correcting card.
200FAILEDINVALID_CARDThe transfer has failed because the card details are not correct.After changing the payment instrument details, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after correcting card.
200REJECTEDINVALID_CURRENCY_FOR_PYIDThe transfer has has been rejected because the transfer currency passed in the transfer request is not supported by Cashfree.After changing the currency to INR, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after changing currency.
200FAILEDINVALID_CURRENCY_FOR_PYIDThe transfer has has been rejected because the transfer currency passed in the transfer request is not supported by Cashfree.After changing the currency to INR, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after changing currency.
200FAILEDINVALID_MODE_FAILThe transfer has failed because the requested transfer mode is not supported for this beneficiary account as per the partner bank.After changing the transfer mode, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after changing mode.
200REJECTEDINVALID_OR_NO_SUCH_ACCOUNT_TYPEThe transfer has been rejected because the beneficiary account type is invalid or not supported as per our partner bank.Get a new account from the beneficiary; you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after new account.
200FAILEDINVALID_OR_NO_SUCH_ACCOUNT_TYPEThe transfer has failed because the beneficiary account type is invalid or not supported as per our partner bank.Get a new account from the beneficiary; you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after new account.
200FAILEDINVALID_PHONE_BENEFICIARYThe transfer has failed because the beneficiary’s phone number is not linked to any VPA.After adding the right phone beneficiary, You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after correcting phone.
200REJECTEDINVALID_TRANSFER_CURRENCYThe transfer has been rejected because the transfer currency passed in the transfer request is not supported by Cashfree.After changing the currency to INR, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after changing currency.
200FAILEDINVALID_TRANSFER_CURRENCYThe transfer has failed because the transfer currency passed in the transfer request is not supported by Cashfree.After changing the currency to INR, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after changing currency.
200REJECTEDKYC_COMPLIANCE_VERIFICATION_FAILEDThe transfer has failed because the KYC verification has failed.You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after KYC resolution.
200REJECTEDKYC_REQUIREMENTS_NOT_SATISFIEDThe transfer has failed because the KYC requirements have not been satisfied.You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after completing KYC.
200FAILEDLOAD_LIMIT_EXHAUSTEDThe transfer has failed because the beneficiaries account has reached maximum transaction amount limit.After 24 hours, You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after 24 hours.
200FAILEDLOAN_FUND_MOVEMENT_FAILUREThe transfer has failed because of an intermittent issue at Cashfree’s end.You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after some time.
200PENDINGLOW_BALANCE_QUEUEDThe transfer is pending because the balance in the fund source is exhausted. This transfer will be processed after you recharge the fund source, you need not reinitiate this transfer.This transfer will be processed after you recharge the fund source, you need not reinitiate this transfer. Please rely on check status API or webhook for checking the status of this transfer.-
200REJECTEDMANUALLY_REJECTEDThe transfer has been manually rejected by you.You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree.Yes, if needed.
200REJECTEDPAYOUT_INACTIVEThe transfer has been rejected because your payout account has been inactive.After getting the account activated, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after activation.
200PENDINGPENDINGThe transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status.Rely on Check Status API or Webhooks-
200FAILEDPOOL_CONNECTION_TIMEOUTThe transfer has failed because there was an connection issue with the partner bank’s end.You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after some time.
200REJECTEDQUICK_TRANSFER_DISABLEDThe transfer has been rejected because quick transfer is disabled for your payout account.After getting quick transfer enabled, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after enabling.
200REJECTEDREJECTEDTransfer rejected.-Yes, after correction.
200REVERSEDREVERSEDThe transfer has been reversed by the beneficiary bank as the credit to end-beneficiary’s account has failed.You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, after correction.
200FAILEDRTGS_MODE_FAILThe transfer has failed because the beneficiary account doesnot support RTGS transfers.You can try NEFT or other channels to do the disbursals.Yes, via different mode.
200FAILEDSUSPECTED_FAILEDThe transfer has failed, as the partner bank suspects that the transfer is of fraudulent nature.-No (investigate).
200REJECTEDVBA_TRANSFER_DISABLEDThe transfer has been rejected because transfers to virtual bank accounts are not enabled for your Cashfree Account.After getting payouts to virtual bank accounts enabled, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s). You can connect with Cashfree for enabling payouts to virtual bank accounts.Yes, after enabling.
200REJECTEDERROR_SELECTING_FUND_SOURCEThe transfer has been rejected because their is some issue with your acccount configuration.You can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after fixing config.
200VALIDATION_PENDINGVALIDATION_PENDINGThe transfer is pending because the beneficiary verification is pending. Once the beneficiary is validated we will attempt the transfers with partner bank(s).Rely on Check Status API or Webhooks-
200REJECTEDINVALID_BENEFICIARY_CODEThe transfer has been rejected because the bene code is Invalid.After correcting the beneficiary code, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).Yes, after correcting code.
200REJECTEDDUPLICATE_TRANSFERThe transfer is already present in the file or has been processed previously. Please change the transferId in the api request.After changing the Transfer Id, You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).Yes, with new transfer id.

​
4XX errors

HTTP Status CodeError CodeMessageNext Action
400transfer_id_missingtransfer_id is missing in the requestEnter a valid transfer_id in the request.
400transfer_id_invalidtransfer_id should be alphanumericEnter a valid transfer_id in the request.
400transfer_amount_invalidtransfer_amount should be greater then 1.00Enter an amount greater than 1.00.
400transfer_amount_missingtransfer_amount is missing in the requestProvide a value for the transfer_amount parameter in the request.
400transfer_mode_invalidtransfer_mode is invalid allowed values are : bank, imps, neft, rtgs, upi, paytm, amazonpay, card and cardupiProvide a valid transfer_mode in the request.
400beneficiary_details.beneficiary_id_invalidbeneficiary_id should be alphanumericEnter a valid beneficiary_id.
400beneficiary_details.beneficiary_name_invalidbeneficiary_name is invalid. only alphabets and whitespaces are allowedEnter a valid beneficiary_id.
400beneficiary_details.beneficiary_instrument_details.bank_account_number_invalidbank_account_number should be alphanumericEnter a valid bank_account_number.
400beneficiary_details.beneficiary_instrument_details.bank_account_number_invalidBank account number passed in the request does not match with the beneficiary with beneficiary_id :: test_beneIdEnter the correct bank_account_number associated with the beneficiary_id.
400beneficiary_details.beneficiary_instrument_details.bank_ifsc_invalidbank_ifsc should be in standard ifsc formatEnter a valid bank_ifsc.
400beneficiary_details.beneficiary_instrument_details.bank_ifsc_invalidBank ifsc passed in the request does not match with the beneficiary with beneficiary_id :: test_beneIdEnter the correct bank_ifsc associated with the beneficiary_id.
400beneficiary_details.beneficiary_instrument_details.vpa_invalidvpa is in invalid formatEnter a valid VPA.
400beneficiary_details.beneficiary_instrument_details.vpa_invalidVpa passed in the request does not match with the beneficiary with beneficiary_id :: test_beneIdEnter the correct vpa associated with the beneficiary_id.
404beneficiary_not_foundBeneficiary does not existEnter a valid beneficiary_id.

Authorizations

​
x-client-id
string
header
required

Client ID. You can find your app id in the Merchant Dashboard.

​
x-client-secret
string
header
required

Client secret key. You can find your secret in the Merchant Dashboard.

Headers

​
x-api-version
string
default:2024-01-01
required

It is the API version to be used. The accepted format is YYYY-MM-DD.

​
x-request-id
string

It is the request ID for the API call. This ID can be used to resolve tech realted issues. Communicate this in your tech related queries to Cashfree Payments.

​
x-cf-signature
string

Signature to be sent if IP is not whitelisted.

Body

application/json

Find the request parameters of the API request to transfer money to a beneficiary.

Standard Transfer V2

​
transfer_id
string
required

It is the unique ID you create to identify the transfer. You can use a maximum of 40 characters to create a transfer_id. Alphanumeric and underscore ( _ ) are allowed.

Maximum length: 40
​
transfer_amount
number
required

It is the transfer amount. Decimal values are allowed. The minimum value should be equal to or greater than 1.00. (>= 1.00)

​
beneficiary_details
object
required

It should contain the details of the beneficiary who receives the transfer amount.

​
transfer_currency
string

It is the currency of the transfer amount. The default value is INR.

​
transfer_mode
enum<string>

It is the mode of transfer. Allowed values are banktransfer, imps, neft, rtgs, upi, paytm, amazonpay, card. The default transfer_mode is banktransfer.

Available options:
banktransfer,
imps,
neft,
rtgs,
upi,
paytm,
amazonpay,
card,
cardupi
​
transfer_remarks
string

It can contain any additional remarks for the transfer. Alphanumeric and whitespaces are allowed. The maximum character limit is 70.

Maximum length: 70
​
fundsource_id
string

It is the ID of the fund source from which the transfer amount will be debited.

Response

OK

Standard Transfer V2 Response

​
transfer_id
string

It displays the unique ID you created to identify the transfer.

​
cf_transfer_id
string

It displays the unique ID created by Cashfree Payments. You receive this ID in the response after initiating the standard transfer request.

​
status
string

It displays the status of the transfer.

​
beneficiary_details
object

It displays the details of the beneficiary.

​
transfer_amount
number

It displays the transfer amount initiated in the request.

​
transfer_service_charge
number

It displays the service charge applicable for the successful transfer request.

​
transfer_service_tax
number

It displays the service tax applicable for the successful transfer request.

​
transfer_mode
string

It displays the mode of the transfer.

​
transfer_utr
string

It displays the unique number that is generated to recognise any fund transfer that is created by the bank that facilitates the transfer.

​
fundsource_id
string

It displays the ID of the fund source from where the money was debited for this transfer request.

​
added_on
string

It displays the time of when the transfer request was added to the system.

​
updated_on
string

It displays the updated time for the transfer.

⌘I