查询汇率

更新时间：2025.02.19

商户网站的商品以外币标价时，通过该接口可以实时查询到微信使用的转换汇率。汇率更新时间为北京时间上午10:00，一天更新一次。

接口说明

适用对象: 直连模式机构模式

请求URL: https://apihk.mch.weixin.qq.com/pay/queryexchagerate

请求方式: POST

是否需要证书: 否

请求参数

参数名	变量名	类型	必填	描述
公众账号ID	appid	string(32)	是	微信分配的公众账号ID（企业号corpid即为此appId）示例值：wxd678efh567hg6787
商户号	mch_id	string(32)	是	微信支付分配的商户号示例值：1230000109
币种	fee_type	string(10)	是	外币币种，详细请见参数规定示例值：USD
日期	date	string(14)	是	格式为yyyyMMdd，如2009年12月25日表示为20091225。时区为GMT+8 beijing 示例值：20150807
签名	sign	string(64)	是	签名，详见签名生成算法示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS

举例如下：

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_code	string(16)	是	SUCCESS/FAIL 此字段是通信标识，非交易标识，交易是否成功需要查看trade_state来判断示例值：SUCCESS
返回信息	return_msg	string(128)	是	返回信息，如非空，为错误原因签名失败参数格式校验错误示例值：签名失败

以下字段在return_code为SUCCESS的时候有返回

字段名	变量名	类型	必填	描述
公众账号ID	appid	string(32)	是	微信分配的公众账号ID 示例值：wxd678efh567hg6787
商户号	mch_id	string(32)	是	微信支付分配的商户号示例值：1230000109
子商户号	sub_mch_id	string(32)	否	微信支付分配的子商户号示例值：1230000100
币种	fee_type	string(10)	是	外币币种，详细请见参数规定示例值：SUCCESS
汇率时间	rate_time	string(14)	是	格式：yyyyMMdd 示例值：20150807
现汇卖出价(汇率)	rate	string(16)	是	外币兑换RMB的比例乘以10的8次方即为此值，例如美元兑换人民币的比例为6.5，则rate=650000000 示例值：650000000
签名	sign	string(64)	是	签名，详见签名生成算法示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS

举例如下：

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>628.1225</rate>
7   <sign>FDD167FAA73459FD921B144BAF4F4CA2</sign>
8</xml>