​
Individual Wallet

This endpoint creates a new unique individual wallet for your end user by taking in certain parameters including BVN.
[POST]
{{baseUrl}}/api/v1/wallet/ngn/create
HeaderTypeDescription
AppIdstringyou would need to create an app to get your app ID
Authorizationstringpublic secret key

​
Body parameter

ParameterTypeDescription
dob *stringDate of birthrequired
phone_number *stringPhone numberrequired
bvn *stringBank Verification Numberrequired
last_name *stringLast Namerequired
first_name *stringFirst Namerequired
middle_namestringMiddle Nameoptional
routestringroute value is either “PROVIDUS” or “VFD”required

​
Sample response

Response
{
  "entity": {
    "wallet_id": "254a14e1-25ac-338a-94ed-9e4041840599",
    "wallet_amount": 0,
    "account_number": "1200335704",
    "phone_number": "08158070522"
  }
}

​
Corporate Wallet

This endpoint creates a new unique corporate wallet for your end user by taking in certain parameters including BVN.
[POST]
{{baseUrl}}/api/v1/wallet/ngn/create

​
Header

HeaderTypeDescription
AppIdstringyou would need to create an app to get your app ID
Authorizationstringpublic secret key

​
Body parameter

ParameterTypeDescription
dob *stringDate of birthrequired
phone_number *stringPhone numberrequired
bvn *stringBank Verification Numberrequired
last_name *stringLast Namerequired
first_name * *stringFirst Namerequired
middle_namestringMiddle Nameoptional
routestringRoute value is “VFD_CORPORATE”required
rc_numberstringRegistration Number from CACrequired

​
Sample response

Response
{
  "entity": {
    "wallet_id": "254a14e1-25ac-338a-94ed-9e4041840599",
    "wallet_amount": 0,
    "account_number": "1200335704",
    "phone_number": "08158070522"
  }
}

​
One-time use account

This endpoint creates a One-time use account for your end user by taking in certain parameters.
[POST]
{{baseUrl}}/api/v1/payment/get_transfer_account

​
Header

HeaderTypeDescription
AppIdstringyou would need to create an app to get your app ID
Authorizationstringpublic secret key

​
Body parameter

ParameterTypeDescription
reference_id *stringUnique Reference ID to identify the transactionrequired
first_name *stringFirst Namerequired
last_name *stringLast Namerequired
email *stringEmail Addressrequired
amount *intAmount to fund the accountrequired
routestringRoute value is “VFD”optional

​
Sample response

Response
{
  "entity": {
    "account_name": "Pawpaw checkout",
    "account_number": "1234567899",
    "bank_name": "VFD MFB",
    "reference_id": "string-test",
    "transaction_id": "Dojah-8981a12c-4a74-400f-b7a1-4e2a042d5c7f",
    "expired_at": "2025-07-17 12:10:30.727620",
    "amount": 10
  }
}