Beneficiaries

post
Get Beneficiaries

https://api.dapi.co/v1/payment/Beneficiaries
Request
Response
Headers
Authorization
required
string
Bearer <accessToken>
Body Parameters
userSecert
required
string
User Secret from Connect
type
required
string
same, local, intl type of beneficiary
addresses
optional
array
Webhook URL(s) to send data to. If empty an update will be sent to all webhook urls defined in app settings
sync
optional
boolean
true or false, if set the connection is maintained till the result is returned
appSecret
required
string
App Secret from the dashboard
200: OK
// Asynchronous response
{
"jobID": "83515136-9146-523a-9936-3229d51fd49d",
"msg": "Job Intitalized",
"success": null
}
// Synchronous and Webhook Response
{
"jobID": "290af268-62ea-5ce7-81ac-bef8af52f967",
"success": true,
"msg": "Job Finished",
"result": {
"beneficiaries": [
{
"name":"Ahmed",
"accountNumber":"987654300123",
"iban": "AE04345678987654300456"
},
{
"name": "Ali",
"accountNumber":"345678900123",
"iban": "AE04345678987654300789"
}
],
"success": true,
"msg": "Beneficiaries retrieved successfully"
},
"done": true
}

post
Add Beneficiary

https://api.dapi.co/v1/payment/AddBeneficiary
Request
Response
Headers
Authorization
required
string
Bearer <accessToken>
Body Parameters
userSecret
required
string
User Secret from Connect
swiftCode
optional
string
The swift code of the beneficiary's bank. It's required when the type of beneficiary is local or intl
bankName
optional
string
The bank name of the beneficiary. It's required when the type of beneficiary is local or intl
name
required
string
The name of the beneficiary to be added
beneficiaryAccountNumber
required
string
The account number of the beneficiary. In the case of local and intl beneficiaries, the accountNumber is the IBAN.
type
required
string
same, local, intl type of beneficiary
addresses
optional
array
Webhook URL(s) to send data to. If empty an update will be sent to all webhook urls defined in app settings
sync
optional
boolean
true or false, if set the connection is maintained till the result is returned
appSecret
required
string
App Secret from the dashboard
200: OK
// Asynchronous response
{
"jobID": "83515136-9146-523a-9936-3229d51fd49d",
"msg": "Job Intitalized",
"success": null
}
// Synchronous and Webhook Response
{
"jobID": "290af268-62ea-5ce7-81ac-bef8af52f967",
"success": true,
"msg": "Job Initialized",
"result": {
"success": true,
"msg": "Smartpass token is required!"
},
"done": false
}

post
Add Beneficiary Resumption

https://api.dapi.co/v1/payment/AddBeneficiary
Request
Response
Headers
Authorization
required
string
Bearer <accessToken>
Body Parameters
otp
required
string
OTP code from user
jobID
required
string
A job UUID returned from the first AddBeneficiary call
addresses
optional
array
Webhook URL(s) to send data to. If empty an update will be sent to all webhook urls defined in app settings
sync
optional
boolean
true or false, if set the connection is maintained till the result is returned
appSecret
required
string
App Secret from the dashboard
200: OK
// Asynchronous response
{
"jobID": "290af268-62ea-5ce7-81ac-bef8af52f967",
"msg": "Job Resumed",
"success": null
}
// Synchronous and Webhook Response
{
"jobID": "290af268-62ea-5ce7-81ac-bef8af52f967",
"success": true,
"msg": "Job Finished",
"result": {
"success": true,
"msg": "Beneficiary added successfully"
},
"done": true
}