👛

Wallet Accounts

Create and manage customer wallet accounts, retrieve wallet information and balances, and manage customer KYC levels through a unified Wallet API.

👛 Wallet creation💰 Balance enquiry🪪 KYC upgrades⬇️ KYC downgrades

Wallet Lifecycle

1

Create a wallet

Create a wallet account for a customer. Once created, the wallet can receive funds, maintain a balance, and be upgraded through KYC verification.

2

Retrieve wallet information

Fetch wallet details or check the current wallet balance at any time using the appropriate wallet endpoints.

3

Manage KYC

Retrieve the customer's outstanding KYC requirements before upgrading the wallet to a higher verification tier. If required, you can also downgrade the wallet's KYC level.

Bearer token required

All endpoints require a valid Bearer token. Obtain one from the Access Token endpoint and include it as:

Authorization: Bearer <token>

Endpoints

POST

Create Wallet

Creates a new wallet account for a customer.

GET

Get Wallet

Retrieves information for an existing wallet account.

GET

Get Wallet Balance

Returns the available balance of a wallet account.

GET

Get KYC Update Requirements

Retrieves the documents and information required to upgrade a wallet's KYC level.

POST

Upgrade Wallet KYC

Upgrades a wallet to a higher KYC tier after the required information has been provided.

POST

Downgrade Wallet KYC

Downgrades the KYC level of an existing wallet account.