Guide
Seller KYC
Identity verification for sellers, sitting between creating a seller profile and it becoming ACTIVE. Every endpoint on this page lives under https://api.swiftgoma.com/api/v1/seller/kyc.
Before submitting
Two prerequisites
The seller's phone number must already be verified, and they need at least one verified email address — see the Users guide. Submission is rejected outright if either is missing.
Required documents
| Document | Format | Required |
|---|---|---|
| ID document | Image or PDF — national ID, voter card, or passport | Always |
| Proof of address | Image or PDF | Always |
| Selfie | Image only | Always |
| RCCM number + document | Business registration | Both together, or neither |
Review flow
- 1
Seller submits
POST / — one submission per profile. Status starts atPENDING. - 2
Support reviews
Typically after a verification call. POST /:id/support-review with call notes moves it toSUPPORT_REVIEWEDand notifies admins. - 3
Admin gives final approval
POST /:id/approve moves it toAPPROVEDand activates the seller profile in the same step.
Status transitions
| From | Can move to |
|---|---|
| PENDING | SUPPORT_REVIEWED, REJECTED |
| SUPPORT_REVIEWED | APPROVED, REJECTED |
| REJECTED | PENDING — via resubmission |
| APPROVED | — terminal |
A rejected submission can be fixed and sent back with POST /resubmit — only the documents that need replacing have to be included; anything omitted keeps its previous value.
Why Support and Admin are split
Support can review and reject, but only ADMIN can give final approval — a maker-checker split so no single support agent can activate a seller account unilaterally.
Staff lookup
KYC detail includes the seller's linked account info for review — sensitive fields like passwords and verification codes are stripped before it's returned.