Multi-Currency Pricing Product Introduction
Update Time：2025.12.291. Overview of Guidelines
To support payment institutions in countries where the local currency is a non-deliverable currency to quickly integrate, WeChat Pay enables merchants to price their products in one or several currencies, and settle transactions in ONE deliverable currency. The incoming funds will be automatically coverted into the default settlement currency.
2. Product Introduction
（Take Philippines merchant as an example)
1. The merchant initiates an order based on the actual pricing currency and amount—100 PHP.
2. The WeChat Pay user completes the payment using the PHP/CNY exchange rate offered by WeChat Pay—12 CNY.
3. WeChat Pay converts the PHP amount into a settlement amount in USD using the fair PHP/USD exchange rate provided by coorperative bank or central bank, resulting in a settlement amount for the merchant—2 USD.
4. WeChat Pay settles the amount to the merchant on T+1 based on the converted settlement amount—2 USD.
3. Product FAQs
3.1 How can merchants check the settlement exchange rate?
Merchants need to upgrade to API V3 to configure mult-currency pricing product. Merchants can choose to fetch the settlement exchange rate in real time or query the exchange rate for each transaction in the transaction bill.
1) Settlement exchange rate for payment transactions:
Merchants can use the Query Order API or the Payment Result Notification API to fetch the settlement exchange rate:
Field | Description |
|---|---|
amount.exchange_rate.type | Fixed value: "SETTLEMENT_RATE" |
amount.exchange_rate.rate | Value of the settlement exchange rate |
2) Settlement exchange rate for refund transactions:
Merchants can use the Query Single Refund API or the Refund Notification API to fetch the exchange rate:
Field | Description |
|---|---|
amount.exchange_rate.type | If the refund currency = the settlement currency, this field displays USERPAYMENT_RATE (user payment exchange rate). If the refund currency ≠ the settlement currency, it displays SETTLEMENT_RATE (settlement exchange rate). |
amount.exchange_rate.rate | Value of the exchange rate |
3) Querying the settlement exchange rate through transaction bills:
For merchants unable to upgrade to API V3, they may request SFTP bill configuration. Through SFTP, WeChat Pay will provide merchants with V3 version bills (while APIs such as placing orders remain in V2).
Field | Description |
|---|---|
Exchange Rate | If the pricing currency = the settlement currency, this represents the payment exchange rate (pricing currency–payment currency exchange rate). If the pricing currency ≠ the settlement currency, this represents the settlement exchange rate (settlement currency–pricing currency exchange rate). |
Refund Exchange Rate | If the pricing currency = the settlement currency, this represents the payment exchange rate (pricing currency–payment currency exchange rate). If the pricing currency ≠ the settlement currency, this represents the settlement exchange rate (settlement currency–pricing currency exchange rate). |
3.2 After configuring addtional pricing currency, can merchants still place orders using settlement currencies?
Yes. There are three types of pricing currencies that are available to overseas instituions/merchants:
Field | Order Permissions |
|---|---|
Settlement Currency | Enabled by default |
RMB (Chinese Yuan) | Enabled by default |
Other foreign currencies | Enabled through configuration |
3.3 How many pricing currencies can merchants configure at most?
WeChat Pay supports a total of 132 pricing currencies (excluding RMB). The number of currency merchant can configure is unlimited.
3.4 What is the update frequency of the settlement exchange rate?
The settlement exchange rate is updated on a daily basis. The update time depends on different currency pairs. Generally, one batch is updated in the morning at 10:30, and another batch in the afternoon at 17:30.
3.5 What settlement exchange rate will be applied to refund transactions?
Refund transactions will be settled with the FX rate of the original payment. WeChat Pay will bear the FX rate fluctuation risk.
4. Application Process
Please contact WeChat Pay operation team to submit an application.
