适用场景
这个能力尤其适合以下场景：- 希望直接用本地法币定价，而不是统一按 USD 标价。
- 同时面向多个国家或地区经营，需要更贴近市场习惯的价格展示。
- 用 Payment Links 销售课程、服务、活动、数字商品或轻量电商商品。
- 希望在 Merchant Portal、列表页、详情页和 payment drawer 中保持统一的原始标价展示。
支持的标价币种
当前文档覆盖的支持范围包括：- 默认：USD
- 欧洲与北美：EUR、GBP、AUD、CAD
- 亚太：JPY、HKD、SGD、KRW
- 东南亚：IDR、PHP、VND、THB、MYR
- 拉美：MXN、BRL
- 中东：AED、SAR、QAR、KWD、OMR、BHD
最低订单金额与小数位
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 一起变化。
工作方式
- 商家在 Merchant Portal 创建或编辑 Payment Link。
- 在 Products 区域选择一个统一的 Payment currency，默认值为 USD。
- 该 Payment Link 下的所有商品都使用同一个标价币种。
- StablePay 按该币种校验商品价格格式、订单总金额和最低创建金额。
- 创建成功后，列表页、详情页、Preview 和 payment drawer 会展示原始标价币种。
- 客户仍通过原有的 StablePay hosted checkout 完成付款。
核心规则
一个 Payment Link 只能使用一个币种
同一个 Payment Link 下，所有商品必须使用同一个标价币种。- Payment currency 在 Payment Link 顶层统一配置。
- 新增商品时会自动继承当前 Payment currency。
- 不支持在同一个 Payment Link 中混用多个币种。
- 如果提交了混合币种商品，系统会返回校验错误。
最低订单金额按订单总金额校验
最低金额不是按单个商品单独判断，而是按整个订单的最低总金额判断。- 普通商品按
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 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 相加。