Create Virtual Account

This functionality enables you to create a virtual account on behalf of your customers. The assigned account number is unique to each customer.

Create Dedicated Account

POST {{ BASE }}/dedicated-account

--header 'Accept: application/json'
--header 'Authorization: Bearer {{  access_token }}'

Request Body

Below are the request body parameters 🎉

Name
Type
Description

first_name

String

First Name

last_name

String

Last Name

email

String

Email Address

phone_number

Number

11 Digit Phone number

kyc_type

String

bvn or nin

kyc_number

Number

Bvn or Nin Number

Response Body

{
    "statuscode": 200,
    "status": true,
    "message": "Virtual accounts created successfully",
    "event_type": "dedicated_account",
    "reference": "CUS_7ieiebfwy09k6qo",
    "data": {
        "account_name": "{{Business Name}}/{{ Customer Name }}",
        "accounts": {
            "account_number": "1234567890",
            "bank_name": "Wema Bank",
            "bank_code": 24,
            "reservation_reference": 1030XXXXX
        }
    }
}

Last updated