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​

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.

🚀 Build Powerful Payment Solutions with NextAPI​

We're excited to launch comprehensive developer documentation for NextAPI! Whether you're building digital wallets, processing payments, or creating financial platforms, our new documentation provides everything you need to integrate NextAPI quickly and successfully.

💡 What You Can Build​

📚 Documentation Features​

🎯 Clear Learning Paths​

• Beginner Quickstarts - Get your first payment working in minutes
• Step-by-Step Guides - Follow detailed tutorials for common use cases
• API Reference - Complete documentation with real examples
• Best Practices - Learn security, compliance, and optimization

🔧 Developer Tools​

• Interactive Examples - Copy-paste ready code samples
• Fast Search - Find exactly what you need instantly
• Mobile-Friendly - Build on any device, anywhere
• Dark Mode - Comfortable coding experience

🏢 Business Solutions​

E-commerce & Marketplaces​

• Enable multiple payment methods for customers
• Handle escrow and multi-party transactions
• Automate refund and dispute processes

SaaS Platforms​

• Add payment processing to your software
• Create user wallets for credit management
• Implement subscription billing and invoicing

Financial Services​

• Build lending and savings applications
• Create investment platforms with wallet integration
• Develop remittance and cross-border payment solutions

🚀 Quick Start Guide​

For New Developers​

1. Get API Keys - Start with your first payment
2. Create Payment Links - Accept payments without coding
3. Understand Wallets - Learn the core concepts

For Experienced Teams​

1. Advanced Integration - Implement complex payment flows
2. SaaS Development - Build scalable platforms
3. Security & Compliance - Ensure regulatory compliance

🌟 Why Choose NextAPI?​

🇵🇭 Philippine Market Focus​

• Local Payment Methods - GCash, Maya, InstaPay, PESONet
• Regulatory Compliance - Built for Philippine financial regulations
• Multi-Currency Support - PHP and international currencies

⚡ Developer Experience​

• Simple Integration - RESTful APIs with clear documentation
• Real-time Updates - Instant webhooks for all payment events
• Reliable Infrastructure - 99.9% uptime with enterprise-grade security

📈 Business Growth​

• Scalable Platform - Handle from 100 to 1M+ transactions
• Competitive Rates - Transparent pricing with volume discounts
• Expert Support - Dedicated technical team to help you succeed

🤝 Get Started Today​

📞 Support & Community​

• 📧 Developer Support: sales@nextfinancial.io
• 💬 Real-time Help: Join our Discord community
• 📋 Feature Requests: Share feedback on GitHub
• 🎓 Business Consulting: Schedule a call with our solutions team

Start building innovative payment solutions today! Our comprehensive documentation and expert support team are here to help you succeed with NextAPI.