查詢匯率
應(yīng)用場景
商戶網(wǎng)站的商品以外幣標(biāo)價(jià)時(shí)，通過該接口可以實(shí)時(shí)查詢到微信使用的轉(zhuǎn)換匯率。匯率更新時(shí)間為北京時(shí)間上午10:00，一天更新一次。
接口鏈接
https://api.mch.weixin.qq.com/pay/queryexchagerate
是否需要證書
不需要
請求參數(shù)
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 應(yīng)用ID | appid | 是 | String(32) | wx8888888888888888 | 微信開放平臺審核通過的應(yīng)用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。時(shí)區(qū)為GMT+8 beijing |
| 簽名 | sign | 是 | String(32) | 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) | 簽名失敗 |
返回信息，如非空，為錯(cuò)誤原因 簽名失敗 參數(shù)格式校驗(yàn)錯(cuò)誤 |
以下字段在return_code為SUCCESS的時(shí)候有返回
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 應(yīng)用ID | appid | 是 | String(32) | wx8888888888888888 | 微信開放平臺審核通過的應(yīng)用APPID |
| 商戶號 | mch_id | 是 | String(32) | 1230000109 | 微信支付分配的商戶號 |
子商戶號 |
sub_mch_id | 否 | String(32) | 1230000100 | 微信支付分配的子商戶號 |
幣種 |
fee_type |
是 | String(10) |
SUCCESS | 外幣幣種，詳細(xì)請見參數(shù)規(guī)定 |
匯率時(shí)間 |
rate_time |
是 |
String(14) |
20150807131545 | 格式：yyyyMMddhhmmss |
現(xiàn)匯賣出價(jià) |
rate |
是 | String(15) |
628.2100 | 外幣標(biāo)準(zhǔn)單位乘以100折算為人民幣的金額，保留4位小數(shù)(如：100美元按當(dāng)時(shí)匯率折算返回的先匯賣出價(jià)是628.2100) |
簽名 |
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>