Logo GenukaGenuka Pay
Guides

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

  1. Complete your company profile — legal type, country and industry. Until it is complete, the integration API answers 403 (COMPANY_PROFILE_INCOMPLETE).
  2. Activate live — from the dashboard; this creates your LIVE application, its keys (pk_live_… / sk_live_…) and its settlement account.
  3. Verify your identity and upload the requested documents — the list depends on your entity type; the dashboard shows a completeness score before you submit.
  4. Submit for review, then follow the status until approval.
  5. 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

StatusMeaning
draftDraft, being filled in
submittedSent, waiting for review
under_reviewBeing reviewed
approvedApproved
rejectedRejected
needs_infoMore 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

LevelPer transactionPer month
1 — email verified100,000300,000
2 — identity verified500,0001,500,000
3 — business verified500,00010,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