SwiftGoma.SwiftGoma

Search endpoints

Jump to any API endpoint by name, method, or path

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.