Failed Settlement Reasons

Review common Cashfree Easy Split settlement failure reasons such as KYC issues, beneficiary mismatches, and bank rejections, plus steps to resolve each error.

Reason	Category	Description
BANK_GATEWAY_ERROR	Bank	Technical error at the bank
BENE_BANK_DECLINED	Bank	Rejected by Beneficiary bank due to business reasons
FAILED	Bank	No explicit failure reason from the bank
INVALID_IFSC_FAIL	Customer	Invalid ifsc code provided for bank account
INVALID_ACCOUNT_FAIL	Customer	Bank account is invalid
RETURNED_FROM_BENEFICIARY	Bank	Immediate reversal from the beneficiary bank
INSUFFICIENT_BALANCE	Vendor	Merchant balance is exhausted, need to add funds
IMPS_MODE_FAIL	Bank	IMPS mode not supported for the beneficiary
RTGS_MODE_FAIL	Bank	RTGS mode not supported (only for RTGS)
REINITIALIZE_TRANSFER_LATER	Bank	Technical error at the bank, retry later
NRE_ACCOUNT_FAIL	Customer	Customer bank account is an NRE account
ACCOUNT_BLOCKED	Customer	Customer bank account is blocked
DEST_LIMIT_REACHED	Bank	Transfer limit to beneficiary exceeded
INVALID_MODE_FAIL	Bank	Transfer mode not valid for beneficiary
NPCI_UNAVAILABLE	Bank	NPCI is unavailable
BENEFICIARY_BANK_OFFLINE	Bank	Beneficiary bank is offline
INVALID_AMOUNT_FAIL	Vendor	Amount is invalid for the given transfer mode
SUSPECTED_TRANSFER	Customer	Suspicious transfer identified
BENE_NAME_DIFFERS	Customer	Beneficiary name not matching with bank records
DISABLED_MODE	Vendor	Transfer mode not enabled for the account
AMAZON_AMOUNT_EXCEED	Vendor	Amount should be less than 10000 for Amazon Pay mode
BENEFICIARY_BLACKLISTED	Vendor	Beneficiary is blacklisted
PAYOUT_INACTIVE	Vendor	Payout account is not active
INVALID_TRANSFER_AMOUNT	Vendor	Transfer amount is invalid
BENEFICIARY_NOT_EXIST	Vendor	Beneficiary does not exist
BENEFICIARY_INVALID_MODE	Vendor	Mode Not valid for Beneficiary
INVALID_BENE_ACCOUNT_OR_IFSC	Vendor	Invalid bank account number or ifsc provided
BENEFICIARY_NAME_DIFFERS	Customer	Beneficiary name not matching with bank records
ANY_OTHER_REASON	Bank	No reason provided for the failure/reversal
INVALID_OR_NO_SUCH_ACCOUNT_TYPE	Customer	Invalid account

---

Signature Verification

Use the signature to verify that the request has not been tampered with. To verify the signature, you need your Cashfree PG secret key and the payload.

Timestamp is present in the header: x-webhook-timestamp

timestamp := 1617695238078;

signedPayload := $timestamp.$payload;
expectedSignature := Base64Encode(HMACSHA256($signedPayload,$merchantSecretKey));