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