API reference
Build and operate stablecoin payments with predictable, server-authenticated resources.
The Paybytoken API uses resource-oriented JSON endpoints. Create orders with Checkout Sessions, observe payment state with Payment Intents, and fulfill from signed events.
The versioned contract spans merchant, public checkout, consumer and restricted operator surfaces. Browse the generated Endpoint catalog for the complete versioned contract and its current operation counts.
API surfaces
| Surface | Base URL | Intended caller |
|---|---|---|
| Merchant | https://api-prod.paybytoken.io/api/v1 | Merchant server with a secret or restricted API key. |
| Payments Router | https://payments-api.paybytoken.io/v2 | Merchant server with an independent Payments credential. |
| Public collection | https://api-prod.paybytoken.io/public/v1 | Paybytoken-hosted public Payment Link and Payment Request pages. |
| Consumer | https://api-prod.paybytoken.io/consumer/v1 | Paybytoken-owned consumer clients with consumer session credentials. |
| Operator | https://api-prod.paybytoken.io/admin/v1 | Restricted Paybytoken operations; not a merchant integration surface. |
Send a merchant API key from trusted server code:
Authorization: Bearer $PAYBYTOKEN_SECRET_KEY
Content-Type: application/jsonCore resources
| Resource | Purpose |
|---|---|
| Checkout Sessions | Define one order and one customer payment attempt. |
| Payments Router | Offer stablecoin, card and wallet options through one provider-neutral Payment. |
| Payment Links | Reuse a hosted payment page with fixed or customer-entered amounts. |
| Payment Requests | Collect one customer receivable across retries and partial payments. |
| Payment Intents | Track one payment across crypto transfer or customer-balance methods. |
| Customers | Keep merchant-scoped customer identity and state. |
| Customer deposits | Provision persistent addresses and track customer balances. |
| Customer withdrawals | Move a customer's available crypto balance to an external address. |
| Refunds | Return captured funds through the payment's original method. |
| Paybytoken Pay | Create merchant handoffs for private-beta balance payments and account links. |
| Tokens | Discover enabled token and chain combinations. |
| Events | Inspect payment lifecycle events. |
| Webhook endpoints | Configure signed asynchronous delivery. |
| Balances | Read merchant balances by currency and account. |
| Payouts | Create and inspect merchant payouts. |
Start with Authentication, then Create a Checkout Session.
Did this page answer your question?
Your feedback helps us improve the integration path.