Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.paynext.com/llms.txt

Use this file to discover all available pages before exploring further.

Accept a payment from a customer who hasn’t paid through PayNext before. The SDK handles payment method collection, validation, and 3D Secure authentication automatically.

​
When to Use

ScenarioGuide
New customer, first paymentThis guide
Returning customer, saved payment methodCharge Returning Customers

​
Prerequisites

Before accepting payments:
  1. PayNext account with API keys (Testing & Sandbox)
  2. Processor connected in Dashboard → Integrations
  3. Plan created in Dashboard → Plans (defines amount and currency)
  4. Payment methods enabled in Dashboard → Checkout

​
Integration

Follow the SDK Quickstart to:
1

Create a client session

Call POST /client-session from your server with customer email and plan ID.
2

Mount the SDK

Initialize checkout with the session id as clientToken.
3

Handle the result

Use onCheckoutComplete and onCheckoutFail callbacks.
The SDK Quickstart includes complete code examples for Next.js and vanilla TypeScript, plus optional optimizations like preloading.

​
What Happens Next

After a successful first payment:
  • Customer created in PayNext with saved payment method
  • Payment method stored securely for future charges
  • Subscription started (if using a recurring plan)
For subsequent charges, use Charge Returning Customers to leverage the saved payment method.