> ## 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.

# 开始使用

> 先完成商户注册，再按 Pay In / Pay Out 选择产品路径，最后完成审核、测试和上线。

StablePay 当前的产品能力可以分成两条主线：

* `Pay In`：向客户收款，包括托管收银台、账单、收款链接、SaaS 平台集成和订阅收款
* `Pay Out`：向外部钱包或另一个 StablePay Account 付款

从这里开始：[注册 StablePay Portal](https://merchant.stablepay.co/#/auth/register?channel=official\&return_to=https%3A%2F%2Fmerchant.stablepay.co%2F%23%2Fdashboard)

## 推荐开始路径

1. 通过 [StablePay Portal](https://merchant.stablepay.co/#/auth/register?channel=official\&return_to=https%3A%2F%2Fmerchant.stablepay.co%2F%23%2Fdashboard) 完成商户注册。
2. 先判断你的首要需求属于 `Pay In`、`Pay Out`，还是两者都需要。
3. 按业务场景选择合适的产品路径。
4. 完成 StablePay KYB，并根据产品要求等待能力审核与开通。
5. 完成品牌、通知等可选配置。
6. 在正式上线前完成关键业务流程测试。

## 自助注册

StablePay 支持商家自助注册。商家完成注册后即可登录 Merchant Portal，开始选择产品、提交 KYB、测试流程并逐步开通所需能力。

<Card title="立即注册" icon="arrow-up-right-from-square" href="https://merchant.stablepay.co/#/auth/register?channel=official&return_to=https%3A%2F%2Fmerchant.stablepay.co%2F%23%2Fdashboard">
  打开 StablePay Merchant Portal，创建你的商户账户。
</Card>

## 选择合适的产品

### Pay In

当你要向客户收款时，请从这些产品开始。

<CardGroup cols={2}>
  <Card title="Stablecoin Checkout" icon="cart-shopping" href="/zh/product/Stablecoin-Checkout">
    通过托管收银台接受一次性稳定币付款。
  </Card>

  <Card title="Invoicing" icon="file-invoice-dollar" href="/zh/product/Invoicing">
    向指定客户发送账单，并支持邮件、PDF 与托管账单页。
  </Card>

  <Card title="收款链接" icon="link" href="/zh/product/Payment-Links">
    创建可复用、可公开分享的一次性收款链接。
  </Card>

  <Card title="SaaS 平台集成" icon="store" href="/zh/product/SaaS-Platform-Integration">
    通过 Shopify、WooCommerce、Shoplazza、SHOPYY 等平台快速上线收单。
  </Card>

  <Card title="Stablecoin Subscriptions" icon="repeat" href="/zh/product/StablePay-Stablecoin-Subscription">
    在客户首次授权后，按周期自动续费扣款。
  </Card>
</CardGroup>

### Pay Out

当你要把资金发出去时，请从这些产品开始。

<CardGroup cols={2}>
  <Card title="向钱包付款" icon="paper-plane" href="/zh/product/Payout-to-Wallets">
    向外部钱包地址发放稳定币，用于薪酬、佣金、返利或批量分发。
  </Card>

  <Card title="向 StablePay Account 付款" icon="building-columns" href="/zh/product/Payout-to-StablePay-Account">
    通过邮箱或 Account No. 向另一个 StablePay Account 发起内部付款。
  </Card>
</CardGroup>

### 其他产品能力

<CardGroup cols={2}>
  <Card title="企业卡" icon="credit-card" href="/zh/product/Corporate-Cards">
    创建 Budget、签发虚拟卡，并管理企业支出。
  </Card>

  <Card title="退款" icon="rotate-left" href="/zh/product/Refunds">
    处理已完成付款后的退款操作。
  </Card>
</CardGroup>

## 常见场景

| 如果你需要...                  | 推荐使用                                                                      |
| :------------------------ | :------------------------------------------------------------------------ |
| 在网站或 App 中接受一次性付款         | [Stablecoin Checkout](/zh/product/Stablecoin-Checkout)                    |
| 给指定客户发送一张可支付账单            | [Invoicing](/zh/product/Invoicing)                                        |
| 向多个客户分享同一个公开支付页面          | [收款链接](/zh/product/Payment-Links)                                         |
| 在支持的平台店铺中快速上线稳定币收单        | [SaaS 平台集成](/zh/product/SaaS-Platform-Integration)                        |
| 按周期向客户收款                  | [Stablecoin Subscriptions](/zh/product/StablePay-Stablecoin-Subscription) |
| 向外部钱包地址发放稳定币              | [向钱包付款](/zh/product/Payout-to-Wallets)                                    |
| 向另一个 StablePay Account 转账 | [向 StablePay Account 付款](/zh/product/Payout-to-StablePay-Account)         |
| 通过虚拟卡管理企业支出               | [企业卡](/zh/product/Corporate-Cards)                                        |
| 对已完成付款发起全额或部分退款           | [退款](/zh/product/Refunds)                                                 |

## 产品选型表

| 产品                       | 方向         | 适合场景              | 商家配置                       |
| :----------------------- | :--------- | :---------------- | :------------------------- |
| Stablecoin Checkout      | Pay In     | 一次性托管收银台收款        | 通过 API 创建 checkout session |
| Invoicing                | Pay In     | 指定客户账单与正式可支付文件    | 在 Merchant Portal 创建账单     |
| 收款链接                     | Pay In     | 公开、可复用的一对多支付页面    | 在 Merchant Portal 创建链接     |
| SaaS 平台集成                | Pay In     | 支持平台上的快速收单上线      | 安装插件、应用或完成 OAuth 配置        |
| Stablecoin Subscriptions | Pay In     | 周期扣费与订阅续费         | 配置订阅和账期规则                  |
| 向钱包付款                    | Pay Out    | 向外部钱包批量或单笔发款      | 配置受益人、余额和出款执行              |
| 向 StablePay Account 付款   | Pay Out    | StablePay 账户间内部转账 | 选择 source account 并校验收款方   |
| 企业卡                      | Spend      | 企业预算、虚拟卡与支出管理     | 开通并管理 Budget 和卡片           |
| 退款                       | Adjustment | 已付款后的调整与退回        | 通过后台或 API 发起退款             |

## 能力开通说明

* `Stablecoin Checkout`、`Invoicing`、`收款链接`、`SaaS 平台集成` 和 `Stablecoin Subscriptions` 属于 Pay In 路径。
* `向钱包付款` 和 `向 StablePay Account 付款` 属于 Pay Out 路径，可能需要商户审批、余额配置和 rollout 开通。
* `企业卡` 需要商户注册、完成 KYB，并经 StablePay 商户团队审核后开通。
* 如果你的业务涉及更高额度、法币能力或额外合规要求，建议尽快完成正式 KYB 审核。

## 可选配置步骤

<CardGroup cols={2}>
  <Card title="Telegram 支付通知" icon="bell" href="/zh/product/Telegram-Payment-Notifications">
    如果你希望运营或客服团队在 Telegram 群中接收实时支付提醒，可在完成注册后通过 StablePay Portal 自助配置 Telegram Bot 通知。
  </Card>

  <Card title="收银台支付设置" icon="sliders" href="https://merchant.stablepay.co/#/settings/payments">
    在 Merchant Portal 的 Settings > Payments 中配置默认支付方式、Transfer 默认链路、过期时间和少付容差。
  </Card>
</CardGroup>

## 收银台支付设置

StablePay 现已支持商家在 [Merchant Portal > Settings > Payments](https://merchant.stablepay.co/#/settings/payments) 中集中配置收银台支付策略。该配置适用于 StablePay hosted checkout 相关场景，包括 Stablecoin Checkout、收款链接，以及在适用范围内的 invoice checkout。

需要注意的是，这些设置仅影响**新创建**的 checkout session 或后续新触发的托管支付页面，不会回溯修改已经创建的会话。

### 1. 默认支付方式

你现在可以为收银台配置默认优先展示的支付方式：

* `Wallet selection`
* `Transfer to Pay`

如果你的客户更常使用直连钱包，可以保留钱包优先；如果你的客户更常通过转账地址付款，可以将默认入口切到 `Transfer to Pay`，减少用户额外切换步骤。

<Frame>
  ![Wallet first settings](https://static.stablepayfi.ai/wallet-first.png)
</Frame>

<Frame>
  ![Transfer first settings](https://static.stablepayfi.ai/transfer-first.png)
</Frame>

### 2. Transfer 默认链和币种

当默认支付方式选择 `Transfer to Pay` 时，商家还可以继续设置默认展示的链和币种，帮助客户直接进入更适合的转账路径。

* 可设置默认链路
* 可设置默认展示币种
* 不同链支持的币种范围不同，例如 TRON 当前仅支持 USDT

<Frame>
  ![Transfer network and token settings](https://static.stablepayfi.ai/set-network-token.png)
</Frame>

### 3. Checkout Session 过期时间

商家现在可以统一设置 hosted checkout 的默认过期时间：

* 最短 `30 minutes`
* 最长 `24 hours`
* 作为商户默认值生效
* 如果商家通过 API 创建 checkout session，仍可通过 `expires_in` 单独覆盖

这项设置适用于 Wallet Pay 和 Transfer to Pay 共用的 checkout session 生命周期。

<Frame>
  ![Checkout expiration settings](https://static.stablepayfi.ai/checkout-expiration-settings.png)
</Frame>

### 4. Transfer to Pay 少付容差设置

Transfer to Pay 的少付容差现在支持按业务场景分别配置：

* `Checkout` 单独配置
* `Invoicing` 单独配置

商家可以选择：

* 必须全额到账
* 按比例允许少付成功
* 按固定金额允许少付成功

只要不是全额到账成功逻辑，商家就需要自行评估少付可能带来的履约损失风险。

<Frame>
  ![Underpayment tolerance overview](https://static.stablepayfi.ai/transfer-less-settings.png)
</Frame>

#### Checkout 容差示例

按比例配置时，可以按订单金额百分比定义最少到账要求。

<Frame>
  ![Percentage tolerance settings](https://static.stablepayfi.ai/percentage-settings.png)
</Frame>

按固定金额配置时，可以定义允许少付的固定差额。

<Frame>
  ![Fixed amount tolerance settings](https://static.stablepayfi.ai/fix_amount-settings.png)
</Frame>

#### Invoicing 容差示例

Invoice checkout 的少付容差可以独立于 Checkout 配置，适合 B2B 账单场景下接受小额尾差的商家。

<Frame>
  ![Invoicing tolerance settings](https://static.stablepayfi.ai/invoicing-settings.png)
</Frame>

<Note>
  商户侧差异处理策略（例如更多异常到账后的自动处理规则）本期尚未上线，因此当前文档只覆盖默认支付方式、Transfer 默认链和币种、checkout 过期时间，以及 Checkout / Invoicing 分开的少付容差设置。
</Note>

## 试用额度与业务场景限制

如果商家尚未完成 KYB 认证，部分资金相关场景会按试用额度进行限制。完成 KYB 后，可按商家审核后的正式配置使用相应能力。

| 业务场景      | 注册商户（未完成 KYB）    |
| :-------- | :--------------- |
| 法币入金      | 不支持              |
| 法币出金      | 不支持              |
| 法币兑换稳定币   | 不支持              |
| 稳定币兑换法币   | 不支持              |
| 稳定币入金     | 支持               |
| 稳定币出金（提现） | 支持，限额 `1000 USD` |
| 收款        | 支持，限额 `1000 USD` |
| 付款        | 支持，限额 `1000 USD` |
| 账单        | 无限制              |

<Note>
  上述试用额度按商户维度汇总管理，金额单位为 USD。也就是说，如果同一商户名下有多个地址、店铺或业务入口，会按商户整体维度合并计算。
</Note>

## 接入前建议

* 先查看 [Supported Wallets](/zh/product/Supported-Wallets) 和 [Supported Networks](/zh/product/Supported-Networks)。
* 如果你使用非 USD 标价，查看 [Currencies & Auto Currency Conversion](/zh/product/Auto-Currency-Conversion)。
* 如果你计划通过平台店铺收单，先查看 [SaaS 平台集成](/zh/product/SaaS-Platform-Integration)。
* 如果你计划使用 Pay Out，先查看 [向钱包付款](/zh/product/Payout-to-Wallets) 和 [向 StablePay Account 付款](/zh/product/Payout-to-StablePay-Account)。
* 如果你计划使用 `企业卡`，先查看 [企业卡](/zh/product/Corporate-Cards)。
* 如果你希望托管页面展示商家品牌，先完成 [品牌设置](/zh/product/Branding-Settings)。
* 上线前确认 [合规与可用地区](/zh/product/Compliance-and-Regional-Availability)。
