查詢匯率
應(yīng)用場景
商戶網(wǎng)站的商品以外幣標(biāo)價時，通過該接口可以實時查詢到微信使用的轉(zhuǎn)換匯率。匯率更新時間為北京時間上午10:00，一天更新一次。
接口鏈接
https://api.mch.weixin.qq.com/pay/queryexchagerate
是否需要證書
不需要
請求參數(shù)
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 公眾賬號ID | appid | 是 | String(32) | wxd678efh567hg6787 | 微信分配的公眾賬號ID（企業(yè)號corpid即為此appId） |
| 商戶號 | mch_id | 是 | String(32) | 1230000109 | 微信支付分配的商戶號 | 子商戶號 | sub_mch_id | 否 | String(32) | 1230000100 | 微信支付分配的子商戶號 |
| 幣種 | fee_type | 是 | String(10) | USD | 外幣幣種，詳細(xì)請見參數(shù)規(guī)定 |
| 日期 | date | 是 | String(14) | 20150807 | 格式為yyyyMMdd，如2009年12月25日表示為20091225。時區(qū)為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>
返回結(jié)果
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 返回狀態(tài)碼 | return_code | 是 | String(16) | SUCCESS |
SUCCESS/FAIL 此字段是通信標(biāo)識，非交易標(biāo)識，交易是否成功需要查看trade_state來判斷 |
| 返回信息 | return_msg | 否 | String(128) | 簽名失敗 |
返回信息，如非空，為錯誤原因 簽名失敗 參數(shù)格式校驗錯誤 |
以下字段在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 | 外幣幣種，詳細(xì)請見參數(shù)規(guī)定 |
匯率時間 |
rate_time |
是 |
String(14) |
20150807 | 格式：yyyyMMdd |
現(xiàn)匯賣出價(匯率) |
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>