Skip to main content

Funding your wallet

Payments are charged to your wallet, so it must hold enough for each one. A payment the wallet cannot cover is refused with 422 INSUFFICIENT_FUNDS, and nothing is charged.

Top up by bank transfer​

  1. Transfer the amount to the Vmonie bank account given to you during onboarding.
  2. Send Vmonie the transfer's reference or session ID and the amount.
  3. Vmonie matches it to the bank statement and credits your wallet. Two Vmonie staff members check every top-up before it is credited.

Each bank transfer can be credited only once.

Check your balance and statement​

GET /wallet returns what you can spend now. Payments still pending are already taken out of it.

GET /wallet/statement lists every movement, newest first:

kindMeaning
TOP_UPA credited bank transfer
BILL_PAYMENTA bill you paid (fee included)
REFUNDMoney returned after the biller reversed a completed payment

A payment that fails shows as a BILL_PAYMENT with status FAILED. Its money is back in your wallet; it has no separate refund line.

Use nextCursor from a page as cursor to get the next one.