Create Wallet

This endpoint is used to create a wallet for a specific currency.

🇳🇬 NGN Wallet Creation Flow

For NGN (Nigerian Naira) wallets, identity verification is required before wallet creation.

Call the utility endpoint (see Utility Section) /utility/identity-verification and provide the BVN of one of the founders/directors.

After successful identity verification, call this endpoint and provide:

Field	Value
`currency`	`NGN`
`bvn`	Same BVN used during identity verification
`companyRegistrationNumber`	The company’s RC (registration) number

Sample NGN Payload:

{
  "currency": "NGN",
  "bvn": "12345678901",
  "companyRegistrationNumber": "123456"
}

For other currencies like GHS, no identity verification is required. Simply provide the currency. Sample GHS Payload:

{
  "currency": "GHS"
}

The bvn and companyRegistrationNumber fields are required only for NGN.
For currencies like GHS, XOF, XAF, etc., these fields must be omitted.
Providing invalid or unnecessary fields may result in validation errors.

Content-Type: application/json

{
  "currency": "GHS"
}

Field	Type	Required	Description
`currency`	`string`	✅ Always	The currency code (e.g. `NGN`, `GHS`, `XOF`)
`bvn`	`string`	✅ NGN only	Bank Verification Number of a founder/director
`companyRegistrationNumber`	`string`	✅ NGN only	The company’s RC number