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:

{
  "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:

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"
}