> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clinkbill.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 货币&汇率
> 让客户使用本地货币支付
## 概述
[结账会话](/cn/guides/payments/checkout_session)提供统一的托管结账体验。在商户业务模式、结算配置、支付渠道和目标币种均支持的情况下，Checkout 可以展示或处理相应币种的价格。订阅场景通常需要预先配置对应币种的固定价格，具体支持范围以商户合同及渠道配置为准。
提供本地货币支持具有以下优势：
* 提高转化率：客户更倾向于使用熟悉的货币支付
* 接入本地支付方式：许多本地支付方式仅支持其本地货币
* 市场特定定价：针对不同市场实施具有竞争力的定价策略
* 降低成本：避免部分支付提供商向客户收取的外汇手续费
## 客户体验
当客户从使用与您设定价格货币不同的地区访问您的结账页面时，他们将同时看到其本地货币和您的默认货币。货币选项根据客户的公共 IP 地址位置确定。
如果客户的本地货币与您设定的价格货币之一匹配，则仅显示该货币。
对于一次性支付，可以在创建结账会话时将 `localPriceOnly` 设置为 `true`，优先展示本地币种价格选项。Clink 会根据客户访问收银台时的 IP 解析本地币种。如果没有可展示的本地币种价格，Clink 会在原始计价币种可用时兜底展示该币种。该配置不适用于订阅型结账会话。
## 预设本地货币价格
商家可以为产品配置多个本地货币以满足各种业务需求。
Clink 允许您为单个**价格**设置多种货币。要进行配置，请访问产品页面的[多币种定价](/cn/guides/resources/product#多币种定价)部分。
配置完成后，只需使用**单一价格 ID**创建结账会话。客户将自动看到其本地货币的预设价格，无需额外转换。
**订阅**: 要在周期性付款中支持本地货币，您必须提前在价格设置中进行配置。自适应定价不支持订阅场景。
**结算货币**：对于使用与您的结算货币不同的预设本地货币支付的情况，Clink 会在结算过程中自动处理转换。
如果客户的本地货币未包含在您的配置中，则将启用自适应定价。
## 自适应定价
如[客户体验](#customer-experience)部分所述，客户将看到其本地货币与您的默认价格货币并列显示。对于多币种价格，仅显示主要货币。
**结算货币**：使用自适应定价时，订单将以您的主要价格金额结算。Clink 在支付处理过程中自动处理客户端的货币转换。
### 限制
以下情况不适用自适应定价：
* 订阅支付：由于续费周期汇率波动，以及续订金额使用的本地汇率需要客户同意
* 客户货币已包含在预设价格货币中的会话
## API 一次性支付
通过 API 创建[一次性支付](/cn/api-reference/endpoint/create-payment)时，`paymentCurrency` 表示希望向客户收取的实际支付币种。如果不传 `paymentCurrency`，支付将使用原始计价币种。直接传金额支付时，`currency` 仍然必填，用于表示原始计价币种；使用价格支付时，Clink 会使用价格中的币种。
Clink 会优先使用已配置的固定多币种价格；如果没有对应固定价格，则会自动根据汇率从原始计价币种换算到指定支付币种。所选支付方式必须支持请求中的 `paymentCurrency`。
对于 `CASHAPP`、`GCASH`、`TNG`、`WECHAT`、`KAKAO`、`ALIPAY`、`QRIS` 和 `PROMPTPAY`，可以不传 `paymentInstrumentId`，Clink 会自动创建支付工具，并在响应中返回对应 ID。其他支付方式仍需要传入已有的 `paymentInstrumentId`。
```json 指定支付币种 theme={null}
{
"customerId": "cus_xxxxx",
"productId": "prd_xxxxx",
"priceId": "price_xxxxx",
"paymentInstrumentId": "pi_xxxxx",
"paymentMethodType": "CARD",
"paymentCurrency": "HKD",
"returnUrl": "https://merchant.example.com/payment/return"
}
```
## 支持的货币
Clink 支持以下主要货币：
| | | |
| :- | :- | :- |
| 美元 (USD) | 欧元 (EUR) | 人民币 (CNY) |
| 加拿大元 (CAD) | 日元 (JPY) | 澳元 (AUD) |
| 新加坡元 (SGD) | 港币 (HKD) | 韩元 (KRW) |
| 英镑 (GBP) | 阿联酋迪拉姆 (AED) | 泰铢 (THB) |
| 印尼盾 (IDR) | 菲律宾比索 (PHP) | 马来西亚令吉 (MYR) |
| 巴西雷亚尔 (BRL) | 印度卢比 (INR) | |
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.