Subotiz 支持 多币种支付，客户可以用本地货币付款；商户后台统一以 店铺主货币 定价和出报表，非主货币订单按创建结账会话时锁定的 汇率 折算。该模式有助于提升结账转化率、降低支付门槛，并优化跨境支付体验。
币种说明
Subotiz 中涉及两种币种：
币种 |
说明 |
|---|---|
店铺主货币 |
商户为店铺设置的币种。所有商品定价及后台报表均以店铺主货币为准。店铺产生交易单或创建折扣后，店铺主货币不可修改。 |
支付币种 |
客户每笔订单实际付款使用的币种，即 API 中的 target_currency（API 文档中称为“订单结算币种”）。同一店铺的不同订单可以使用不同的支付币种。 |
- 商品及定价统一使用店铺主货币设置价格，所有商品与定价方案保持一致。
- 客户可在结账时使用店铺主货币以外的币种付款，系统将商品价格按汇率转换为支付币种。
- 订阅、交易单、退款单、发票及交易单导出文件中的金额，均以客户的支付币种显示；交易单详情另外显示订单主货币金额。
- 后台报表以店铺主货币统计，便于商户统一查看及对账。
使用不同币种向客户收费
币种转换发生在创建 结账会话（Checkout Session） 时。创建结账会话时可配置以下内容：
- 客户展示及付款使用的支付币种。
- 可选的自定义汇率。
设置自定义汇率时，系统按商户指定的汇率进行转换；未设置时，系统默认按当日实时汇率完成换算。汇率在创建结账会话时锁定，客户之后完成付款时沿用该汇率。
客户在结账页面看到以支付币种显示的应付金额；汇率显示在商户后台的 交易单详情 及订阅详情的 下次账单信息 中。
创建结账会话参数说明
字段 |
是否必填 |
说明 |
|---|---|---|
target_currency |
可选（以店铺主货币以外的币种收款时传入） |
指定结账会话的订单结算币种，传入平台支持的 ISO 4217 货币代码，如 USD、CNY。系统会以店铺主货币为基准，将订单金额换算为该币种进行展示与计价；未传 merchant_rate 时，系统默认按当日实时汇率完成换算。未传入时，按店铺主货币收款。 |
merchant_rate |
可选 |
指定店铺主货币兑换 target_currency 的自定义汇率，传入值须为大于 0 的数字，且必须与 target_currency 同时传入。该字段仅在订单结算币种与店铺主货币不一致时使用。汇率方向为“1 单位店铺主货币可兑换的 target_currency 金额”，例如 0.92 表示 1 单位店铺主货币 = 0.92 单位支付币种。 |
示例：店铺主货币为 USD，订阅产品定价 $100，以 EUR 向客户收费
未设置自定义汇率：
- 请求参数：
"target_currency": "EUR" - 系统按当日实时汇率将 $100 USD 转换为 EUR。
- 客户看到并支付转换后的 EUR 金额。
设置自定义汇率：
- 请求参数：
"target_currency": "EUR","merchant_rate": "0.92" - $100 USD → €92.00 EUR。
- 客户将被收取 €92.00。
注意： 汇率将直接影响客户看到及实际支付的金额。
在后台查看汇率
客户使用店铺主货币以外的币种付款时，后台会显示该订单或订阅使用的汇率，数值表示 1 单位店铺主货币可兑换的支付币种金额：
- 下单实时汇率： 未设置自定义汇率时显示，例如 1 USD = 154.919019 JPY。
- 商户指定汇率： 设置了
merchant_rate时显示，例如 1 USD = 137.5 JPY。
交易单详情会同时显示支付币种金额及 订单主货币金额，鼠标悬停在 ? 图标上可查看对应汇率，详见《交易单｜查看与管理交易单》。订阅详情的 下次账单信息 中同样显示对应汇率。
重要说明
- 店铺主货币： 商品定价始终以店铺主货币设置。
- 转换时机： 币种转换仅在结账阶段发生。
- 汇率锁定： 汇率在创建结账会话时锁定，客户付款金额以锁定后的支付币种金额为准。
- 订阅续费： 支付币种和汇率在结账时确定，订阅续费沿用首次结账时的支付币种和汇率。
- 退款： 退款以支付币种原路退回。折算为店铺主货币时，按原订单创建结账会话时锁定的汇率计算。
- 实际到账资金： 商户实际到账的资金由支付渠道按其结算汇率换算，与后台报表按店铺主货币折算的金额属于不同口径，对账时请分别核对。
开发者参考
币种相关设置需在创建结账会话时通过 API 配置。具体实现方式请参阅 创建结账会话 API 文档。