DELETE
/
beneficiary

Authorizations

x-client-id
string
headerrequired

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

x-client-secret
string
headerrequired

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

Headers

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

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.

Query Parameters

beneficiary_id
string

It is the unique ID you create to identify the beneficiary. The maximum character limit is 50. Only alphabets and whitespaces are allowed.

Maximum length: 50

Response

200 - application/json

Contains the information of the created beneficiary

beneficiary_id
string

It displays the unique Id you created to identify the beneficiary.

beneficiary_name
string

It displays the name of the beneficiary.

beneficiary_instrument_details
object

It displays the payment instrument details of the beneficiary.

beneficiary_contact_details
object

It displays the contact details of the beneficiary.

beneficiary_status
enum<string>

It displays the current status of the beneficiary. Possible values are as follows

  • VERIFIED: Beneficiary is verified and is available for payouts
  • INVALID: Beneficiary is invalid
  • INITIATED: Beneficiary verification initiated
  • CANCELLED: Beneficiary verification cancelled
  • FAILED: Failed to verify beneficiary
  • DELETED: Beneficiary is deleted
Available options:
VERIFIED,
INVALID,
INITIATED,
CANCELLED,
FAILED,
DELETED
added_on
string

It displays the time of the addition of the beneficiary in UTC.