Wallets
Create end-user wallets, submit KYC, read balances, and move money - transfer, withdraw, and pay.
Wallets are the accounts money lives in. The public wallet API serves end-user
wallets, the accounts you open on behalf of your customers. Each wallet is
addressed by its acuinf…wlt reference; balances are in
kobo.
This resource has six operations, each on its own page. Read the conventions first: the envelope, auth, scopes, idempotency, and pagination are assumed throughout.
Scopes vary by operation
Most wallet operations use the wallet scope, but pay needs the payment
scope. Each operation's banner shows the real one.
Create a wallet
POST /v1/wallets - open an end-user wallet, with optional inline KYC.
List wallets
GET /v1/wallets - your wallets, newest first, with filters and cursor paging.
Get a wallet
GET /v1/wallets/:id - fetch a single wallet by its reference.
Submit KYC
POST /v1/wallets/:id/kyc - store-only KYC, flips the wallet to tier1.
Get balance
GET /v1/wallets/:id/balance - the wallet's available balance, in kobo.
Pay from wallet
POST /v1/wallets/:id/pay - settle a virtual_wallet payment from a balance.
Money out of a wallet lives in Transfers (wallet to wallet) and Withdrawals (wallet to bank).