> ## 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)提供统一的托管结账体验，支持自动本地货币适配。Clink 自动处理所有货币转换并本地化价格，无需额外配置。

提供本地货币支持具有以下优势：

* 提高转化率：客户更倾向于使用熟悉的货币支付
* 接入本地支付方式：许多本地支付方式仅支持其本地货币
* 市场特定定价：针对不同市场实施具有竞争力的定价策略
* 降低成本：避免部分支付提供商向客户收取的外汇手续费

## 客户体验

当客户从使用与您设定价格货币不同的地区访问您的结账页面时，他们将同时看到其本地货币和您的默认货币。货币选项根据客户的公共 IP 地址位置确定。

如果客户的本地货币与您设定的价格货币之一匹配，则仅显示该货币。

<img src="https://mintcdn.com/clink/peBNaRlFWIQS8vOQ/images/en_currency_conversion.png?fit=max&auto=format&n=peBNaRlFWIQS8vOQ&q=85&s=88a615c9a637c0493663c893384353fc" alt="currency_conversion" width="425" height="326" data-path="images/en_currency_conversion.png" />

## 预设本地货币价格

商家可以为产品配置多个本地货币以满足各种业务需求。

Clink 允许您为单个**价格**设置多种货币。要进行配置，请访问产品页面的[多币种定价](/cn/guides/resources/product#多币种定价)部分。

<Accordion icon="coins" title="多币种定价示例">
  <img src="https://mintcdn.com/clink/peBNaRlFWIQS8vOQ/images/en_multi_currency_price.png?fit=max&auto=format&n=peBNaRlFWIQS8vOQ&q=85&s=809d29f0cdbde7973a77a48239a4caa5" alt="multi_currency_price_example" width="593" height="439" data-path="images/en_multi_currency_price.png" />
</Accordion>

配置完成后，只需使用**单一价格 ID**创建结账会话。客户将自动看到其本地货币的预设价格，无需额外转换。

<Tip>
  **订阅**: 要在周期性付款中支持本地货币，您必须提前在价格设置中进行配置。自适应定价不支持订阅场景。
</Tip>

<Warning>
  **结算货币**：对于使用与您的结算货币不同的预设本地货币支付的情况，Clink 会在结算过程中自动处理转换。<br />
</Warning>

如果客户的本地货币未包含在您的配置中，则将启用自适应定价。

## 自适应定价

如[客户体验](#customer-experience)部分所述，客户将看到其本地货币与您的默认价格货币并列显示。对于多币种价格，仅显示主要货币。

<Note>
  **结算货币**：使用自适应定价时，订单将以您的主要价格金额结算。Clink 在支付处理过程中自动处理客户端的货币转换。<br />
</Note>

### 限制

以下情况不适用自适应定价：

* 订阅支付：由于续费周期汇率波动，以及续订金额使用的本地汇率需要客户同意
* 客户货币已包含在预设价格货币中的会话

## API 一次性支付

通过 API 创建[一次性支付](/cn/api-reference/endpoint/create-payment)时，`paymentCurrency` 表示希望向客户收取的实际支付币种。如果不传 `paymentCurrency`，支付将使用原始计价币种。直接传金额支付时，`currency` 仍然必填，用于表示原始计价币种；使用价格支付时，Clink 会使用价格中的币种。

Clink 会优先使用已配置的固定多币种价格；如果没有对应固定价格，则会自动根据汇率从原始计价币种换算到指定支付币种。所选支付方式必须支持请求中的 `paymentCurrency`。

```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 支持以下主要货币：

|                                                                                               |                                                                                                |                                                                                                |
| :-------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------- |
| <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/US.svg" /> 美元 (USD)    | <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/EU.svg" /> 欧元 (EUR)     | <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/CN.svg" /> 人民币 (CNY)    |
| <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/CA.svg" /> 加拿大元 (CAD)  | <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/JP.svg" /> 日元 (JPY)     | <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/AU.svg" /> 澳元 (AUD)     |
| <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/SG.svg" /> 新加坡元 (SGD)  | <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/HK.svg" /> 港币 (HKD)     | <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/KR.svg" /> 韩元 (KRW)     |
| <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/GB.svg" /> 英镑 (GBP)    | <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/AE.svg" /> 阿联酋迪拉姆 (AED) | <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/TH.svg" /> 泰铢 (THB)     |
| <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/ID.svg" /> 印尼盾 (IDR)   | <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/PH.svg" /> 菲律宾比索 (PHP)  | <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/MY.svg" /> 马来西亚令吉 (MYR) |
| <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/BR.svg" /> 巴西雷亚尔 (BRL) | <Icon icon="http://purecatamphetamine.github.io/country-flag-icons/3x2/IN.svg" /> 印度卢比 (INR)   |                                                                                                |
