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
- Transfer the amount to the Vmonie bank account given to you during onboarding.
- Send Vmonie the transfer's reference or session ID and the amount.
- 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:
kind | Meaning |
|---|---|
TOP_UP | A credited bank transfer |
BILL_PAYMENT | A bill you paid (fee included) |
REFUND | Money 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.