API Reference
Full REST API reference for the 100Pay platform. Everything you need to build payment flows, manage wallets, and automate your integration.
Authentication
All API requests require a valid API key passed in the Authorization header. Generate your key from the 100Pay dashboard under Developer Settings.
Base URL
All REST endpoints are served from https://api.100pay.co/v1. Use HTTPS for all requests — plain HTTP is not supported.
Charges
Create one-time or recurring crypto charges. Returns a checkout URL or embeddable widget. Supports webhooks for payment confirmation.
Wallets
Read balance, transaction history, and asset breakdown for any portfolio wallet linked to your account.
Invoices
Programmatically create, retrieve, and void invoices. Receive webhook events on payment or expiry.
Webhooks
Subscribe to real-time events — payment.confirmed, invoice.paid, payout.sent — and receive signed POST callbacks to your endpoint.
Auth header
Send your API key on every request with Authorization: Bearer YOUR_API_KEY.
Keep keys server-side only and rotate keys regularly from your dashboard.
Request format
Use Content-Type: application/json for write operations and include a unique
idempotency key for charge creation to prevent duplicate payments.
Errors and retries
Error responses include status code and message payloads. Retry only for transient failures (for example, 429 or 5xx) using exponential backoff.
Webhook verification
Verify webhook signatures before processing events and store event IDs so duplicate deliveries are handled safely.
- Full public API reference: https://api.100pay.co/api/v1/public/docs
- Checkout SDK package: https://www.npmjs.com/package/@100pay-hq/checkout
- Base API URL:
https://api.100pay.co/v1
Start building with the 100Pay API.
Full docs, endpoint references, SDKs, and code examples available.