微信支付-跨境支付開發(fā)者文檔

返回上一層跨境支付 / 付款碼支付 / 查詢匯率API

匯率查詢

最新更新時間：2020.5.08 版本說明

商戶網站的商品以外幣標價時，通過該接口可以實時查詢到微信使用的轉換匯率。匯率更新時間為北京時間上午10:00，一天更新一次。

接口說明

適用對象:直連模式機構模式

請求URL:https://api.mch.weixin.qq.com/pay/queryexchagerate

請求方式: POST

是否需要證書: 否

請求參數

參數名	變量名	類型	必填	描述
公眾賬號ID	appid	string(32)	是	微信分配的公眾賬號ID（企業(yè)號corpid即為此appId）示例值：wxd678efh567hg6787
商戶號	mch_id	string(32)	是	微信支付分配的商戶號示例值：1230000109
幣種	fee_type	string(10)	是	外幣幣種，詳細請見參數規(guī)定示例值：USD
日期	date	string(14)	是	格式為yyyyMMdd，如2009年12月25日表示為20091225。時區(qū)為GMT+8 beijing 示例值：20150807
簽名	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>

    
｛
JAVA示例代碼
｝

返回結果

字段名	變量名	類型	必填	描述
返回狀態(tài)碼	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)	是	外幣幣種，詳細請見參數規(guī)定示例值：SUCCESS
匯率時間	rate_time	string(14)	是	格式：yyyyMMdd 示例值：20150807
現(xiàn)匯賣出價(匯率)	rate	string(16)	是	外幣兌換RMB的比例乘以10的8次方即為此值，例如美元兌換人民幣的比例為6.5，則rate=650000000 示例值：650000000
簽名	sign	string(64)	是	簽名，詳見簽名生成算法示例值：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>