Manual Disbursement

Generally, disbursement on the vesicash escrow infrastructure is done automatically at the close of every transaction. However, we have made provisions for customers who wishes to accumulate all their funds over a time period to easily do so and make a withdrawal at their own convenience.

Check wallet balance

Customers who have accumulated funds can check their wallet balance using the endpoint:

post
check wallet balance

https://api.vesicash.com/v1/admin/account/wallet
Request
Response
Request
Headers
Accept
required
string
application/json
V-PRIVATE-KEY
required
string
merchant api private key
Form Data Parameters
account_id
required
integer
Account id of the user
Response
200: OK
There are two possible response types which indicates the status of the request:
{
"status": "ok",
"code": 200,
"message": "Data Retrieved",
"data": {
"balance": 308400,
"currency": "USD"
}
}

For example, you can a make a post request to the endpoint above and pass in the json data below to get a user's wallet account:

{
"account_id": 4865544336
}

Initiate a manual withdrawal

Such customers can then proceed to initiate a disbursement from their wallet balance using the endpoint below:

post
initiate manual withdrawal

https://api.vesicash.com/v1/payment/disbursement/wallet/withdraw
Request
Response
Request
Headers
Accept
required
string
application/json
V-PRIVATE-KEY
required
string
merchant api private key
Form Data Parameters
recipient_id
required
integer
Account id of the user who is receving the disburement.
amount
required
string
Amount to withdraw fromt the wallet.
currency
required
string
currency to receive the disbursement
debit_currency
required
integer
currency in which the disbursement is to be done.
Response
200: OK
There are two possible response types which indicates the status of the request:
Two possible responses:
FAILED: This happens whenever there is an issue with the endpoint or with the post data.
{
"status": "error",
"code": 400
"message": "Wallet Transfer\/Disbursement Qued, Status: FAILED"
}
NEW: This happens whenever the post request is successfully submitted.
{
"status": "ok",
"code": 200
"message": "Wallet Transfer\/Disbursement Qued, Status: NEW"
}

For example, you can a make a post request to the endpoint above and pass in the json data below to initiate a withdrawal from your wallet:

{
"recipient_id": 4865544336,
"amount": 1000,
"currency": "NGN",
"debit_currency": "NGN"
}