List balances
GET /v1/wallets
Response · 200
GET /v1/wallets/{currency} returns one wallet in the same shape, for example GET /v1/wallets/NGN. It returns 404 resource_not_found if you have no wallet in that currency.
Balances are strings of digits in minor units. Parse them as integers.
"125000000" in NGN is
₦1,250,000.00.Create a wallet
POST /v1/wallets creates a wallet in a currency. If you already have one, it returns it. It is safe to call more than once.
Fund a wallet
Money reaches a wallet in three ways:- A transfer to your virtual account. For
NGN, see below. - A pay-in. See Pay-ins.
- A conversion from another wallet. See Conversions.
Virtual accounts
A permanent virtual account is a bank account number that belongs to your wallet. Any transfer to it is credited to that wallet. Payve issues permanent virtual accounts forNGN.
Request one
POST /v1/wallets/NGN/request-va
bvn, phone or rcNumber to supply or override them.
Response
A Naira virtual account needs a verified BVN on your business. Without one the request fails with
400 and details.code of bvn_required.Read your virtual accounts
Check before you send
A payout needs the amount plus the fee. CompareavailableBalance with sourceAmount + fee.amount from the quote. A payout that the wallet cannot cover returns 422 wallet_insufficient_funds, with available and required in details.

