API Reference

Create a Reserved Virtual Account

Reserved virtual accounts can be helpful if you're building an app with a wallet system. You can issue a virtual account number for each customer to use in funding their wallet:

  • You generate a virtual account for the customer with our API and provide them with the details
  • The customer transfers to their assigned account
  • We send you a webhook notifying you that we've received the payment
  • You credit the needed funds to the customer's wallet on your platform

You can create a Reserved Virtual account with the create virtual account number endpoint.

❗️

BVN Mandatory

For Reserved Virtual Accounts, BVN is a mandatory field to be provided. Please note that the name on the BVN is the name that should be assigned to the Virtual Account Number

Make a POST request to this endpoint

https://baseURL/fintech/api/v1/account/assignReservedAccount

Body Parameters

{
  "accountName": "Botaj",
  "bvn": "20134523467",
  "accountUserNatureOfBusiness": "Grocery",
  "bankCode": "101",
  "accountType": "Reserved"
}

Response 

{
    "account_number": "3964506124",
    "account_name": "(MERCHANT)Botaj",
    "bvn": "20134523467",
    "requestSuccessful": true,
    "responseMessage": "Reserved Account Generated Successfully",
    "responseCode": "00"
}