Build on Century
Century is a Nigerian fintech platform for wallets, collections, virtual top-ups and bill payments. This portal documents every capability the platform actually exposes today — with real request shapes, real error codes and honest notes about what is not built yet.
How the API works
Century's API is a typed RPC surface. Each capability is a server function reachable at /_serverFn/<name> over HTTPS, plus a small set of raw HTTP routes under /api/public/* for webhooks and machine callers. Requests and responses are JSON; money amounts are in naira.
- All traffic is HTTPS-only and same-origin from the Century apps.
- Authentication is a Supabase-issued bearer token belonging to a real user account.
- Authorization is enforced in the database with row-level security — the API never trusts the client.
- 97 documented operations across 9 products.
A first call
Read the signed-in user's wallet:
curl -X GET https://centuryvtu.com/_serverFn/getWalletState \
-H "Authorization: Bearer $CENTURY_ACCESS_TOKEN"Products
Balances, ledger, transfers and debits.
Paystack-backed collections, verification and receipts.
Airtime, data, cable, electricity, betting and exam pins.
Three-tier identity verification.
In-app broadcasts, email and Web Push.
Subscription orders and scheduled recurring purchases.
Airtime-to-cash and marketplace orders.
Locked savings, check-ins and referral growth.
Not currently implemented.