> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stablepayfi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 稳定币收银台

> 用于一次性 USDT / USDC 付款的托管收银台。

Stablecoin Checkout 是 StablePay 面向一次性稳定币付款的托管收银台产品。它让商家可以接受 USDT 和 USDC 付款，而无需自行搭建钱包连接、链选择、交易监听、二维码 / 地址付款逻辑和异常支付处理。

商家通过后端创建 checkout session，将付款人跳转到 StablePay 托管收银台，并通过后台和 Webhook 接收付款状态。StablePay 负责付款页面体验、钱包与转账指引、链上监听、付款状态识别和异常状态展示。

## 适用场景

当客户为一笔明确的购买、充值或余额变更进行一次性付款时，适合使用 Stablecoin Checkout。

常见场景包括：

* 网站或自定义商城中的电商订单。
* App 或游戏充值，需要清晰的托管付款页面。
* 数字商品、内容、服务、预约和一次性账户充值。
* 由商家后端负责创建订单和履约的自定义交易流程。
* 希望接入稳定币支付，但不想自行建设钱包基础设施的商家系统。

## 体验 demo

你可以访问下面的演示商城，体验一次性 StablePay Checkout 付款流程：

<Card title="Checkout demo mall" icon="cart-shopping" href="https://mall.wenfu.shop/">
  打开 demo mall，从付款人视角体验 StablePay Checkout。
</Card>

如果你需要周期扣款，请使用 [Stablecoin Subscriptions](/zh/product/StablePay-Stablecoin-Subscription)。如果你要向指定客户发送账单，请使用 [Invoicing](/zh/product/Invoicing)。如果你需要公开可复用的支付页面，请使用 [Payment Links](/zh/product/Payment-Links)。

## 工作流程

1. 商家后端创建 checkout session，传入金额、币种、订单上下文和跳转地址。
2. StablePay 返回托管收银台 URL。
3. 付款人打开收银台，并选择支持的付款方式，例如连接钱包或转账 / 扫码支付。
4. StablePay 展示付款指引，并监听链上付款。
5. StablePay 更新 session 状态，并发送 Webhook，商家系统据此履约。

对商家来说，核心流程是：创建 session、跳转付款人、监听付款状态，并在确认付款后履约。

## 核心能力

| 能力           | 说明                                                        |
| :----------- | :-------------------------------------------------------- |
| 托管收银台        | StablePay 托管面向付款人的支付页面和付款指引。                              |
| 一次接入支持多种付款方式 | 同一 checkout 接入可展示支持的钱包和转账式付款选项。                           |
| 钱包付款与扫码付款    | 付款人可连接支持的钱包，也可扫描或复制页面展示的付款信息。                             |
| 链与付款监听       | StablePay 监听相关链上付款，并更新 session 生命周期。                      |
| 异常状态可见       | session 可展示 paid、underpaid、overpaid、expired、canceled 等状态。 |
| Webhook      | 商家可同步履约、通知和内部订单状态。                                        |
| 退款支持         | 符合条件的已完成付款，可通过 payment refund 流程退款。                       |

## iframe 嵌入

如果你希望将 StablePay Checkout 直接嵌入自有页面、弹窗或抽屉中，也可以采用 `iframe` 集成方式。

这种模式更适合需要嵌入式付款体验、但仍由后端和 Webhook 驱动订单状态处理的场景。详细接入要求、CSP 配置、兼容性和方案边界，请参考 API 文档中的 iframe 集成说明。

<Card title="Checkout iframe 集成" icon="window-maximize" href="/zh/api/checkout-iframe-integration">
  查看如何将 StablePay Checkout 以纯 iframe 方式嵌入到网页、弹窗或抽屉中。
</Card>

## 付款状态与异常处理

Stablecoin Checkout 针对链上付款的真实情况设计。付款人可能少付、多付、在 session 过期后付款，或在付款前取消。StablePay 会识别并暴露这些结果，帮助商家避免把所有链上交易都简单当作成功或失败。

商家应结合 Webhook 事件和后台状态，决定何时履约、何时联系客户，以及何时需要人工处理。

## 重要说明

* Stablecoin Checkout 只适用于一次性付款，不会创建订阅或未来自动扣款。
* 付款人无需创建 StablePay 账号即可完成付款。
* 区块链付款一旦确认即不可逆。StablePay 可提供交易记录和事件日志，用于商家与客户沟通。
* StablePay Checkout 的钱包与转账付款支持范围统一维护在 [Supported Wallets](/zh/product/Supported-Wallets)。
* 网络、币种和地区支持范围统一维护在 Reference 页面，不在本页重复展开。

## 相关页面

* [Supported Wallets](/zh/product/Supported-Wallets)
* [Supported Networks](/zh/product/Supported-Networks)
* [Currencies & Auto Currency Conversion](/zh/product/Auto-Currency-Conversion)
* [Refunds](/zh/product/Refunds)
* [Checkout iframe 集成](/zh/api/checkout-iframe-integration)
* [Checkout Display & Logo Guidelines](/zh/product/Checkout-Display-Guide--StablePay-Logo)