Checkout

The Checkout API has two halves: public endpoints that a customer’s browser uses to pay a payment link (no auth), and authenticated endpoints you use to create and manage those links.

Public checkout

Identified by a payment reference, these endpoints require no authentication and are rate-limited per IP.

Payment links

Creating and managing payment links is done from your dashboard session (JWT + RBAC), under the /api/payment-links prefix.

Create a payment link

POST /api/payment-links

{
  "amount": 15000,
  "currency": "NGN",
  "description": "Invoice INV-2026-001",
  "customer": {
    "name": "Ada Lovelace",
    "email": "ada@example.com",
    "phone": "+2348012345678"
  },
  "expiresAt": "2026-02-01T00:00:00.000Z"
}