Create Wallet

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

Header	Type	Description
AppId	string	you would need to create an app to get your app ID
Authorization	string	Your private (secret) key

Body parameter

Parameter	Type	Description	Required
`first_name`	string	First name	Required
`last_name`	string	Last name	Required
`middle_name`	string	Middle name	Optional
`dob`	string	Date of birth	Required
`phone_number`	string	Phone number	Required
`bvn`	string	Bank Verification Number	Required
`route`	string	Partner bank — `PROVIDUS` or `VFD`	Required

The BVN and date of birth you send here are sensitive personal data. Transmit them over HTTPS only, never write them to your application logs, and mask them as *8901 anywhere a partial value is enough.

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

Header	Type	Description
AppId	string	you would need to create an app to get your app ID
Authorization	string	Your private (secret) key

Body parameter

Parameter	Type	Description	Required
`first_name`	string	First name	Required
`last_name`	string	Last name	Required
`middle_name`	string	Middle name	Optional
`dob`	string	Date of birth	Required
`phone_number`	string	Phone number	Required
`bvn`	string	Bank Verification Number	Required
`route`	string	Must be `VFD_CORPORATE`	Required
`rc_number`	string	Registration number from CAC	Required
`address`	string	Business address	Required
`state`	string	Address state	Required
`incorporation_date`	string	Date of incorporation	Required

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

Header	Type	Description
AppId	string	you would need to create an app to get your app ID
Authorization	string	Your private (secret) key

Body parameter

Parameter	Type	Description	Required
`reference_id`	string	Unique reference identifying the transaction	Required
`first_name`	string	First name	Required
`last_name`	string	Last name	Required
`email`	string	Email address	Required
`amount`	int	Amount to fund the account	Required
`route`	string	Partner bank — `VFD`	Optional

Sample response

Response

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

Get started

Core concepts

API Endpoints

Create Wallet

Individual Wallet

Header

Body parameter

Sample response

Corporate Wallet

Header

Body parameter

Sample response

One-time use account

Header

Body parameter

Sample response

​Individual Wallet

​Header

​Body parameter

​Sample response

​Corporate Wallet

​Header

​Body parameter

​Sample response

​One-time use account

​Header

​Body parameter

​Sample response

Individual Wallet

Header

Body parameter

Sample response

Corporate Wallet

Header

Body parameter

Sample response

One-time use account

Header

Body parameter

Sample response