Product Documentation General instructions Access Guidelines FAQs

Query Exchange Rate

Update Time：2025.02.20

The interface could inquiry the exchange rate which Wechat Payment used in real time. The rate is updated once each day at 10 a.m. in the time zone (GMT+8).

API intro

Request Url: https://apihk.mch.weixin.qq.com/pay/queryexchagerate

Request Method: POST

Certificate Requirements: No certificate is required.

Applicable Object:Common mode Institutional mode

Request Parameters

Name	ID	Type	Required	Description
Official Account ID	appid	String(32)	Yes	Specifies Official Account ID assigned by WeChat Example: wx8888888888888888
Merchant ID	mch_id	String(32)	Yes	Specifies Merchant ID assigned by WeChat Example: 1900000109
Sub Merchant ID	sub_mch_id	String(32)	No	Specifies Sub Merchant ID assigned by WeChat Specifies Sub merchant ID of institution's sub-merchant assigned by WeChat Pay Note: Only for Institutional mode Example: 1230000100
Currency Type	fee_type	String(10)	Yes	Foreign currency type. ISO-4217 standard compliant and be described by three characters based code. Example: USD
Date	date	String(14)	Yes	In the format of yyyyMMdd. For example, December 25, 2009 is expressed as 20091225 in the time zone (GMT+8). Example: 20150807
Signature	sign	String(64)	Yes	Specifies a signature. For more information, see Signature Algorithm. Example: C380BEC2BFD727A4B6845133519F3AD6

Example：

1<xml>
2   <appid>wx2421b1c4370ec43b</appid>
3   <mch_id>10000100</mch_id>
4   <fee_type>CNY</fee_type> 
5   <date>20150807</date>
6   <sign>FDD167FAA73459FD921B144BAF4F4CA2</sign>
7</xml>

Return Data

Name	ID	Type	Required	Description
Return Status Code	return_code	String(16)	Yes	SUCCESS or FAIL Specifies communicating label instead of transaction label. The status of a transaction is determined by the value of result_code. Example: SUCCESS
Return Data	return_msg	String(128)	No	If not empty, this is the error description Signature failure Parameter format checking error Example: Signature failure

If return_code is SUCCESS, return data will also include the following fields:

Name	ID	Type	Required	Description
Official Account ID	appid	String(32)	Yes	The Official Account ID submitted when calling the interface Example: wx8888888888888888
Merchant ID	mch_id	String(32)	Yes	The Merchant ID submitted when calling the interface Example: 1900000109
Sub Merchant ID	sub_mch_id	String(32)	No	The Sub Merchant ID submitted when calling the interface Specifies Sub merchant ID of institution's sub-merchant assigned by WeChat Pay Note: Only for Institutional mode Example: 1230000100
Currency Type	fee_type	String(10)	Yes	Foreign currency type. ISO-4217 standard compliant and be described by three characters based code. Example: USD
Exchange Rate Time	rate_time	String(14)	Yes	In the format of yyyyMMdd. For example, December 25, 2009 is expressed as 20091225 in the time zone (GMT+8). Example: 20150807
Exchange Rate	rate	String(32)	Yes	The value is 10 to the 8th power times of the exchange rate from foreign currency to RMB. For example, the exchange rate from foreign currency to RMB is 6.5, the value will be 650000000 Example: 650000000
Signature	sign	String(64)	Yes	Specifies a signature. For more information, see Signature Algorithm. Example: C380BEC2BFD727A4B6845133519F3AD6

Example：

1<xml>
2   <appid>wx2421b1c4370ec43b</appid>
3   <mch_id>10000100</mch_id>
4   <fee_type>USD</fee_type> 
5   <rate_time>20150807</rate_time>
6   <rate>650000000</rate> 
7   <sign>FDD167FAA73459FD921B144BAF4F4CA2</sign>
8</xml>