Paybytoken Pay API
Understand the merchant, consumer and operator boundaries of Paybytoken Pay.
Paybytoken Pay is a private-beta payment method for consumer-authorized payments from finalized Paybytoken balances. Merchants use their normal secret key to create Customers, Payment Intents, payment handoffs and account-link handoffs.
The /consumer/v1 API is used only by Paybytoken-owned consumer experiences with a consumer access
token. It is not a merchant integration surface. The /admin/v1/paybytoken_pay API is restricted to
Paybytoken operators. Do not proxy either credential through merchant frontend code.
Merchant resources
| Resource | Purpose |
|---|---|
PaymentIntent with paybytoken_pay | Exact amount, asset, customer and canonical payment state. |
ConsumerPaymentSession | Short-lived hosted approval handoff. |
ConsumerLinkSession | Short-lived consent handoff linking a merchant Customer to a consumer. |
ConsumerFundingSession | Short-lived exact-output Base ETH to USDC funding correlation. |
Refund | Full or partial return to the original consumer balance. |
Availability is allowlisted by merchant, customer, chain, asset and mode. Test enablement does not enable live payments. Continue with the Paybytoken Pay guide before integrating the merchant endpoints. Paybytoken-owned account clients can also use Consumer funding sessions to add Base USDC with ETH without creating an ETH custody balance.
Did this page answer your question?
Your feedback helps us improve the integration path.