Payment

post
Payment Initiation

https://api.dapi.co/v1/payment/transfer/create
Request
Response
Request
Headers
Authorization
required
string
Bearer <accessToken>
Body Parameters
userSecret
required
string
User Secret from connect
receiverID
required
string
The ID of the beneficiary that will receive the money. This is acquired through a previous call to the GetBeneficiaries endpoint
amount
required
number
Amount of money to be sent
senderID
required
string
The ID of the account that the money will be sent from. This is acquired through a previous call to the UserAccounts endpoint
addresses
optional
array
Specify which webhook URL(s) defined in app settings to send data to. If empty, an update will be sent to all defined webhook urls
sync
optional
boolean
true or false, if set the connection is maintained till the result is returned. Default is false.
appSecret
required
string
App Secret from the dashboard
Response
200: OK
// Synchronous and Webhook Response
{
"jobID": "290af268-62ea-5ce7-81ac-bef8af52f967",
"success": true,
"status": "user_input_required",
"userInputs": [{
"id": "otp",
"query": "Please input Smartpass token"
}, {
"id": "secretQuestion1",
"query": "What is your mother's maiden name?"
}]
}
202: Accepted
// Asynchronous response
{
"jobID": "83515136-9146-523a-9936-3229d51fd49d",
"status": "initialized"
}
422: Unprocessable Entity
{
"success": true,
"status": "error",
"message": "The 'appSecret' field is required!"
}

post
Payment Resumption

https://api.dapi.co/v1/job/resume
Request
Response
Request
Headers
Authorization
required
string
Bearer <accessToken>
Body Parameters
userSecret
required
string
User Secret from connect
amount
optional
number
Amount to be sent
senderID
required
string
The id of the account that the money will be sent from.
receiverID
required
string
The id of the account that the money will be sent to.
userInputs
required
object
An array of objects containing the key 'id' coming from the response userInputs and the 'value' containing the input from the user, for example { "otp": "12345", "secretQuestion1": "doe" }
jobID
required
string
A job UUID returned from Payment Initiation
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. Default is false.
appSecret
required
string
App Secret from the dashboard
Response
200: OK
// Synchronous and Webhook Response
{
"jobID": "290af268-62ea-5ce7-81ac-bef8af52f967",
"success": true,
"status": "done",
}
202: Accepted
// Asynchronous response
{
"jobID": "83515136-9146-523a-9936-3229d51fd49d",
"status": "initialized"
}
422: Unprocessable Entity
{
"success": true,
"status": "error",
"message": "The 'appSecret' field is required!"
}