When to use it
Use Stablecoin Checkout when a customer is paying once for a defined purchase or balance update. Common fit examples include:- Ecommerce orders from a website or custom storefront.
- App or game top-ups where the payer needs a clear hosted payment page.
- Digital goods, content, services, bookings, and one-time account credits.
- Custom commerce flows where your backend owns order creation and fulfillment.
- Merchant systems that need stablecoin payment acceptance without building wallet infrastructure.
Try the demo
You can try a demo checkout mall here:Checkout demo mall
Open the demo mall to see a one-time StablePay Checkout flow from a payer’s perspective.
How it works
- Your backend creates a checkout session with amount, currency, order context, and redirect URLs.
- StablePay returns a hosted checkout URL.
- The payer opens checkout and selects a supported payment method, such as wallet connection or transfer / QR-style payment.
- StablePay presents payer-facing instructions and monitors the on-chain payment.
- StablePay updates the session status and sends webhook events so your system can fulfill the order.
Key capabilities
| Capability | Description |
|---|---|
| Hosted checkout | StablePay hosts the payer-facing payment page and payment instructions. |
| One integration for multiple payment methods | A single checkout integration can present supported wallet and transfer-style payment options. |
| Wallet pay and QR payment | Payers can connect supported wallets or pay by scanning/copying the displayed payment details. |
| Chain and payment monitoring | StablePay monitors the relevant on-chain payment and updates the session lifecycle. |
| Exception visibility | Sessions can surface states such as paid, underpaid, overpaid, expired, and canceled. |
| Webhooks | Merchants can synchronize fulfillment, receipts, and internal order status. |
| Refund support | Eligible completed payments can be refunded through the payment refund workflow. |
iframe embedding
If you want to place StablePay Checkout directly inside your own page, modal, or drawer, you can also use aniframe integration pattern.
This is a good fit for embedded payment experiences where backend logic and Webhooks still drive the final order state. For implementation details, CSP requirements, compatibility notes, and integration boundaries, see the dedicated API guide.
Checkout iframe Integration
Learn how to embed StablePay Checkout in a page, modal, or drawer using a pure iframe approach.
Payment status and exceptions
Stablecoin Checkout is built for the realities of on-chain payments. Payers may send too little, send too much, pay after a session expires, or cancel before paying. StablePay detects and exposes these outcomes so merchants can avoid treating every chain transaction as a simple success or failure. Use webhook events and dashboard status together to decide when to fulfill, when to contact the customer, and when a manual review is needed.Important notes
- Stablecoin Checkout is for one-time payments only. It does not create subscriptions or future automatic charges.
- Payers do not need to create a StablePay account to complete payment.
- Blockchain payments are final once confirmed. StablePay can provide transaction records and event logs for merchant-customer communication.
- StablePay Checkout wallet and transfer payment coverage is maintained in Supported Wallets.
- Detailed network, currency, and regional coverage is maintained in Reference pages instead of repeated here.