Subotiz 支持 多币种支付，可通过自动 汇率转换，让客户以本地货币完成支付，同时在后台统一使用单一 结算币种 进行定价、计费与财务核算。该模式有助于提升结账转化率、降低支付门槛，并优化跨境支付体验。
币种说明
Subotiz 中所有商品定价均基于店铺的结算币种，该币种在所有商品与定价方案中保持一致。
- 商品价格、订阅及账单记录均基于结算币种。
- 不支持在商品或定价层设置不同币种。
- 客户可在结账时使用其他币种进行支付。
该设计确保即使客户使用不同币种支付，所有账单、订阅及财务报表仍保持统一与可对账性。
使用不同币种向客户收费
币种转换发生在创建 Checkout Session 时。结账时可配置以下内容：
- 客户展示及支付所使用的币种。
- 可选的自定义汇率。
若未设置自定义汇率，系统将自动使用实时市场汇率进行转换。
Checkout 参数说明
字段 |
是否必填 |
说明 |
|---|---|---|
target_currency |
必填 |
客户支付所使用的币种（如 USD、EUR、CAD） |
merchant_rate |
可选 |
自定义汇率，从结算币种转换至目标币种，采用小数表示（例如 0.92 表示 1 单位结算币种 = 0.92 单位目标币种） |
示例：某 SaaS 订阅产品定价为 $100 USD，以 EUR 向客户收费
未设置自定义汇率：
- 设置
target_currency = EUR - 系统按照实时汇率将 $100 USD 转换为 EUR。
- 客户看到并支付转换后的 EUR 金额。
设置自定义汇率：
- 设置
target_currency = EUR且merchant_rate = 0.92 - $100 USD → €92.00 EUR
- 客户将被收取 €92.00。
注意： 汇率将直接影响客户看到及实际支付的金额。
重要说明
- 商品定价始终基于结算币种，且不可修改。
- 币种转换仅在结账阶段发生。
- 所有记录（订阅、发票、账单历史）均以结算币种保存。
- 若未设置自定义汇率，实际支付金额可能因市场汇率波动产生轻微差异。
- 无论客户使用何种币种支付，最终结算金额均以结算币种计算。
开发者参考
币种相关设置需在创建结账会话时通过 API 配置。具体实现方式请参考 创建结账会话 API 文档。