Beneficiary
Sub-module with APIs for adding and verifying beneficiaries for the linked business account. Some of the key functions that you can do here are -
- Add a new beneficiary to this account
- Verify the status of a beneficiary
- Retrieve the details of all beneficiaries added to the linked business account via these APIs
Add New Beneficiary
Add a new beneficiary for sending money from the business account.
curl --location --request POST 'https://in.staging.decentro.tech/v2/banking/beneficiary' \
--header 'client_id: <YOUR_CLIENT_ID>' \
--header 'client_secret: <YOUR_CLIENT_SECRET>' \
--header 'module_secret: <YOUR_BANKING_MODULE_SECRET>' \
--header 'provider_secret: <YOUR_CHOSEN_PROVIDER_SECRET>' \
--header 'Content-Type: application/json' \
--data-raw '{
"action": "ADD",
"sender_account_number": "XXXXXXXXXXXX",
"account_number": "462515XXXXXXXXXXXX",
"name": "Decentro Account",
"ifsc": "YESB0CMSNOC",
"transfer_type": "IMPS",
"email": "[email protected]",
"mobile": "XXXXXXXXXX",
"nickname": "nickNameForAccount"
}'
{
"decentroTxnId": "DCTRTXXXXXXXXXXXXXXXXX",
"status": "SUCCESS",
"responseCode": "S00000",
"message": "Beneficiary added successfully.",
"data": {
"ifsc": "YESB0CMSNOC",
"accountNumber": "462515XXXXXXXXXXXX",
"beneficiaryCode": "DEC462515XXXXXXXXXXXXIMPS",
"beneficiaryNickname": "nickNameForAccount"
}
}
Verify Beneficiary
Verify the added beneficiary for sending money from the business account.
curl --location --request POST 'https://in.staging.decentro.tech/v2/banking/beneficiary' \
--header 'client_id: <YOUR_CLIENT_ID>' \
--header 'client_secret: <YOUR_CLIENT_SECRET>' \
--header 'module_secret: <YOUR_BANKING_MODULE_SECRET>' \
--header 'provider_secret: <YOUR_CHOSEN_PROVIDER_SECRET>' \
--header 'Content-Type: application/json' \
--data-raw '{
"action": "VERIFY",
"sender_account_number": "XXXXXXXXXXXX",
"account_number": "462515XXXXXXXXXXXX",
"ifsc": "YESB0CMSNOC",
"transfer_type": "IMPS"
}'
{
"decentroTxnId": "DCTRTXXXXXXXXXXXXXXXXX",
"status": "SUCCESS",
"responseCode": "S00000",
"message": "Beneficiary verified successfully.",
"data": {
"ifsc": "YESB0CMSNOC",
"accountNumber": "462515XXXXXXXXXXXX",
"beneficiaryCode": "DEC462515XXXXXXXXXXXXIMPS",
"beneficiaryName": "Decentro Account",
"beneficiaryNickname": "nickNameForAccount"
}
}
Get All Beneficiaries
Retrieve the details of all beneficiaries added to the linked business account via these APIs.
curl --location --request GET 'https://in.staging.decentro.tech/v2/banking/account/XXXXXXXXXXXX/beneficiary' \
--header 'client_id: <YOUR_CLIENT_ID>' \
--header 'client_secret: <YOUR_CLIENT_SECRET>' \
--header 'module_secret: <YOUR_BANKING_MODULE_SECRET>' \
--header 'provider_secret: <YOUR_CHOSEN_PROVIDER_SECRET>'
{
"decentroTxnId": "DCTRTXXXXXXXXXXXXXXXXX",
"status": "SUCCESS",
"responseCode": "S00000",
"message": "Beneficiary list retrieved successfully",
"data": [
{
"ifsc": "YESB0CMSNOC",
"accountNumber": "462515XXXXXXXXXXXX",
"beneficiaryCode": "DEC462515XXXXXXXXXXXXIMPS",
"beneficiaryName": "Decentro YBL Account",
"beneficiaryNickname": "nickNameForAccount"
},
{
"ifsc": "YESB0CMSNOC",
"accountNumber": "462515XXXXXXXXXXXX",
"beneficiaryCode": "DEC462515XXXXXXXXXXXXNEFT",
"beneficiaryName": "Decentro ICICI Account",
"beneficiaryNickname": "nickNameForBankAccount"
}
]
}
Updated 4 months ago