Guide
Seller Profile
Before a SELLER account can create a shop or list products, it needs a seller profile — the business identity behind the shop, and the account KYC attaches to. Every endpoint on this page lives under https://api.swiftgoma.com/api/v1/seller.
Onboarding order
- 1
Create the profile
POST / with business details, a logo, and a banner. Created asDRAFT. - 2
Submit KYC
Covered in the KYC guide. The profile can't become active without it. - 3
Profile activates automatically
Once staff approve the KYC submission, the profile flips to ACTIVE in the same step — there's no separate activation call.
Profile status
| Status | Meaning |
|---|---|
| DRAFT | Created, but KYC isn't approved yet. Editable. |
| ACTIVE | KYC approved — can create shops and list products. Editable. |
| SUSPENDED | Staff have disabled the account entirely. Not editable. |
This suspension is account-wide
Suspending the seller profile is a different, broader action than suspending an individual shop — it blocks the seller from managing any of their shops or products at all, not just one storefront.
Reading and editing
| Action | Endpoint |
|---|---|
| View my profile | GET /my-profile |
| Edit my profile | PUT / |
GET /my-profile returns the profile alongside the seller's KYC status, subscription, wallet settings, shops, and recent invoices in one call — useful for a seller dashboard's initial load.
Staff actions
| Action | Endpoint |
|---|---|
| Suspend | POST /:userId/suspend |
| Reactivate | POST /:userId/reactivate |