1. Sign the partner agreement
Sign the Agreement — one call, no body.2. Add a compliance representative
Add Your Compliance Representative — the individual Rex holds accountable for this account. Runs a KYC check immediately; you’ll know right away if it failed. BVN is permanent once set — double-check it before submitting.3. Choose a business type
Set via Save Business Information’sbusiness_type field. This decides both your document checklist below and
whether an rc_number is required (every type except not_registered).
4. Upload the required documents for your business type
Upload each via Upload Compliance Documents or Upload a Document.not_registered
not_registered
- Utility Bill — required
- Valid ID — required
business_name
business_name
- CAC Certificate — required
- Business Name Application — required
- Utility Bill — required
limited_liability
limited_liability
- CAC Certificate — required
- Board Resolution — required
- Utility Bill — optional
- Either Form CO2 and Form CO7, or a Status Report — one of these two combinations is required; you don’t need all three documents.
cooperative
cooperative
- CAC Certificate — required
- Board Resolution — required
- Utility Bill — optional
422 INVALID_DOCUMENT_TYPE_FOR_BUSINESS_TYPE — the message names
the exact type that was rejected.
5. Submit
Submit Application for Review. Every field from steps 1–4 locks against further edits at this point (409 PROFILE_LOCKED if you try) — get everything right before this call.
6. Wait for approval
Once approved (onboarding_status: active), you can
switch to live. Until
then, everything works in sandbox — see Sandbox vs. Live.
Before you send real traffic
- Configure a webhook and verify signatures correctly — see Verifying Signatures.
- Read the token-lifetime note in Authentication and decide how your backend will handle re-authentication.