Add Beneficiary

Use this API to add a beneficiary to your Cashfree account by providing the bank account number, IFSC, and other required details. Before you request a transfer, ensure the account has been successfully added as a beneficiary.

Response Codes

Sub CodeStatusMessage
200SUCCESSBeneficiary added successfully
403ERRORToken is not valid
403ERRORIP not whitelisted
409ERRORBeneficiary Id already exists
409ERROREntered bank Account is already registered
412ERRORToken missing in the request
412ERRORBeneficiary group is not an active group
412ERRORCannot add yourself as a beneficiary
422ERRORPlease provide a valid Beneficiary Id
422ERRORPlease provide a valid email
422ERRORPlease provide a valid name
422ERRORPlease provide a valid Phone Number
422ERRORPlease provide a valid Bank Account
422ERRORPlease provide a valid Bank IFSC code
422ERRORPlease provide a valid Virtual Payee Address
422ERRORPlease provide a valid Address
422ERRORPlease provide a valid City Name
422ERRORPlease provide a valid State Name
422ERRORPlease provide a valid Pin code
422ERRORCashfree VBA/VPA cannot be added as a beneficiary
422ERRORPlease provide a valid MasterCard or Visa card number
422ERRORPlease provide a masked card number of a valid MasterCard or Visa card
422ERRORInvalid details provided
520ERRORAdding beneficiary Failed

Note: If you are attempting to create a transfer in the Sandbox environment, you can obtain the test data details from this link.

Language