> ## Documentation Index
> Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 定价币种策略与币种术语

> 解答两类问题：全球统一、各国分别、区域三种定价方式下怎么传 orderCurrency 等字段，以及订单币种、收单币种、用户币种、结算币种分别指什么。

本页回答两类问题：下单时怎么按「全球统一 / 各国分别 / 区域」三种定价方式传 `orderCurrency`、`orderAmount`、`userCurrency`；以及 Portal 和文档里出现的几个「币种」词（订单币种、收单币种、用户币种、结算币种）分别指什么。小数位规则见官网币种与金额 ([https://waffo.com/docs/zh/developer-docs/core-concepts/currency.md](https://waffo.com/docs/zh/developer-docs/core-concepts/currency.md))，官网原文见定价币种方案 ([https://waffo.com/docs/zh/developer-docs/use-cases/pricing-currency.md](https://waffo.com/docs/zh/developer-docs/use-cases/pricing-currency.md))。

## 我只想定一个 USD 价，用户看到本地币种，参数怎么传？

这是**全球统一定价**：`orderCurrency` 传你的统一定价币种（例如 `USD`），`orderAmount` 传统一价格，**不传** `userCurrency`，由 Waffo 自动换算成用户的本地币种。

```json theme={null}
{
  "orderCurrency": "USD",
  "orderAmount": "9.99",
  "orderDescription": "Pro Plan - Monthly"
}
```

优点是只需维护一套价格；代价是用户在收银台看到的本地币种金额会随汇率波动。

## 每个国家定不同的本地价格，参数怎么传？

这是**各国分别定价**：`orderCurrency` 传用户所在国家的本地币种，`orderAmount` 传该国的本地价格，**不传** `userCurrency`（订单币种本身就是本地币种，属于同币种下单）。

```json theme={null}
{
  "orderCurrency": "IDR",
  "orderAmount": "149000"
}
```

```json theme={null}
{
  "orderCurrency": "PHP",
  "orderAmount": "499.00"
}
```

用户看到的是固定金额，没有汇率波动。代价是你要自己维护各国价格表，并遵守各币种的小数位规则（例如 `IDR` 同币种订单为 0 位小数，`PHP` 为 2 位），金额写错会返回 `A0003`。

## 按区域定价（东南亚一个价、欧洲一个价）怎么传？

这是**区域定价**：`orderCurrency` 传该区域的定价币种（例如东南亚用 `USD`、欧洲用 `EUR`），`orderAmount` 传区域统一价格，**不传** `userCurrency`。

```json theme={null}
{
  "orderCurrency": "EUR",
  "orderAmount": "8.99",
  "orderDescription": "Pro Plan - Monthly (Europe)"
}
```

需要维护的价格比各国分别定价少；但同一区域内不同国家的用户看到的本地金额仍会因汇率不同而不同。

## 三种方式怎么选？

| 策略 | `orderCurrency` | `userCurrency` | `orderAmount` | 用户看到的金额 |
| - | - | - | - | - |
| 全球统一定价 | 统一币种（如 `USD`） | 不传（自动换算） | 统一价格 | 本地币种等值金额，随汇率变化 |
| 各国分别定价 | 本地币种 | 不传 | 本地价格 | 固定金额 |
| 区域定价 | 区域币种 | 不传（自动换算） | 区域价格 | 本地币种等值金额，随汇率变化 |

典型适用场景：SaaS 和数字内容常用全球统一定价；电商、游戏常用各国分别定价；按区域分组运营的业务用区域定价。

三种方式下 `userCurrency` 都不用传，Waffo 会自动处理换算。`payMethodCountry` 是选填字段，不是跨币种订单的必传字段：只有当某个支付方式在多个国家都有同名版本（例如 GrabPay、ShopeePay）、需要指明支付方式所属国家时才需要传；没传而匹配到多个时会返回 `A0033`。币种与金额的完整规则见官网币种与金额（[https://waffo.com/docs/zh/developer-docs/core-concepts/currency.md](https://waffo.com/docs/zh/developer-docs/core-concepts/currency.md)）。

## 可以在不同市场用不同的定价方式吗？

可以，没有强制所有市场采用同一种方式的账户级设置。但你传的 `orderCurrency` 必须是你合约上某个支付方式、某个国家下已有的币种；没有对应合约时会返回 `A0018`，需要通过变更合约解决，而不是改参数。详见[使用某个币种之前必须先开通吗？](https://waffo.com/docs/zh/support/currency-and-method-enablement-faq.md)。

## Sandbox 设置向导里的「定价策略」是什么意思？

Sandbox 设置向导的第 3 步让你选一个定价策略，候选支付方式会据此推导：

| 向导里的选项 | 含义 |
| - | - |
| Global USD Pricing（`GLOBAL_USD`） | 你设一个 USD 价，各市场的客户看到自动换算后的本地币种金额 |
| Local Currency Pricing（`LOCAL_CURRENCY`） | 你在每个市场用该市场的本地币种设置价格，客户按你设置的金额付款，不换算 |

向导只提供这两个选项，用来决定 Sandbox 里为你准备哪些支付方式；它不是下单参数。实际下单时仍按上面三种方式传 `orderCurrency` 等字段。如果第 5 步没有出现你期待的支付方式，请先检查第 3、4 步选的定价策略和目标市场。

## Order Currency、Acquiring Currency、User Currency、Settlement Currency 分别指什么？

先说结论：同一笔订单上最多涉及**三种**币种，下单时只有第一种由你控制。

| 术语 | 含义 | 在哪里出现 |
| - | - | - |
| 订单币种 Order Currency（`orderCurrency`） | 你的定价币种，你要收取的金额以它计 | 创建订单请求；Portal Service → Payin 列表的 Order Currency 列；各类报表 |
| 收单币种 Acquiring Currency | Portal 里较早使用的叫法，**指的就是订单币种**。新版 Portal 的 Payin 列表已把列名统一为 Order Currency；创建支付链接时的「Acquiring Currency」输入项，对应的就是订单币种 | 支付链接创建表单；Payin 列表导出文件的表头仍沿用旧叫法 |
| 用户币种 User Currency（`userCurrency`） | 向付款人扣款的币种；与订单币种相同时可以不填。Portal 里旧称 Local Currency | 创建订单请求（可选）；Payin 列表的 User Currency 列 |
| 用户实际支付币种（`userPaymentCurrency`） | 支付方式一侧实际扣款的币种，在 `payMethodResponse` 里返回 | 订单查询和支付通知 |
| 结算币种 Settlement Currency | 你的资金最终结算给你的币种，在你的结算设置里配置 | 结算明细、结算汇总文件和结算账户 |

也就是说，一笔订单可以用一种币种定价、用另一种币种向付款人扣款、再用第三种币种结算给你。订单币种和结算币种不同时，结算明细会带上对应的货币对和汇率（`Forex Currency Pair`、`Forex Rate`）。

注意：官网定价币种方案 ([https://waffo.com/docs/zh/developer-docs/use-cases/pricing-currency.md](https://waffo.com/docs/zh/developer-docs/use-cases/pricing-currency.md))在「全球统一定价」里把 `orderCurrency` 称作「商户结算币种」。这里的 `orderCurrency` 是**你的定价币种**，不一定等于你的结算币种——以订单字段定义（订单币种）为准；结算币种以你的结算设置为准。

## 我该去哪里核对这些金额字段？

* 订单上各个金额字段（`orderAmount`、`finalDealAmount`、`userPaymentAmount` 等）分别是什么意思：见[我该核对哪个金额和币种字段？](https://waffo.com/docs/zh/support/order-amount-and-currency-fields-faq.md)。
* 小数位规则、同币种与跨币种订单的区别：见官网币种与金额 ([https://waffo.com/docs/zh/developer-docs/core-concepts/currency.md](https://waffo.com/docs/zh/developer-docs/core-concepts/currency.md))。
* 含税定价、两价齐传：见[商户申报税与含税下单](https://waffo.com/docs/zh/support/merchant-declared-tax-and-tax-inclusive-pricing-faq.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.