Guide
Wallet
A seller's earnings balance, accumulated from order payments, and the OTP-gated flow to pay it out. Wallet payouts go through MbiyoPay, not PawaPay. Every endpoint on this page lives under https://api.swiftgoma.com/api/v1.
Payout settings
Before a seller can request a payout, they configure where it goes — wallet-settings stores the destination mobile money number, provider, and country. Create it once, then update it any time.
Balance and history
GET /wallet returns the current balance; GET /wallet/transactions returns the paginated ledger of credits (order payments) and debits (payouts) behind it.
Requesting a payout
- 1
Request a code
POST /wallet/payout/request validates the requested amount against the available balance and emails a verification code. - 2
Confirm
POST /wallet/payout with the code sends the payout via MbiyoPay to the configured wallet settings.
The OTP-gated request/confirm shape is the same pattern used for admin payouts across the platform — it exists so a compromised session alone can't drain a wallet without also controlling the seller's email.