Introduction
Welcome
The SwiftGoma API powers buying, selling, and delivery in Goma — accounts and sessions, seller onboarding, products, orders, and payments. This is the developer documentation for integrating with it.
Learn more…
Authentication
How sessions work, signing in with a password, an email code, a passkey, or Google, and adding two-factor authentication.
Users
Managing a signed-in user's profile, contact details, linked sign-in methods, and account lifecycle.
Products
Browsing and searching the catalog, listing products as a seller, managing stock, reviews, and multi-currency pricing.
Orders
Cart, checkout, the full order lifecycle across buyer, seller, and rider, QR-code handoffs, in-delivery chat, and refunds.
Seller Profile
Creating and managing a seller's business profile — the first step of onboarding, ahead of KYC.
Seller KYC
Identity verification for sellers — submitting documents, and the two-stage staff review that activates a profile.
Payments
The PawaPay integration — used narrowly for subscription billing and expense payouts, with OTP-gated payouts and refunds.
MbiyoPay
The buyer- and seller-facing mobile money provider — checkout, order refunds, and seller wallet payouts, covering DRC and Rwanda.
Shops
The public storefront a seller's products live under — creation, publishing, and staff moderation (suspend, reactivate, restore).
Riders
Inviting and managing delivery riders under a shop, and a rider's own delivery history.
Billing
Subscription plans, subscribing/upgrading/cancelling, and the invoices generated along the way — billed through PawaPay.
Wallet
A seller's earnings balance, payout settings, transaction history, and OTP-gated payout requests via MbiyoPay.
Expenses
Recording company expenses and the OTP-gated admin approval flow that pays them out through PawaPay.
Accounting
Financial reports (PDF/CSV/email), and a unified ledger of every payment and payout across both providers.
Notifications
In-app notifications, read/unread state, and per-type delivery preferences — with some types that can't be muted.
Favorites
Saving and browsing a buyer's favorited products.
Support
The public contact form, and staff triage — assigning, updating, and closing messages.
Incidents
A public status-page feed of platform incidents, and staff tools to open, update, and resolve them.
Blog
Public blog posts, and staff CRUD for drafting, publishing, and managing them.
Storefront
The home page hero carousel — public read, staff-managed slides.
Dashboard
Role-specific overview and metrics endpoints for support, accounting, and admin staff.
API Reference
Every endpoint, with parameters, example requests, and example responses.