Customer APIs
Create and manage customer profiles, KYC status, and contact details through versioned REST resources.
Developers
Developer-Grade APIs for Financial Products
Integrate core banking capabilities into your apps, partner portals, and digital channels with RESTful APIs, secure authentication, webhooks, and a full sandbox environment.
curl -X POST https://api.primax.io/v1/accounts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"customer_id": "cus_8f2k9x",
"product": "savings_basic",
"currency": "NGN"
}'→ 201 Created · account_id: acc_3m7k2p
Core endpoints
01
Predictable JSON endpoints for the core operations digital lenders and fintech partners need to launch fast.
Create and manage customer profiles, KYC status, and contact details through versioned REST resources.
Open savings and wallet accounts, post transactions, and retrieve balances with consistent response schemas.
Originate loans, trigger disbursements, and track repayment schedules programmatically from your channel.
02
Enterprise-grade access controls so only authorized applications and users can call production banking APIs.
Token-based flows with refresh tokens and scoped permissions for server-side and partner integrations.
Issue, rotate, and revoke API keys per environment with institution-level isolation and usage policies.
Limit each integration to the modules and actions it needs — accounts, loans, payments, or read-only reporting.
03
Build and test integrations safely before moving to production with realistic banking scenarios.
Dedicated sandbox keys and OAuth clients separate from production so teams can experiment without risk.
Sample customers, accounts, and loan portfolios to simulate onboarding, disbursement, and collection flows.
Validate end-to-end flows against sandbox endpoints with predictable responses and error simulation.
04
Stay in sync with PRIMAX in real time — react to banking events in your apps without polling.
Receive callbacks when deposits, withdrawals, transfers, or reversals post to customer accounts.
Get notified on account status changes, balance thresholds, and product configuration updates.
Track disbursements, repayments, delinquency flags, and loan closure events across your portfolio.
05
Everything your engineering team needs to integrate PRIMAX quickly and maintain integrations over time.
Interactive documentation with request and response schemas, error codes, and authentication examples.
Starter kits and language-specific snippets for Node, Python, and mobile clients to accelerate delivery.
Step-by-step playbooks for digital onboarding, disbursement flows, and partner channel architectures.
Talk with our team about the right PRIMAX configuration for your institution — from sandbox to production.