Developers

BuildonBankingInfrastructure

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.

api.primax.io
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

Banking operations exposed as REST resources

POST /v1/accountsGET /v1/customersPOST /v1/loansPOST /v1/disbursementsGET /v1/transactionsPOST /v1/kyc/verifyPOST /v1/paymentsGET /v1/balances

01

RESTful Banking APIs

Predictable JSON endpoints for the core operations digital lenders and fintech partners need to launch fast.

Customer APIs

Create and manage customer profiles, KYC status, and contact details through versioned REST resources.

Account Operations

Open savings and wallet accounts, post transactions, and retrieve balances with consistent response schemas.

Lending & Disbursements

Originate loans, trigger disbursements, and track repayment schedules programmatically from your channel.

02

Authentication

Enterprise-grade access controls so only authorized applications and users can call production banking APIs.

OAuth 2.0

Token-based flows with refresh tokens and scoped permissions for server-side and partner integrations.

API Key Management

Issue, rotate, and revoke API keys per environment with institution-level isolation and usage policies.

Scoped Access Tokens

Limit each integration to the modules and actions it needs — accounts, loans, payments, or read-only reporting.

03

Sandbox Environment

Build and test integrations safely before moving to production with realistic banking scenarios.

Test Credentials

Dedicated sandbox keys and OAuth clients separate from production so teams can experiment without risk.

Mock Data Sets

Sample customers, accounts, and loan portfolios to simulate onboarding, disbursement, and collection flows.

Integration Testing

Validate end-to-end flows against sandbox endpoints with predictable responses and error simulation.

04

Webhooks & Events

Stay in sync with PRIMAX in real time — react to banking events in your apps without polling.

Transaction Events

Receive callbacks when deposits, withdrawals, transfers, or reversals post to customer accounts.

Account Updates

Get notified on account status changes, balance thresholds, and product configuration updates.

Loan Status Changes

Track disbursements, repayments, delinquency flags, and loan closure events across your portfolio.

05

Documentation & Tools

Everything your engineering team needs to integrate PRIMAX quickly and maintain integrations over time.

API Reference

Interactive documentation with request and response schemas, error codes, and authentication examples.

Code Samples & SDKs

Starter kits and language-specific snippets for Node, Python, and mobile clients to accelerate delivery.

Integration Guides

Step-by-step playbooks for digital onboarding, disbursement flows, and partner channel architectures.

Ready to find your solution?

Talk with our team about the right PRIMAX configuration for your institution — from sandbox to production.