Virtual Accounts

Our virtual NUBAN account service primarily allows merchants receive one-time-payment via bank transfers from other banks. Eyowo’s virtual account numbers, like all NUBAN account numbers in Nigeria, can receive payments from any bank and multiple payers at once. However, unlike regular NUBAN accounts that are forever, virtual NUBAN account numbers are temporary (destroyed after receiving the total value of the bill it was created for).

Furthermore, virtual NUBAN accounts always have corresponding transactional bills.

Creating a virtual

POST {{BASE_URL}}/v1/checkout

{ "amount": 1000, "email": "[e-mail]", "virtual": true, "resolvable": "principal" }

Request Body

Name	Type	Description
amount*	Number	Bill Amount
email*	String	Recipients email address
virtual*	Boolean	Enable virtual account
resolvable*	String	Account reference to resolve.

201: Created

{
    "success": true,
    "data": {
          … [same as creating a payment bill]
          "virtual": true,
         "resolvable": "principal",
         "paymentRef": "xxx",
        "virtualAccountNumber": "xxx",
        "virtualAccountName": "Something",
        "createdAt": "2021-11-08T08:12:39.689Z",
        "updatedAt": "2021-11-08T08:12:39.689Z",
       }
}