Production hosts
API base URL: https://nineteenapis.online — use this for all /api/, /pay/, and /webhooks/ calls.
Documentation only: https://public.nineteenapis.online — this host serves these HTML pages and Swagger; it does not proxy API traffic.
NineteenPay API documentation
Choose a section. Pay-in and payout APIs are grouped by pipe (integration channel). API V1 and API V2 are different auth and path families — do not mix them.
Pipes and route prefixes
Your merchant account is enabled for specific pipes. Each pipe maps to URL prefixes below.
| Pipe / product | API V1 base path | API V2 base path |
|---|---|---|
Native V1 (gateway payload) | /api/payments/nineteenpay-native/ | — |
V1 collect (gateway payload, HMAC) | — | /api/v2/payments/collect (+ validate-vpa, status, refund, static-qr) |
| Native V2 (collect + hosted checkout + status) | — | /api/v2/payments/np-native/ · status: single or batch (≤50 IDs) · payer UI /pay/:transactionId · /pay/share/:transactionId (Web Share) |
| JPSL | /api/payments/jpsl/ | /api/v2/payments/jpsl/ |
| Escrow collect | /api/payments/paytm/ | /api/v2/payments/paytm/ |
| NSDL UPI Pay-In | — | /api/v2/payments/nsdl/ |
| Payouts | /api/payments/payoutnp/ | /api/v2/payouts/ |
Native V1 is not the same as Native V2. V1 collect uses HMAC and a payload block but is not the np-native deeplink API.
API V1
V1 routes
Key + salt headers. All V1 pay-in, JPSL, escrow, payout endpoints.
API V2
V2 routes
HMAC signing, IP whitelist. V1 collect, Native V2, JPSL, escrow, payouts.
Reference
Status codes & errors
HTTP status meanings, error JSON, limits, idempotency, webhooks.
Production API base URL: https://nineteenapis.online
Developer docs (this site): https://public.nineteenapis.online/docs