Account Activation and KYC
Understand how KYC submission, review, and limits affect your account activation and production readiness.
Introduction
KYC is not just a compliance formality in Genuka Pay. It gates your live payins and sets your transaction limits.
Document Submission
Upload the business and identity documents required for your entity type.
Review Workflow
Track draft, submitted, approved, rejected, or needs-info states across the submission lifecycle.
Operational Limits
Check your per-transaction and monthly limits before enabling live traffic.
Everything happens in the dashboard
KYC is filled in from the Genuka Pay dashboard (KYC page). The /api/v1/kyc/* endpoints the dashboard uses only accept its session: they cannot be called with your API keys, and kyc.* events are not emitted by webhook yet.
Steps
- Complete your company profile — legal type, country and industry. Until it is complete, the integration API answers
403(COMPANY_PROFILE_INCOMPLETE). - Activate live — from the dashboard; this creates your
LIVEapplication, its keys (pk_live_…/sk_live_…) and its settlement account. - Verify your identity and upload the requested documents — the list depends on your entity type; the dashboard shows a completeness score before you submit.
- Submit for review, then follow the status until approval.
- Check your limits in the dashboard before sending real traffic.
If changes are needed after submission, the submission can be unlocked from the dashboard.
Submission Statuses
| Status | Meaning |
|---|---|
draft | Draft, being filled in |
submitted | Sent, waiting for review |
under_review | Being reviewed |
approved | Approved |
rejected | Rejected |
needs_info | More information requested |
Documents
Business documents: BUSINESS_REGISTRATION, TAX_ID, COMPANY_STATUTES, BOARD_MINUTES, NON_BANKRUPTCY_CERTIFICATE.
Proof of address: UTILITY_BILL, RENT_RECEIPT, RESIDENCE_CERTIFICATE, LOCATION_PLAN.
Identity documents: NATIONAL_ID, PASSPORT, NATIONALITY_CERTIFICATE.
The dashboard shows which ones are mandatory for your entity type.
Levels and Limits
| Level | Per transaction | Per month |
|---|---|---|
| 1 — email verified | 100,000 | 300,000 |
| 2 — identity verified | 500,000 | 1,500,000 |
| 3 — business verified | 500,000 | 10,000,000 |
Amounts in your account currency (XAF or XOF). These limits only apply in LIVE. A payment above them is refused at initiation; do not retry it automatically. See also Countries and operators.
Go-live rule
Do not treat KYC approval as background paperwork. It is an operational dependency for limits, activation, and risk-managed launch readiness.
How is this guide?
Last updated on