A merchant guide to adding checkout to your e-commerce site: buyers pay in yen, you receive stablecoinWhat is STBLpay
This guide is for merchant developers and operations staff who integrate STBLpay into an e-commerce site.
STBLpay lets an e-commerce site accept yen payments by bank transfer and receive JPYC. The buyer approves the payment with a passkey on a dedicated checkout page. If the buyer has enough JPYC, the payment comes from that balance.
What merchants do
- Create a payment on your server. Confirm the order, calculate the amount on your server, and create a payment through the API. Example: create a payment for order
ord_0001for 4,980 yen. See Create a payment. - Send the buyer to the returned
checkoutUrl. Example: when the buyer presses the "Pay" button, navigate the buyer's browser tocheckoutUrl. See Start a payment. - Receive the result on your server. Confirm the result with a Webhook (verify the signature) or a status lookup, then update the order. Setting up a Webhook is optional. Example: once you confirm success, mark the order as "paid" and deliver the goods exactly once. See Completion check and Webhooks.
STBLpay and the buyer handle everything else:
| Who | What they do | Example |
|---|---|---|
| STBLpay | Provides the checkout page | The screen where the buyer approves the payment with a passkey |
| STBLpay | Provides the merchant console | Issuing API keys, configuring Webhooks, approving refunds |
| Buyer | Applies for JPYC issuance | On the JPYC EX screen, the buyer applies for JPYC issuance and pays in yen by bank transfer |
Scope of this site
| Subject | How this site treats it |
|---|---|
| Payment API, statuses, Webhooks | Integration details covered in this guide |
| Refunds | Only through the merchant console, where the owner approves with a passkey. Merchant servers cannot call a refund API (none exists) |
| Sandbox | An environment for trying your integration (Sandbox) |
| Multi-account management, WooCommerce plugin | Planned after the first release (Roadmap) |
Availability and known limitations are summarized in Known limitations.
Read these first
- Payment flow, Money flow, Client and server responsibilities
- Prerequisites and Quick Start
- Completion check and Webhooks
For refunds, see Scope of refunds.