Manage Beneficiaries (To be deprecated)

post https://in.staging.decentro.tech/core_banking/money_transfer/manage_beneficiaries

🙌
Important Note
Please use only Staging Credentials on each API Reference page to test the APIs directly from our Documentation.

API Endpoints

Environment	Endpoint
Staging / Sandbox	https://in.staging.decentro.tech/core_banking/money_transfer/manage_beneficiaries
Production	https://in.decentro.tech/core_banking/money_transfer/manage_beneficiaries

Add / Update / Disable any beneficiary for sending money from the virtual account (on top of the underlying physical bank account)

Body Params

action

string

required

Can be ADD/ VERIFY/ UPDATE/ DEACTIVATE/ DELETE

ifsc_code

string

required

Beneficiary bank IFSC code

sender_account_number

string

Account number against which the beneficiary is to be added. If not passed, beneficiary will be added to company's virtual account

account_number

string

required

Beneficiary account number

beneficiary_code

string

required

Unique code assigned by you to the beneficiary. Mandatory only if action is not ADD

transfer_type

string

required

Can be NEFT/ IMPS/ RTGS/ OTHR (for the beneficiary to support all incoming transfer types). If not specified for the ADD action, defaulted to OTHR. Optional only if action is ADD

currency_code

string

required

A valid currency code value such as INR

name

string

Beneficiary name to be added, Alphanumeric characters are allowed but special characters such as “@ # $ % ^ & * ! ; : ~ ` ? = + ) ( apostrophe, double quotes” are not allowed. Minimum length is 5 characters and Maximum length is 255 characters

email_address

string

A valid email address for the beneficiary. Mandatory only if action is ADD; Optional in case of all other action types

mobile_number

string

Beneficiary mobile number. Mandatory only if action is ADD; Optional in case of all other action types

email_notification

int32

If the beneficiary needs to be notified by email for transfers. 0 by default

sms_notification

int32

If the beneficiary needs to be notified by SMS for transfers. 0 by default

Headers

client_id

string

required

client_secret

string

required

module_secret

string

required

Use the accounts module secret

provider_secret

string

required

Response

Language


xxxxxxxxxx
1
curl --request POST \
2
     --url https://in.staging.decentro.tech/core_banking/money_transfer/manage_beneficiaries \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'


xxxxxxxxxx
 
1
{
2
  "status": "success",
3
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX",
4
  "accountNumber": "00XXXXXXXXXXXXX",
5
  "ifscCode": "XXXXXXXXXX",
6
  "name": "DEC00XXXXXXXXXXXXXIMPS",
7
  "beneficiaryCode": "DEC00XXXXXXXXXXXXXIMPS"
8
}

🙌Important Note

API Endpoints

200200

🙌
Important Note