查询汇率

应用场景

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

接口链接

https://api.mch.weixin.qq.com/pay/queryexchagerate

是否需要证书

不需要

请求参数

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

举例如下:

<xml>
   <appid>wx2421b1c4370ec43b</appid>
   <mch_id>10000100</mch_id>
   <fee_type>CNY</fee_type>
   <date>20150807</date>
   <sign>FDD167FAA73459FD921B144BAF4F4CA2</sign>
</xml>

返回结果

字段名 变量名 必填 类型 示例值 描述
返回状态码 return_code String(16) SUCCESS

SUCCESS/FAIL

此字段是通信标识,非交易标识,交易是否成功需要查看trade_state来判断

返回信息 return_msg String(128) 签名失败

返回信息,如非空,为错误原因

签名失败

参数格式校验错误

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

字段名 变量名 必填 类型 示例值 描述
公众账号ID appid String(32) wxd678efh567hg6787 微信分配的公众账号ID
商户号 mch_id String(32) 1230000109 微信支付分配的商户号

子商户号

sub_mch_id String(32) 1230000100 微信支付分配的子商户号

币种

fee_type

String(10)

SUCCESS 外币币种,详细请见参数规定

汇率时间

rate_time

String(14)

20150807

格式:yyyyMMdd

现汇卖出价(汇率)

rate

String(16) 650000000

外币兑换RMB的比例乘以10的8次方即为此值,例如美元兑换人民币的比例为6.5,则rate=650000000

签名

sign String(32) 5K8264ILTKCH16CQ2502SI8ZNMTM67VS 签名,详见签名生成算法

 

举例如下:

<xml>
   <appid>wx2421b1c4370ec43b</appid>
   <mch_id>10000100</mch_id>
   <fee_type>USD</fee_type>
   <rate_time>20150807</rate_time>
   <rate>628.1225</rate>
   <sign>FDD167FAA73459FD921B144BAF4F4CA2</sign>
</xml>