汇率查询

更新时间:2025.02.20

商户网站的商品以外币标价时,通过该接口可以实时查询到微信使用的转换汇率。汇率更新时间为北京时间上午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

举例如下:

XML
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

举例如下:

XML
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>

 

 

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2025 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global

Contact Us

Customer Service Tel

+86 571 95017

9:00-18:00 Monday-Friday GMT+8

Business Development

wxpayglobal@tencent.com

Developer Support

wepayTS@tencent.com

Wechat Pay Global

About Tenpay
Powered By Tencent & Tenpay Copyright© 2005-2025 Tenpay All Rights Reserved.