v2.0.0 - New API, New Documentation

Release Date: March 12, 2026 Type: Major Release

NextAPI v2 is a full rebuild of both the API and the developer documentation. This release ships a new base URL, a new auth model, a comprehensive content suite covering every integration pattern, and an interactive API reference with 36 documented endpoints.

What changed in the API

New base URL

https://api.partners.nextpay.world/v2/

All v2 endpoints live under this URL. The v1 base URL (https://api.nextapi.com/v1/) is deprecated and will reach end-of-life — migrate to v2 before that date. See your partner agreement for the timeline.

Auth model: Basic Auth

v2 uses Basic Auth throughout — your Client ID and Client Secret, Base64-encoded in the Authorization header:

curl -u "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" \
  https://api.partners.nextpay.world/v2/merchants

v1 used Bearer token auth. Any code using Authorization: Bearer ... must be updated.

→ See Authentication for the full header construction guide.

New endpoints in v2

Category	New in v2
Money In	Payment Intents (dynamic QR), Funding Methods (static QR)
Money Out	Batch payout requests (POST /v2/payout-requests/batch)
Platform	Internal account transfers (POST /v2/accounts/{id}/transfer)
Integration	Webhook management (POST /v2/webhooks, signature verification)
Utilities	Service health (GET /v2/service-health), receiving institutions

Multi-provider routing

v2 routes transactions across multiple financial providers automatically — currently 3 partner institutions, with more being added as the network grows. Your integration calls the same endpoints regardless of which provider handles the transaction — routing is transparent. The multi-provider architecture means better redundancy, competitive costs, and no single point of failure. Factors include cost, provider reliability, and partner-specific configuration.

→ See Multi-Provider Routing

---

What's new in the documentation

Interactive API Reference

36 endpoints — fully documented with request schemas, response examples, and a live Try It panel. Test against the sandbox directly from the browser without leaving the docs.

→ Browse the API Reference

Tutorials: first API call in under 5 minutes

Four getting-started tutorials cover the core flows end-to-end:

• Your First API Call — auth, list merchants, make a payout, check status
• Your First Payout — balance check → payout → lifecycle
• Your First Collection — Payment Intent → QR display → webhook confirmation
• Your First Sub-Merchant — merchant + account creation, full onboarding function

Two advanced tutorials for complete platform builds:

• Build an E-Commerce Checkout
• Build a SaaS Platform with Wallets

How-to Guides

Task-oriented guides for every common integration scenario:

Money In: Accept QRPH Payment, Setup Virtual Collection, Create Payment Intent

Money Out: Send a Single Payout, Run Mass Payroll, Handle Payout Failures, Get Payout Receipt

Platform: Transfer Between Accounts, Take a Commission from Sales, Create Sub-Merchant Wallets

Integration: Setup Webhooks, Verify Webhook Signatures, Reconcile Transactions, Handle Errors and Retries

Concepts

14 explanation pages covering the system and its design decisions:

Overview, Architecture, Authentication, Wallet Structure, Payout Lifecycle, Collections Lifecycle, Disbursement Channels, Multi-Provider Routing, Webhooks, IDs & Idempotency, Errors, Security & Compliance, Sandbox vs Production, Versioning

Use Cases

Five industry landing pages for common integration archetypes — useful if you're evaluating whether NextAPI fits your platform before reading technical docs:

Payment Gateway & Beyond, Merchant SaaS Platforms, Physical Network Payments, Payroll & Bulk Disbursement, Subscription & Billing Platforms, Gig & Marketplace Payouts

Full-text search

Search is now available across all docs, guides, concepts, and the API reference. The index is rebuilt on every deploy.

---

Migration from v1

If you are currently integrated against v1, the minimum changes required to migrate:

1. Update base URL — replace https://api.nextapi.com/v1/ with https://api.partners.nextpay.world/v2/
2. Update auth — replace Bearer token with Basic Auth (-u "CLIENT_ID:CLIENT_SECRET")
3. Update amount handling — v2 amounts are in centavos (PHP minor units). PHP 500.00 = 50000
4. Update webhook verification — v2 signs webhooks with HMAC-SHA256 using your webhook secret in the x-nextpay-signature header

Contact your NextPay account manager to receive v2 credentials and a migration timeline specific to your integration.