Skip to main content
This is the complete reference for the Partna v4 API. All endpoints use the same base URL and authentication pattern.

​
Base URLs

​
Authentication

All requests require two headers:
See Authentication for details.

​
Request format

All POST and PUT requests accept JSON bodies. Set the Content-Type: application/json header.

​
Response format

All responses return JSON with this structure:
Error responses include a descriptive message:

​
Endpoint groups

Account: Create and manage user accounts, bank accounts, and profiles. Ramp: Initiate onramp (fiat-to-crypto) and offramp (crypto-to-fiat) transactions. This is the core of the Partna API. Rate: Fetch conversion rates and create/verify rate keys for locking prices. Transfer: Create transfers, initiate payouts, convert currencies, and withdraw balances. KYC: Identity verification flows including BVN verification, OTP confirmation, and bank account resolution. Bank: List supported banks by currency. Discount: Fetch current volume-based discount tiers. Supported: List supported crypto assets and networks. User: Manage merchant settings, API keys, webhook URLs, balances, and admin access. MFA: Enable and manage multi-factor authentication for accounts. Mock (Staging Only): Simulate deposits for testing.