适用场景
当客户为一笔明确的购买、充值或余额变更进行一次性付款时，适合使用 Stablecoin Checkout。 常见场景包括：- 网站或自定义商城中的电商订单。
- App 或游戏充值，需要清晰的托管付款页面。
- 数字商品、内容、服务、预约和一次性账户充值。
- 由商家后端负责创建订单和履约的自定义交易流程。
- 希望接入稳定币支付，但不想自行建设钱包基础设施的商家系统。
体验 demo
你可以访问下面的演示商城，体验一次性 StablePay Checkout 付款流程：Checkout demo mall
打开 demo mall，从付款人视角体验 StablePay Checkout。
工作流程
- 商家后端创建 checkout session，传入金额、币种、订单上下文和跳转地址。
- StablePay 返回托管收银台 URL。
- 付款人打开收银台，并选择支持的付款方式，例如连接钱包或转账 / 扫码支付。
- StablePay 展示付款指引，并监听链上付款。
- StablePay 更新 session 状态，并发送 Webhook，商家系统据此履约。
核心能力
| 能力 | 说明 |
|---|---|
| 托管收银台 | StablePay 托管面向付款人的支付页面和付款指引。 |
| 一次接入支持多种付款方式 | 同一 checkout 接入可展示支持的钱包和转账式付款选项。 |
| 钱包付款与扫码付款 | 付款人可连接支持的钱包，也可扫描或复制页面展示的付款信息。 |
| 链与付款监听 | StablePay 监听相关链上付款，并更新 session 生命周期。 |
| 异常状态可见 | session 可展示 paid、underpaid、overpaid、expired、canceled 等状态。 |
| Webhook | 商家可同步履约、通知和内部订单状态。 |
| 退款支持 | 符合条件的已完成付款，可通过 payment refund 流程退款。 |
iframe 嵌入
如果你希望将 StablePay Checkout 直接嵌入自有页面、弹窗或抽屉中，也可以采用iframe 集成方式。
这种模式更适合需要嵌入式付款体验、但仍由后端和 Webhook 驱动订单状态处理的场景。详细接入要求、CSP 配置、兼容性和方案边界，请参考 API 文档中的 iframe 集成说明。
Checkout iframe 集成
查看如何将 StablePay Checkout 以纯 iframe 方式嵌入到网页、弹窗或抽屉中。
付款状态与异常处理
Stablecoin Checkout 针对链上付款的真实情况设计。付款人可能少付、多付、在 session 过期后付款，或在付款前取消。StablePay 会识别并暴露这些结果，帮助商家避免把所有链上交易都简单当作成功或失败。 商家应结合 Webhook 事件和后台状态，决定何时履约、何时联系客户，以及何时需要人工处理。重要说明
- Stablecoin Checkout 只适用于一次性付款，不会创建订阅或未来自动扣款。
- 付款人无需创建 StablePay 账号即可完成付款。
- 区块链付款一旦确认即不可逆。StablePay 可提供交易记录和事件日志，用于商家与客户沟通。
- StablePay Checkout 的钱包与转账付款支持范围统一维护在 Supported Wallets。
- 网络、币种和地区支持范围统一维护在 Reference 页面，不在本页重复展开。