Partner API
The Partner API is for a caller managing multiple merchants under one account — a payment aggregator, a reseller, a platform onboarding its own sub-merchants. Two kinds of calls live under this umbrella:
| How | Where | |
|---|---|---|
| Account management — your own profile, wallet balance, the merchants you manage, your transaction history, commission configs | Direct paymentSystem calls, JWT Bearer | This page + Account below |
| Acting on behalf of a merchant — AEPS, DMT, UPI, on a specific managed merchant's account | fintech-gateway, API key + AES-256-GCM encryption | Authentication & Security, then AEPS / DMT / UPI |
These are genuinely two different transports for two different jobs — don't assume one set of credentials or one auth header covers both. Account management uses the same POST /login JWT flow as a merchant (see Authentication & Security for the vendor-specific parts of that). Acting on a merchant's behalf uses a static API key, never a login.
Base Path
Account-management routes below are relative to your paymentSystem host — dev: http://localhost:3010; staging/production: ask your integration contact, not fixed in this documentation set.
Common Response Shape
{ "statusCode": "00", "message": "...", "data": { ... } }
Account
| Method | Path | Description | Docs |
|---|---|---|---|
GET | /vendor/me | Get your vendor profile | Profile |
POST | /vendor/reset-password | Change your account password | Profile |
GET | /vendor/balance | Current wallet balance | Balance |
POST | /vendor/balance/add | Add funds to your wallet | Balance |
POST | /vendor/balance/withdraw | Withdraw to your settlement account | Balance |
GET | /vendor/balance/history | Paginated wallet ledger | Balance |
GET | /vendor/merchants | List sub-merchants | Merchants |
GET | /vendor/transaction/vendor/all | List all transactions | Transactions |
GET | /vendor/transaction/:id | Single transaction detail | Transactions |
GET | /vendor/gettransactions | Dashboard summary (today/week/month/year) | Transactions |
GET | /vendor-commission/:vendorId/commission | List commission slabs | Commission |
POST | /vendor-commission/:vendorId/commission | Create a commission slab | Commission |
This table covers the routes most integrations need — each linked page has the complete set (including a few narrower dashboard/summary endpoints not listed here) with full request/response examples.