Skip to main content
Get started with the PayNext Billing API in minutes. Our RESTful endpoints let you process payments, manage subscriptions, and track billing data with enterprise-grade security and reliability.

​
Prerequisites

Before you begin, ensure you have:
  • A PayNext account with API access
  • A tool to send HTTP requests (e.g., curl, Postman, or fetch)
  • Basic understanding of REST APIs

​
Quick Start

1

Choose Environment

Select the appropriate base URL for your development stage—sandbox for testing or production for live transactions.
2

Set API Version

Include the X-API-Version header in all requests to ensure consistent behavior as we release updates.
3

Authenticate Requests

Add your API key to the Authorization header to securely access PayNext endpoints.
curl
curl -X GET 'https://sandbox-api.paynext.com/payments' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-API-Version: 1.0.0"
You should receive a JSON response with your payment data or an empty array if no payments exist.

​
API Endpoint Deployments

Choose the correct base URL for your environment:
  • Sandbox: https://sandbox-api.paynext.com/
  • Production: https://api.paynext.com
Use the sandbox environment for all development and testing. Switch to production only when your integration is complete and ready for live transactions.

​
API Versioning

PayNext updates the API regularly as we release new features. To control your integration, pass a X-API-Version header in every request.
curl
curl -X POST 'https://api.paynext.com/payments' \
  -H "Authorization: YOUR_API_KEY" \
  -H "X-API-Version: 1.0.0" \
  -H "Content-Type: application/json" \
  -d '{"amount": 1000, "currency": "USD"}'
Always include the X-API-Version header. Without it, your integration may break when new API versions are released.
Start with the Authentication section to secure your API integration, then explore the endpoints that match your payment processing needs.