Beneficiary V2
Create Beneficiary V2
Click to view the response codes.
Click to view the response codes.
Get Beneficiary V2
Click to view the response codes.
Click to view the response codes.
Remove Beneficiary
Click to view the response codes.
Click to view the response codes.
Transfer V2
Standard Transfer V2
Click to view the response codes.
Click to view the response codes.
| 200 | REJECTED | TRANSFERID_INVALID | transferid 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). | 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. |
| 200 | REJECTED | AMOUNT_INVALID | amount can contain only numbers. After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be attempted. | After correcting the amount, you can reinitiate the transfer. | Yes, after correcting amount. |
| 200 | REJECTED | REMARKS_INVALID | remarks can contain only alphabets, numbers and space. | After correcting the remarks, you can reinitiate the transfer. | Yes, after correcting remarks. |
| 200 | REJECTED | BENEID_INVALID | beneId can contain only alphabets, numbers and underscore. | After correcting the beneId, you can reinitiate the transfer. | Yes, after correcting beneficiary id. |
| 200 | REJECTED | NAME_INVALID | name can contain only alphabets, numbers and space. | After correcting the name, you can reinitiate the transfer. | Yes, after correcting name. |
| 200 | REJECTED | EMAIL_INVALID | email is not a valid email format. | After correcting the email, you can reinitiate the transfer. | Yes, after correcting email. |
| 200 | REJECTED | IBAN_INVALID | iban can contain only alphabets and numbers. | After correcting the iban, you can reinitiate the transfer. | Yes, after correcting IBAN. |
| 200 | REJECTED | TRANSFERMODE_INVALID | transferMode invalid (allowed: banktransfer, upi, paytm, amazonpay, imps, neft, rtgs, ppc). | After correcting the transferMode, you can reinitiate the transfer. | Yes, after correcting mode. |
| 200 | REJECTED | CURRENCY_INVALID | currency is invalid. | After correcting the currency, you can reinitiate the transfer. | Yes, after correcting currency. |
| 200 | REJECTED | ACCOUNT_DOES_NOT_EXIST | The transfer has been rejected because the beneficiary account/ VPA does not exist as per our partner bank. After correcting the account number/ VPA, you can reinitiate the transfer. | After correcting the account number / VPA, reinitiate the transfer. | Yes, after correcting details. |
| 200 | FAILED | ACCOUNT_DOES_NOT_EXIST | The transfer has failed because the beneficiary account/ VPA does not exist as per our partner bank. After correcting the account number/ VPA, you can reinitiate the transfer. | After correcting the account number / VPA, reinitiate the transfer. | Yes, after correcting details. |
| 200 | REJECTED | AMAZON_AMOUNT_EXCEED | The amount entered breaches the limits set for the beneficiary’s Amazon account. | After verifying the limits, reinitiate the transfer. | Yes, after verifying limits. |
| 200 | FAILED | AMAZON_AMOUNT_EXCEED | The amount entered breaches the limits set for the beneficiary’s Amazon account. | After verifying the limits, reinitiate the transfer. | Yes, after verifying limits. |
| 200 | REJECTED | ANOMALY_DETECTION | The transfer has been rejected as risk product detected an anomaly. | Reinitiate after validation at your end. | Yes, after validation. |
| 200 | APPROVAL_PENDING | ANOMALY_DETECTION | The transfer requires approval as risk product detected an anomaly. | Approve / reject on dashboard (Payout Protect). | - |
| 200 | FAILED | BAD_CONNECTION | Intermittent internal error between Cashfree and partner bank. | Reinitiate the transfer. | Yes, after some time. |
| 200 | REJECTED | BENE_INVALID | Beneficiary in the request does not exist. | Add correct beneficiary then reinitiate. | Yes, after adding beneficiary. |
| 200 | FAILED | BENE_INVALID | Beneficiary in the request does not exist. | Add correct beneficiary then reinitiate. | Yes, after adding beneficiary. |
| 200 | FAILED | BENE_NOT_REGISTERED | Beneficiary not registered with partner bank. | Add correct beneficiary then reinitiate. | Yes, after adding beneficiary. |
| 200 | VALIDATION_PENDING| BENE_VERIFICATION_PENDING | Beneficiary verification pending; transfer will be attempted post validation. | Rely on Check Status API or webhooks. | - |
| 200 | FAILED | BENEFICIARY_BANK_UNAVAILABLE | Beneficiary bank offline. | Reinitiate after some time. | Yes, after some time. |
| 200 | FAILED | BENEFICIARY_NAME_DIFFERS | Beneficiary name differs per partner bank. | Add correct beneficiary then reinitiate. | Yes, after correcting name. |
| 200 | REJECTED | BENEFICIARY_NAME_DIFFERS | Beneficiary name differs per partner bank. | Add correct beneficiary then reinitiate. | Yes, after correcting name. |
| 200 | REJECTED | BENEFICIARY_NAME_MISMATCH | Beneficiary name differs per partner bank. | Add correct beneficiary then reinitiate. | Yes, after correcting name. |
| 200 | REJECTED | CARD_UNSUPPORTED | Card not supported. | Change payment instrument then reinitiate. | Yes, after changing instrument. |
| 200 | FAILED | CARD_UNSUPPORTED | Card not supported. | Change payment instrument then reinitiate. | Yes, after changing instrument. |
| 200 | FAILED | DUPLICATE_FAILED | Bank claims duplicate request. | Reinitiate with different transfer id. | Yes, with new id. |
| 200 | FAILED | ERROR_RETRIEVING_BALANCE | Intermittent issue at partner bank retrieving balance. | Reinitiate after some time. | Yes, after some time. |
| 200 | REJECTED | INVALID_CARD | Card details not correct. | Enter correct card details then reinitiate. | Yes, after correcting card. |
| 200 | FAILED | INVALID_CARD | Card details not correct. | Enter correct card details then reinitiate. | Yes, after correcting card. |
| 200 | REJECTED | INVALID_CURRENCY_FOR_PYID | Transfer currency not supported for payment instrument id. | Change currency to INR and reinitiate. | Yes, after changing currency. |
| 200 | FAILED | INVALID_CURRENCY_FOR_PYID | Transfer currency not supported for payment instrument id. | Change currency to INR and reinitiate. | Yes, after changing currency. |
| 200 | FAILED | INVALID_MODE_FAIL | Transfer mode not supported for beneficiary account. | Change mode then reinitiate. | Yes, after changing mode. |
| 200 | REJECTED | INVALID_OR_NO_SUCH_ACCOUNT_TYPE | Beneficiary account type invalid / unsupported. | Get new account from beneficiary then reinitiate. | Yes, after new account. |
| 200 | FAILED | INVALID_OR_NO_SUCH_ACCOUNT_TYPE | Beneficiary account type invalid / unsupported. | Get new account from beneficiary then reinitiate. | Yes, after new account. |
| 200 | FAILED | INVALID_PHONE_BENEFICIARY | Phone number not linked to any VPA. | Add correct phone beneficiary then reinitiate. | Yes, after correcting phone. |
| 200 | REJECTED | INVALID_TRANSFER_CURRENCY | Transfer currency not supported. | Change currency to INR then reinitiate. | Yes, after changing currency. |
| 200 | FAILED | INVALID_TRANSFER_CURRENCY | Transfer currency not supported. | Change currency to INR then reinitiate. | Yes, after changing currency. |
| 200 | REJECTED | KYC_COMPLIANCE_VERIFICATION_FAILED | KYC verification failed. | Reinitiate after resolving KYC. | Yes, after KYC resolution. |
| 200 | REJECTED | KYC_REQUIREMENTS_NOT_SATISFIED | KYC requirements not satisfied. | Complete KYC then reinitiate. | Yes, after completing KYC. |
| 200 | FAILED | LOAD_LIMIT_EXHAUSTED | Beneficiary account reached max transaction amount limit. | Reinitiate after 24 hours. | Yes, after 24 hours. |
| 200 | FAILED | LOAN_FUND_MOVEMENT_FAILURE | Intermittent issue at Cashfree. | Reinitiate transfer. | Yes, after some time. |
| 200 | PENDING | LOW_BALANCE_QUEUED | Balance in the fund source is exhausted; will auto process post recharge. | Recharge fund source; rely on status API/webhook. | - |
| 200 | REJECTED | MANUALLY_REJECTED | Transfer manually rejected by you. | Reinitiate if required. | Yes, if needed. |
| 200 | REJECTED | PAYOUT_INACTIVE | Payout account inactive. | Activate account then reinitiate. | Yes, after activation. |
| 200 | FAILED | POOL_CONNECTION_TIMEOUT | Connection issue with partner bank. | Reinitiate after some time. | Yes, after some time. |
| 200 | REJECTED | QUICK_TRANSFER_DISABLED | Quick transfer disabled for payout account. | Enable quick transfer then reinitiate. | Yes, after enabling. |
| 200 | REJECTED | REJECTED | Transfer rejected (generic). | Review request and correct issues. | Yes, after correction. |
| 200 | REVERSED | REVERSED | Transfer reversed by beneficiary bank; credit failed. | Reinitiate after correcting issue. | Yes, after correction. |
| 200 | FAILED | RTGS_MODE_FAIL | Beneficiary account does not support RTGS transfers. | Try NEFT or other channels. | Yes, via different mode. |
| 200 | FAILED | SUSPECTED_FAILED | Partner bank suspects transfer is fraudulent. | Contact support / investigate before retry. | No (investigate). |
| 200 | REJECTED | VBA_TRANSFER_DISABLED | Transfers to virtual bank accounts not enabled. | Enable payouts to VBAs then reinitiate. | Yes, after enabling. |
| 200 | REJECTED | ERROR_SELECTING_FUND_SOURCE | Issue with account configuration selecting fund source. | Contact care team; fix config then reinitiate. | Yes, after fixing config. |
| 200 | VALIDATION_PENDING| VALIDATION_PENDING | Beneficiary verification pending; transfer will be attempted post validation. | Rely on Status API / webhooks. | - |
| 200 | REJECTED | INVALID_BENEFICIARY_CODE | Beneficiary code invalid. | Correct beneficiary code then reinitiate. | Yes, after correcting code. |
| 200 | REJECTED | DUPLICATE_TRANSFER | Transfer already present / processed; duplicate transferId. | Change transferId and reinitiate. | Yes, with new transfer id. |
4XX errors
Get Transfer Status V2
Click to view the response codes.
Click to view the response codes.
| 200 | REJECTED | TRANSFERID_INVALID | transferid 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). | 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. |
| 200 | REJECTED | AMOUNT_INVALID | amount can contain only numbers. After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be attempted. | After correcting the amount, you can reinitiate the transfer. | Yes, after correcting amount. |
| 200 | REJECTED | REMARKS_INVALID | remarks can contain only alphabets, numbers and space. | After correcting the remarks, you can reinitiate the transfer. | Yes, after correcting remarks. |
| 200 | REJECTED | BENEID_INVALID | beneId can contain only alphabets, numbers and underscore. | After correcting the beneId, you can reinitiate the transfer. | Yes, after correcting beneficiary id. |
| 200 | REJECTED | NAME_INVALID | name can contain only alphabets, numbers and space. | After correcting the name, you can reinitiate the transfer. | Yes, after correcting name. |
| 200 | REJECTED | EMAIL_INVALID | email is not a valid email format. | After correcting the email, you can reinitiate the transfer. | Yes, after correcting email. |
| 200 | REJECTED | IBAN_INVALID | iban can contain only alphabets and numbers. | After correcting the iban, you can reinitiate the transfer. | Yes, after correcting IBAN. |
| 200 | REJECTED | TRANSFERMODE_INVALID | transferMode invalid (allowed: banktransfer, upi, paytm, amazonpay, imps, neft, rtgs, ppc). | After correcting the transferMode, you can reinitiate the transfer. | Yes, after correcting mode. |
| 200 | REJECTED | CURRENCY_INVALID | currency is invalid. | After correcting the currency, you can reinitiate the transfer. | Yes, after correcting currency. |
| 200 | REJECTED | ACCOUNT_DOES_NOT_EXIST | The transfer has been rejected because the beneficiary account/ VPA does not exist as per our partner bank. After correcting the account number/ VPA, you can reinitiate the transfer. | After correcting the account number / VPA, reinitiate the transfer. | Yes, after correcting details. |
| 200 | FAILED | ACCOUNT_DOES_NOT_EXIST | The transfer has failed because the beneficiary account/ VPA does not exist as per our partner bank. After correcting the account number/ VPA, you can reinitiate the transfer. | After correcting the account number / VPA, reinitiate the transfer. | Yes, after correcting details. |
| 200 | REJECTED | AMAZON_AMOUNT_EXCEED | The amount entered breaches the limits set for the beneficiary’s Amazon account. | After verifying the limits, reinitiate the transfer. | Yes, after verifying limits. |
| 200 | FAILED | AMAZON_AMOUNT_EXCEED | The amount entered breaches the limits set for the beneficiary’s Amazon account. | After verifying the limits, reinitiate the transfer. | Yes, after verifying limits. |
| 200 | REJECTED | ANOMALY_DETECTION | The transfer has been rejected as risk product detected an anomaly. | Reinitiate after validation at your end. | Yes, after validation. |
| 200 | APPROVAL_PENDING | ANOMALY_DETECTION | The transfer requires approval as risk product detected an anomaly. | Approve / reject on dashboard (Payout Protect). | - |
| 200 | FAILED | BAD_CONNECTION | Intermittent internal error between Cashfree and partner bank. | Reinitiate the transfer. | Yes, after some time. |
| 200 | REJECTED | BENE_INVALID | Beneficiary in the request does not exist. | Add correct beneficiary then reinitiate. | Yes, after adding beneficiary. |
| 200 | FAILED | BENE_INVALID | Beneficiary in the request does not exist. | Add correct beneficiary then reinitiate. | Yes, after adding beneficiary. |
| 200 | FAILED | BENE_NOT_REGISTERED | Beneficiary not registered with partner bank. | Add correct beneficiary then reinitiate. | Yes, after adding beneficiary. |
| 200 | VALIDATION_PENDING| BENE_VERIFICATION_PENDING | Beneficiary verification pending; transfer will be attempted post validation. | Rely on Check Status API or webhooks. | - |
| 200 | FAILED | BENEFICIARY_BANK_UNAVAILABLE | Beneficiary bank offline. | Reinitiate after some time. | Yes, after some time. |
| 200 | FAILED | BENEFICIARY_NAME_DIFFERS | Beneficiary name differs per partner bank. | Add correct beneficiary then reinitiate. | Yes, after correcting name. |
| 200 | REJECTED | BENEFICIARY_NAME_DIFFERS | Beneficiary name differs per partner bank. | Add correct beneficiary then reinitiate. | Yes, after correcting name. |
| 200 | REJECTED | BENEFICIARY_NAME_MISMATCH | Beneficiary name differs per partner bank. | Add correct beneficiary then reinitiate. | Yes, after correcting name. |
| 200 | REJECTED | CARD_UNSUPPORTED | Card not supported. | Change payment instrument then reinitiate. | Yes, after changing instrument. |
| 200 | FAILED | CARD_UNSUPPORTED | Card not supported. | Change payment instrument then reinitiate. | Yes, after changing instrument. |
| 200 | FAILED | DUPLICATE_FAILED | Bank claims duplicate request. | Reinitiate with different transfer id. | Yes, with new id. |
| 200 | FAILED | ERROR_RETRIEVING_BALANCE | Intermittent issue at partner bank retrieving balance. | Reinitiate after some time. | Yes, after some time. |
| 200 | REJECTED | INVALID_CARD | Card details not correct. | Enter correct card details then reinitiate. | Yes, after correcting card. |
| 200 | FAILED | INVALID_CARD | Card details not correct. | Enter correct card details then reinitiate. | Yes, after correcting card. |
| 200 | REJECTED | INVALID_CURRENCY_FOR_PYID | Transfer currency not supported for payment instrument id. | Change currency to INR and reinitiate. | Yes, after changing currency. |
| 200 | FAILED | INVALID_CURRENCY_FOR_PYID | Transfer currency not supported for payment instrument id. | Change currency to INR and reinitiate. | Yes, after changing currency. |
| 200 | FAILED | INVALID_MODE_FAIL | Transfer mode not supported for beneficiary account. | Change mode then reinitiate. | Yes, after changing mode. |
| 200 | REJECTED | INVALID_OR_NO_SUCH_ACCOUNT_TYPE | Beneficiary account type invalid / unsupported. | Get new account from beneficiary then reinitiate. | Yes, after new account. |
| 200 | FAILED | INVALID_OR_NO_SUCH_ACCOUNT_TYPE | Beneficiary account type invalid / unsupported. | Get new account from beneficiary then reinitiate. | Yes, after new account. |
| 200 | FAILED | INVALID_PHONE_BENEFICIARY | Phone number not linked to any VPA. | Add correct phone beneficiary then reinitiate. | Yes, after correcting phone. |
| 200 | REJECTED | INVALID_TRANSFER_CURRENCY | Transfer currency not supported. | Change currency to INR then reinitiate. | Yes, after changing currency. |
| 200 | FAILED | INVALID_TRANSFER_CURRENCY | Transfer currency not supported. | Change currency to INR then reinitiate. | Yes, after changing currency. |
| 200 | REJECTED | KYC_COMPLIANCE_VERIFICATION_FAILED | KYC verification failed. | Reinitiate after resolving KYC. | Yes, after KYC resolution. |
| 200 | REJECTED | KYC_REQUIREMENTS_NOT_SATISFIED | KYC requirements not satisfied. | Complete KYC then reinitiate. | Yes, after completing KYC. |
| 200 | FAILED | LOAD_LIMIT_EXHAUSTED | Beneficiary account reached max transaction amount limit. | Reinitiate after 24 hours. | Yes, after 24 hours. |
| 200 | FAILED | LOAN_FUND_MOVEMENT_FAILURE | Intermittent issue at Cashfree. | Reinitiate transfer. | Yes, after some time. |
| 200 | PENDING | LOW_BALANCE_QUEUED | Balance in the fund source is exhausted; will auto process post recharge. | Recharge fund source; rely on status API/webhook. | - |
| 200 | REJECTED | MANUALLY_REJECTED | Transfer manually rejected by you. | Reinitiate if required. | Yes, if needed. |
| 200 | REJECTED | PAYOUT_INACTIVE | Payout account inactive. | Activate account then reinitiate. | Yes, after activation. |
| 200 | FAILED | POOL_CONNECTION_TIMEOUT | Connection issue with partner bank. | Reinitiate after some time. | Yes, after some time. |
| 200 | REJECTED | QUICK_TRANSFER_DISABLED | Quick transfer disabled for payout account. | Enable quick transfer then reinitiate. | Yes, after enabling. |
| 200 | REJECTED | REJECTED | Transfer rejected (generic). | Review request and correct issues. | Yes, after correction. |
| 200 | REVERSED | REVERSED | Transfer reversed by beneficiary bank; credit failed. | Reinitiate after correcting issue. | Yes, after correction. |
| 200 | FAILED | RTGS_MODE_FAIL | Beneficiary account does not support RTGS transfers. | Try NEFT or other channels. | Yes, via different mode. |
| 200 | FAILED | SUSPECTED_FAILED | Partner bank suspects transfer is fraudulent. | Contact support / investigate before retry. | No (investigate). |
| 200 | REJECTED | VBA_TRANSFER_DISABLED | Transfers to virtual bank accounts not enabled. | Enable payouts to VBAs then reinitiate. | Yes, after enabling. |
| 200 | REJECTED | ERROR_SELECTING_FUND_SOURCE | Issue with account configuration selecting fund source. | Contact care team; fix config then reinitiate. | Yes, after fixing config. |
| 200 | VALIDATION_PENDING| VALIDATION_PENDING | Beneficiary verification pending; transfer will be attempted post validation. | Rely on Status API / webhooks. | - |
| 200 | REJECTED | INVALID_BENEFICIARY_CODE | Beneficiary code invalid. | Correct beneficiary code then reinitiate. | Yes, after correcting code. |
| 200 | REJECTED | DUPLICATE_TRANSFER | Transfer already present / processed; duplicate transferId. | Change transferId and reinitiate. | Yes, with new transfer id. |
4XX errors
Batch Transfer V2
Click to view the response codes.
Click to view the response codes.
| 200 | REJECTED | TRANSFERID_INVALID | transferid 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). | 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. |
| 200 | REJECTED | AMOUNT_INVALID | amount can contain only numbers. After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be attempted. | After correcting the amount, you can reinitiate the transfer. | Yes, after correcting amount. |
| 200 | REJECTED | REMARKS_INVALID | remarks can contain only alphabets, numbers and space. | After correcting the remarks, you can reinitiate the transfer. | Yes, after correcting remarks. |
| 200 | REJECTED | BENEID_INVALID | beneId can contain only alphabets, numbers and underscore. | After correcting the beneId, you can reinitiate the transfer. | Yes, after correcting beneficiary id. |
| 200 | REJECTED | NAME_INVALID | name can contain only alphabets, numbers and space. | After correcting the name, you can reinitiate the transfer. | Yes, after correcting name. |
| 200 | REJECTED | EMAIL_INVALID | email is not a valid email format. | After correcting the email, you can reinitiate the transfer. | Yes, after correcting email. |
| 200 | REJECTED | IBAN_INVALID | iban can contain only alphabets and numbers. | After correcting the iban, you can reinitiate the transfer. | Yes, after correcting IBAN. |
| 200 | REJECTED | TRANSFERMODE_INVALID | transferMode invalid (allowed: banktransfer, upi, paytm, amazonpay, imps, neft, rtgs, ppc). | After correcting the transferMode, you can reinitiate the transfer. | Yes, after correcting mode. |
| 200 | REJECTED | CURRENCY_INVALID | currency is invalid. | After correcting the currency, you can reinitiate the transfer. | Yes, after correcting currency. |
| 200 | REJECTED | ACCOUNT_DOES_NOT_EXIST | The transfer has been rejected because the beneficiary account/ VPA does not exist as per our partner bank. After correcting the account number/ VPA, you can reinitiate the transfer. | After correcting the account number / VPA, reinitiate the transfer. | Yes, after correcting details. |
| 200 | FAILED | ACCOUNT_DOES_NOT_EXIST | The transfer has failed because the beneficiary account/ VPA does not exist as per our partner bank. After correcting the account number/ VPA, you can reinitiate the transfer. | After correcting the account number / VPA, reinitiate the transfer. | Yes, after correcting details. |
| 200 | REJECTED | AMAZON_AMOUNT_EXCEED | The amount entered breaches the limits set for the beneficiary’s Amazon account. | After verifying the limits, reinitiate the transfer. | Yes, after verifying limits. |
| 200 | FAILED | AMAZON_AMOUNT_EXCEED | The amount entered breaches the limits set for the beneficiary’s Amazon account. | After verifying the limits, reinitiate the transfer. | Yes, after verifying limits. |
| 200 | REJECTED | ANOMALY_DETECTION | The transfer has been rejected as risk product detected an anomaly. | Reinitiate after validation at your end. | Yes, after validation. |
| 200 | APPROVAL_PENDING | ANOMALY_DETECTION | The transfer requires approval as risk product detected an anomaly. | Approve / reject on dashboard (Payout Protect). | - |
| 200 | FAILED | BAD_CONNECTION | Intermittent internal error between Cashfree and partner bank. | Reinitiate the transfer. | Yes, after some time. |
| 200 | REJECTED | BENE_INVALID | Beneficiary in the request does not exist. | Add correct beneficiary then reinitiate. | Yes, after adding beneficiary. |
| 200 | FAILED | BENE_INVALID | Beneficiary in the request does not exist. | Add correct beneficiary then reinitiate. | Yes, after adding beneficiary. |
| 200 | FAILED | BENE_NOT_REGISTERED | Beneficiary not registered with partner bank. | Add correct beneficiary then reinitiate. | Yes, after adding beneficiary. |
| 200 | VALIDATION_PENDING| BENE_VERIFICATION_PENDING | Beneficiary verification pending; transfer will be attempted post validation. | Rely on Check Status API or webhooks. | - |
| 200 | FAILED | BENEFICIARY_BANK_UNAVAILABLE | Beneficiary bank offline. | Reinitiate after some time. | Yes, after some time. |
| 200 | FAILED | BENEFICIARY_NAME_DIFFERS | Beneficiary name differs per partner bank. | Add correct beneficiary then reinitiate. | Yes, after correcting name. |
| 200 | REJECTED | BENEFICIARY_NAME_DIFFERS | Beneficiary name differs per partner bank. | Add correct beneficiary then reinitiate. | Yes, after correcting name. |
| 200 | REJECTED | BENEFICIARY_NAME_MISMATCH | Beneficiary name differs per partner bank. | Add correct beneficiary then reinitiate. | Yes, after correcting name. |
| 200 | REJECTED | CARD_UNSUPPORTED | Card not supported. | Change payment instrument then reinitiate. | Yes, after changing instrument. |
| 200 | FAILED | CARD_UNSUPPORTED | Card not supported. | Change payment instrument then reinitiate. | Yes, after changing instrument. |
| 200 | FAILED | DUPLICATE_FAILED | Bank claims duplicate request. | Reinitiate with different transfer id. | Yes, with new id. |
| 200 | FAILED | ERROR_RETRIEVING_BALANCE | Intermittent issue at partner bank retrieving balance. | Reinitiate after some time. | Yes, after some time. |
| 200 | REJECTED | INVALID_CARD | Card details not correct. | Enter correct card details then reinitiate. | Yes, after correcting card. |
| 200 | FAILED | INVALID_CARD | Card details not correct. | Enter correct card details then reinitiate. | Yes, after correcting card. |
| 200 | REJECTED | INVALID_CURRENCY_FOR_PYID | Transfer currency not supported for payment instrument id. | Change currency to INR and reinitiate. | Yes, after changing currency. |
| 200 | FAILED | INVALID_CURRENCY_FOR_PYID | Transfer currency not supported for payment instrument id. | Change currency to INR and reinitiate. | Yes, after changing currency. |
| 200 | FAILED | INVALID_MODE_FAIL | Transfer mode not supported for beneficiary account. | Change mode then reinitiate. | Yes, after changing mode. |
| 200 | REJECTED | INVALID_OR_NO_SUCH_ACCOUNT_TYPE | Beneficiary account type invalid / unsupported. | Get new account from beneficiary then reinitiate. | Yes, after new account. |
| 200 | FAILED | INVALID_OR_NO_SUCH_ACCOUNT_TYPE | Beneficiary account type invalid / unsupported. | Get new account from beneficiary then reinitiate. | Yes, after new account. |
| 200 | FAILED | INVALID_PHONE_BENEFICIARY | Phone number not linked to any VPA. | Add correct phone beneficiary then reinitiate. | Yes, after correcting phone. |
| 200 | REJECTED | INVALID_TRANSFER_CURRENCY | Transfer currency not supported. | Change currency to INR then reinitiate. | Yes, after changing currency. |
| 200 | FAILED | INVALID_TRANSFER_CURRENCY | Transfer currency not supported. | Change currency to INR then reinitiate. | Yes, after changing currency. |
| 200 | REJECTED | KYC_COMPLIANCE_VERIFICATION_FAILED | KYC verification failed. | Reinitiate after resolving KYC. | Yes, after KYC resolution. |
| 200 | REJECTED | KYC_REQUIREMENTS_NOT_SATISFIED | KYC requirements not satisfied. | Complete KYC then reinitiate. | Yes, after completing KYC. |
| 200 | FAILED | LOAD_LIMIT_EXHAUSTED | Beneficiary account reached max transaction amount limit. | Reinitiate after 24 hours. | Yes, after 24 hours. |
| 200 | FAILED | LOAN_FUND_MOVEMENT_FAILURE | Intermittent issue at Cashfree. | Reinitiate transfer. | Yes, after some time. |
| 200 | PENDING | LOW_BALANCE_QUEUED | Balance in the fund source is exhausted; will auto process post recharge. | Recharge fund source; rely on status API/webhook. | - |
| 200 | REJECTED | MANUALLY_REJECTED | Transfer manually rejected by you. | Reinitiate if required. | Yes, if needed. |
| 200 | REJECTED | PAYOUT_INACTIVE | Payout account inactive. | Activate account then reinitiate. | Yes, after activation. |
| 200 | FAILED | POOL_CONNECTION_TIMEOUT | Connection issue with partner bank. | Reinitiate after some time. | Yes, after some time. |
| 200 | REJECTED | QUICK_TRANSFER_DISABLED | Quick transfer disabled for payout account. | Enable quick transfer then reinitiate. | Yes, after enabling. |
| 200 | REJECTED | REJECTED | Transfer rejected (generic). | Review request and correct issues. | Yes, after correction. |
| 200 | REVERSED | REVERSED | Transfer reversed by beneficiary bank; credit failed. | Reinitiate after correcting issue. | Yes, after correction. |
| 200 | FAILED | RTGS_MODE_FAIL | Beneficiary account does not support RTGS transfers. | Try NEFT or other channels. | Yes, via different mode. |
| 200 | FAILED | SUSPECTED_FAILED | Partner bank suspects transfer is fraudulent. | Contact support / investigate before retry. | No (investigate). |
| 200 | REJECTED | VBA_TRANSFER_DISABLED | Transfers to virtual bank accounts not enabled. | Enable payouts to VBAs then reinitiate. | Yes, after enabling. |
| 200 | REJECTED | ERROR_SELECTING_FUND_SOURCE | Issue with account configuration selecting fund source. | Contact care team; fix config then reinitiate. | Yes, after fixing config. |
| 200 | VALIDATION_PENDING| VALIDATION_PENDING | Beneficiary verification pending; transfer will be attempted post validation. | Rely on Status API / webhooks. | - |
| 200 | REJECTED | INVALID_BENEFICIARY_CODE | Beneficiary code invalid. | Correct beneficiary code then reinitiate. | Yes, after correcting code. |
| 200 | REJECTED | DUPLICATE_TRANSFER | Transfer already present / processed; duplicate transferId. | Change transferId and reinitiate. | Yes, with new transfer id. |
4XX errors
Get Batch Transfer Status V2
Click to view the response codes.
Click to view the response codes.
| 200 | REJECTED | TRANSFERID_INVALID | transferid 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). | 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. |
| 200 | REJECTED | AMOUNT_INVALID | amount can contain only numbers. After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be attempted. | After correcting the amount, you can reinitiate the transfer. | Yes, after correcting amount. |
| 200 | REJECTED | REMARKS_INVALID | remarks can contain only alphabets, numbers and space. | After correcting the remarks, you can reinitiate the transfer. | Yes, after correcting remarks. |
| 200 | REJECTED | BENEID_INVALID | beneId can contain only alphabets, numbers and underscore. | After correcting the beneId, you can reinitiate the transfer. | Yes, after correcting beneficiary id. |
| 200 | REJECTED | NAME_INVALID | name can contain only alphabets, numbers and space. | After correcting the name, you can reinitiate the transfer. | Yes, after correcting name. |
| 200 | REJECTED | EMAIL_INVALID | email is not a valid email format. | After correcting the email, you can reinitiate the transfer. | Yes, after correcting email. |
| 200 | REJECTED | IBAN_INVALID | iban can contain only alphabets and numbers. | After correcting the iban, you can reinitiate the transfer. | Yes, after correcting IBAN. |
| 200 | REJECTED | TRANSFERMODE_INVALID | transferMode invalid (allowed: banktransfer, upi, paytm, amazonpay, imps, neft, rtgs, ppc). | After correcting the transferMode, you can reinitiate the transfer. | Yes, after correcting mode. |
| 200 | REJECTED | CURRENCY_INVALID | currency is invalid. | After correcting the currency, you can reinitiate the transfer. | Yes, after correcting currency. |
| 200 | REJECTED | ACCOUNT_DOES_NOT_EXIST | The transfer has been rejected because the beneficiary account/ VPA does not exist as per our partner bank. After correcting the account number/ VPA, you can reinitiate the transfer. | After correcting the account number / VPA, reinitiate the transfer. | Yes, after correcting details. |
| 200 | FAILED | ACCOUNT_DOES_NOT_EXIST | The transfer has failed because the beneficiary account/ VPA does not exist as per our partner bank. After correcting the account number/ VPA, you can reinitiate the transfer. | After correcting the account number / VPA, reinitiate the transfer. | Yes, after correcting details. |
| 200 | REJECTED | AMAZON_AMOUNT_EXCEED | The amount entered breaches the limits set for the beneficiary’s Amazon account. | After verifying the limits, reinitiate the transfer. | Yes, after verifying limits. |
| 200 | FAILED | AMAZON_AMOUNT_EXCEED | The amount entered breaches the limits set for the beneficiary’s Amazon account. | After verifying the limits, reinitiate the transfer. | Yes, after verifying limits. |
| 200 | REJECTED | ANOMALY_DETECTION | The transfer has been rejected as risk product detected an anomaly. | Reinitiate after validation at your end. | Yes, after validation. |
| 200 | APPROVAL_PENDING | ANOMALY_DETECTION | The transfer requires approval as risk product detected an anomaly. | Approve / reject on dashboard (Payout Protect). | - |
| 200 | FAILED | BAD_CONNECTION | Intermittent internal error between Cashfree and partner bank. | Reinitiate the transfer. | Yes, after some time. |
| 200 | REJECTED | BENE_INVALID | Beneficiary in the request does not exist. | Add correct beneficiary then reinitiate. | Yes, after adding beneficiary. |
| 200 | FAILED | BENE_INVALID | Beneficiary in the request does not exist. | Add correct beneficiary then reinitiate. | Yes, after adding beneficiary. |
| 200 | FAILED | BENE_NOT_REGISTERED | Beneficiary not registered with partner bank. | Add correct beneficiary then reinitiate. | Yes, after adding beneficiary. |
| 200 | VALIDATION_PENDING| BENE_VERIFICATION_PENDING | Beneficiary verification pending; transfer will be attempted post validation. | Rely on Check Status API or webhooks. | - |
| 200 | FAILED | BENEFICIARY_BANK_UNAVAILABLE | Beneficiary bank offline. | Reinitiate after some time. | Yes, after some time. |
| 200 | FAILED | BENEFICIARY_NAME_DIFFERS | Beneficiary name differs per partner bank. | Add correct beneficiary then reinitiate. | Yes, after correcting name. |
| 200 | REJECTED | BENEFICIARY_NAME_DIFFERS | Beneficiary name differs per partner bank. | Add correct beneficiary then reinitiate. | Yes, after correcting name. |
| 200 | REJECTED | BENEFICIARY_NAME_MISMATCH | Beneficiary name differs per partner bank. | Add correct beneficiary then reinitiate. | Yes, after correcting name. |
| 200 | REJECTED | CARD_UNSUPPORTED | Card not supported. | Change payment instrument then reinitiate. | Yes, after changing instrument. |
| 200 | FAILED | CARD_UNSUPPORTED | Card not supported. | Change payment instrument then reinitiate. | Yes, after changing instrument. |
| 200 | FAILED | DUPLICATE_FAILED | Bank claims duplicate request. | Reinitiate with different transfer id. | Yes, with new id. |
| 200 | FAILED | ERROR_RETRIEVING_BALANCE | Intermittent issue at partner bank retrieving balance. | Reinitiate after some time. | Yes, after some time. |
| 200 | REJECTED | INVALID_CARD | Card details not correct. | Enter correct card details then reinitiate. | Yes, after correcting card. |
| 200 | FAILED | INVALID_CARD | Card details not correct. | Enter correct card details then reinitiate. | Yes, after correcting card. |
| 200 | REJECTED | INVALID_CURRENCY_FOR_PYID | Transfer currency not supported for payment instrument id. | Change currency to INR and reinitiate. | Yes, after changing currency. |
| 200 | FAILED | INVALID_CURRENCY_FOR_PYID | Transfer currency not supported for payment instrument id. | Change currency to INR and reinitiate. | Yes, after changing currency. |
| 200 | FAILED | INVALID_MODE_FAIL | Transfer mode not supported for beneficiary account. | Change mode then reinitiate. | Yes, after changing mode. |
| 200 | REJECTED | INVALID_OR_NO_SUCH_ACCOUNT_TYPE | Beneficiary account type invalid / unsupported. | Get new account from beneficiary then reinitiate. | Yes, after new account. |
| 200 | FAILED | INVALID_OR_NO_SUCH_ACCOUNT_TYPE | Beneficiary account type invalid / unsupported. | Get new account from beneficiary then reinitiate. | Yes, after new account. |
| 200 | FAILED | INVALID_PHONE_BENEFICIARY | Phone number not linked to any VPA. | Add correct phone beneficiary then reinitiate. | Yes, after correcting phone. |
| 200 | REJECTED | INVALID_TRANSFER_CURRENCY | Transfer currency not supported. | Change currency to INR then reinitiate. | Yes, after changing currency. |
| 200 | FAILED | INVALID_TRANSFER_CURRENCY | Transfer currency not supported. | Change currency to INR then reinitiate. | Yes, after changing currency. |
| 200 | REJECTED | KYC_COMPLIANCE_VERIFICATION_FAILED | KYC verification failed. | Reinitiate after resolving KYC. | Yes, after KYC resolution. |
| 200 | REJECTED | KYC_REQUIREMENTS_NOT_SATISFIED | KYC requirements not satisfied. | Complete KYC then reinitiate. | Yes, after completing KYC. |
| 200 | FAILED | LOAD_LIMIT_EXHAUSTED | Beneficiary account reached max transaction amount limit. | Reinitiate after 24 hours. | Yes, after 24 hours. |
| 200 | FAILED | LOAN_FUND_MOVEMENT_FAILURE | Intermittent issue at Cashfree. | Reinitiate transfer. | Yes, after some time. |
| 200 | PENDING | LOW_BALANCE_QUEUED | Balance in the fund source is exhausted; will auto process post recharge. | Recharge fund source; rely on status API/webhook. | - |
| 200 | REJECTED | MANUALLY_REJECTED | Transfer manually rejected by you. | Reinitiate if required. | Yes, if needed. |
| 200 | REJECTED | PAYOUT_INACTIVE | Payout account inactive. | Activate account then reinitiate. | Yes, after activation. |
| 200 | FAILED | POOL_CONNECTION_TIMEOUT | Connection issue with partner bank. | Reinitiate after some time. | Yes, after some time. |
| 200 | REJECTED | QUICK_TRANSFER_DISABLED | Quick transfer disabled for payout account. | Enable quick transfer then reinitiate. | Yes, after enabling. |
| 200 | REJECTED | REJECTED | Transfer rejected (generic). | Review request and correct issues. | Yes, after correction. |
| 200 | REVERSED | REVERSED | Transfer reversed by beneficiary bank; credit failed. | Reinitiate after correcting issue. | Yes, after correction. |
| 200 | FAILED | RTGS_MODE_FAIL | Beneficiary account does not support RTGS transfers. | Try NEFT or other channels. | Yes, via different mode. |
| 200 | FAILED | SUSPECTED_FAILED | Partner bank suspects transfer is fraudulent. | Contact support / investigate before retry. | No (investigate). |
| 200 | REJECTED | VBA_TRANSFER_DISABLED | Transfers to virtual bank accounts not enabled. | Enable payouts to VBAs then reinitiate. | Yes, after enabling. |
| 200 | REJECTED | ERROR_SELECTING_FUND_SOURCE | Issue with account configuration selecting fund source. | Contact care team; fix config then reinitiate. | Yes, after fixing config. |
| 200 | VALIDATION_PENDING| VALIDATION_PENDING | Beneficiary verification pending; transfer will be attempted post validation. | Rely on Status API / webhooks. | - |
| 200 | REJECTED | INVALID_BENEFICIARY_CODE | Beneficiary code invalid. | Correct beneficiary code then reinitiate. | Yes, after correcting code. |
| 200 | REJECTED | DUPLICATE_TRANSFER | Transfer already present / processed; duplicate transferId. | Change transferId and reinitiate. | Yes, with new transfer id. |