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

# Payment Links 多标价币种

> 使用支持的本地法币为 Payment Links 进行统一标价，并在创建与管理流程中保持一致的币种规则。

Payment Links 现在支持使用多种本地法币进行标价，不再局限于 USD。商家可以在创建 Payment Link 时选择一个支持的标价币种，并用该币种配置商品价格、订单总金额和列表展示。

这个能力面向希望按本地市场报价的场景，例如欧洲、东南亚、中东、日韩、拉美或多区域业务。它帮助商家在 Merchant Portal 中用更贴近业务的价格体系创建链接，同时保持收款体验的一致性。当前 Payment Links 的多币种支持范围与 [Stablecoin Checkout](/zh/product/Stablecoin-Checkout) 保持一致。

## 适用场景

这个能力尤其适合以下场景：

* 希望直接用本地法币定价，而不是统一按 USD 标价。
* 同时面向多个国家或地区经营，需要更贴近市场习惯的价格展示。
* 用 Payment Links 销售课程、服务、活动、数字商品或轻量电商商品。
* 希望在 Merchant Portal、列表页、详情页和 payment drawer 中保持统一的原始标价展示。

如果你只是需要一次性托管支付能力，可以先查看 [支付链接](/zh/product/Payment-Links)。如果你需要了解 StablePay 支持的币种与自动换汇能力，也可以查看 [币种与自动货币转换](/zh/product/Auto-Currency-Conversion)。

## 支持的标价币种

当前文档覆盖的支持范围包括：

* 默认：USD
* 欧洲与北美：EUR、GBP、AUD、CAD
* 亚太：JPY、HKD、SGD、KRW、TWD
* 东南亚：IDR、PHP、VND、THB、MYR
* 拉美：MXN、BRL
* 中东：AED、SAR、QAR、KWD、OMR、BHD

支持范围会随产品演进继续扩展。实际可选币种以 Merchant Portal 中的可用配置为准。

## 最低订单金额与小数位

Payment Links 会按标价币种校验最低订单总金额和小数位规则。下面的表格反映当前文档中的已支持配置：

| 币种  | 最低订单总金额 | 小数位 |
| :-- | ------: | --: |
| USD |    0.10 |   2 |
| EUR |    0.10 |   2 |
| GBP |    0.10 |   2 |
| AUD |    0.20 |   2 |
| CAD |    0.20 |   2 |
| JPY |      20 |   0 |
| HKD |    1.00 |   2 |
| SGD |    0.20 |   2 |
| KRW |     200 |   0 |
| IDR |   2,000 |   0 |
| PHP |   10.00 |   2 |
| VND |   3,000 |   0 |
| THB |    5.00 |   2 |
| MYR |    1.00 |   2 |
| MXN |    2.00 |   2 |
| BRL |    1.00 |   2 |
| AED |    0.50 |   2 |
| SAR |    0.50 |   2 |
| QAR |    0.50 |   2 |
| KWD |   0.050 |   3 |
| OMR |   0.050 |   3 |
| BHD |   0.050 |   3 |

说明：

* 这里的最低金额是 Payment Link 创建侧的最低订单总金额，不是链上实际支付的最小金额。
* 同一个 Payment Link 下如果有多个商品，会按整个订单总金额校验，而不是按单个商品分别校验。
* 小数位规则会随着 Payment currency 一起变化。

## 工作方式

1. 商家在 Merchant Portal 创建或编辑 Payment Link。
2. 在 Products 区域选择一个统一的 Payment currency，默认值为 USD。
3. 该 Payment Link 下的所有商品都使用同一个标价币种。
4. StablePay 按该币种校验商品价格格式、订单总金额和最低创建金额。
5. 创建成功后，列表页、详情页、Preview 和 payment drawer 会展示原始标价币种。
6. 客户仍通过原有的 StablePay hosted checkout 完成付款。

这次迭代主要更新的是 Merchant Portal 中的创建与管理流程，而不是买家侧 checkout 展示逻辑。

## 核心规则

### 一个 Payment Link 只能使用一个币种

同一个 Payment Link 下，所有商品必须使用同一个标价币种。

* Payment currency 在 Payment Link 顶层统一配置。
* 新增商品时会自动继承当前 Payment currency。
* 不支持在同一个 Payment Link 中混用多个币种。
* 如果提交了混合币种商品，系统会返回校验错误。

这让商家在列表展示、GMV 统计、对账和客服查询时，能保持一致的价格语义。

### 最低订单金额按订单总金额校验

最低金额不是按单个商品单独判断，而是按整个订单的最低总金额判断。

* 普通商品按 `unit price × quantity` 计入订单总金额。
* 如果商品支持 adjustable quantity，则按 `unit price × minimum quantity` 计算最低订单金额。
* 只有当订单总金额达到当前币种的最低要求时，Payment Link 才能保存成功。

这条规则更适合多商品场景，避免因为某个单独商品价格较低而误拦截合理的组合销售。

### 不同币种有不同的小数位规则

不同币种的小数位要求不同，前后端都会校验。

* JPY、KRW、VND、IDR 等 0 小数位币种不支持小数金额。
* USD、EUR、HKD 等常见法币通常支持 2 位小数。
* KWD、OMR、BHD 等币种支持 3 位小数。

当商家切换 Payment currency 后，Unit price 输入格式和保存校验也会一起变化。

## 对商家意味着什么

| 能力          | 说明                                                |
| :---------- | :------------------------------------------------ |
| 本地市场定价      | 直接用业务所在市场熟悉的法币创建 Payment Links。                   |
| 统一币种管理      | 一个链接下的所有商品保持同一币种，减少混淆。                            |
| 更清晰的列表与详情展示 | Price、Header、Products、Payment drawer 等位置展示原始标价币种。 |
| 一致的金额校验     | 最低订单金额和小数位规则随币种一起生效。                              |
| 更稳的历史记录     | 历史 Payment 会保留交易发生时的标价币种与金额快照。                    |

## 编辑现有 Payment Link 时的规则

Payment Link 创建后，并不是任何时候都能随意改币种。

* 历史 Payment Links 会按 USD 兼容处理。
* 如果一个 Payment Link 还没有成功支付记录，可以修改 Payment currency。
* 修改币种后，商品价格数字不会自动按汇率换算，商家需要自行确认价格是否合理。
* 修改币种后，系统会按新币种的最低订单金额和小数位规则重新校验。
* 如果该 Payment Link 已产生成功支付，则不能再修改币种。若要使用其他币种，应创建新的 Payment Link。

## 这次迭代不包含什么

这次更新不包含以下范围：

* 不支持同一个 Payment Link 内的多币种商品。
* 不支持买家在 hosted checkout 页面切换标价币种。
* 不支持按买家 IP 或浏览器语言自动切换本地币种。
* 不支持商家自定义汇率。
* 不支持订阅型 Payment Links。
* 不改变当前 hosted checkout 的核心支付流程。

## 重要说明

* 如果未显式选择币种，默认按 USD 处理。
* 支持的最低订单金额由系统配置维护，不等同于链上最小支付金额。
* 保存时会同时进行前端提示和后端最终校验。
* 如果你的业务需要跨多个币种做汇总分析，请避免直接将不同币种的 GMV 相加。

## 相关页面

* [支付链接](/zh/product/Payment-Links)
* [限制 Payment Link 的支付次数](/zh/product/Payment-Links-Limit-Payment-Count)
* [币种与自动货币转换](/zh/product/Auto-Currency-Conversion)
* [稳定币收银台](/zh/product/Stablecoin-Checkout)