Core concepts
Hosted checkout
Hosted checkout gives you a production-ready payment surface without building on-chain UX yourself.
What you configure
Hosted checkout gives you a production-ready payment surface without building on-chain UX yourself. Most teams configure storefront/checkout via merchant endpoints, then create payment intents from backend order events.
- Allowed quote chains and fiat options.
- Available fiat currencies and corridors.
- Storefront presentation (logo, theme, return URLs).
Merchant checkout endpoints
The following are merchant-authenticated. Public payer-facing variants live under the same root but do not require credentials.
- POST/v1/merchant/checkout/storefrontsCreate storefront
- POST/v1/merchant/checkout/qrcodesCreate QR code
- GET/v1/merchant/checkout/quote-chain-optionsAllowed quote chains
- GET/v1/merchant/checkout/fiat-currency-optionsAvailable fiat currencies
Developer pattern
- Use merchant checkout quote-chain options before exposing checkout token selectors.
- Display the returned deposit address or hosted checkout URL to the payer.
- Use webhooks for state transitions, never poll the session every second.
Public vs. authenticated
Storefront presentation is public-facing, but creation and management stay behind authenticated merchant APIs.