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

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

匯率查詢

最新更新時(shí)間：2020.5.08 版本說(shuō)明

商戶網(wǎng)站的商品以外幣標(biāo)價(jià)時(shí)，通過(guò)該接口可以實(shí)時(shí)查詢到微信使用的轉(zhuǎn)換匯率。匯率更新時(shí)間為北京時(shí)間上午10:00，一天更新一次。

接口說(shuō)明

適用對(duì)象:直連模式機(jī)構(gòu)模式

請(qǐng)求URL:https://api.mch.weixin.qq.com/pay/queryexchagerate

請(qǐng)求方式: POST

是否需要證書(shū): 否

請(qǐng)求參數(shù)

參數(shù)名	變量名	類型	必填	描述
公眾賬號(hào)ID	appid	string(32)	是	微信分配的公眾賬號(hào)ID（企業(yè)號(hào)corpid即為此appId）示例值：wxd678efh567hg6787
商戶號(hào)	mch_id	string(32)	是	微信支付分配的商戶號(hào) 示例值：1230000109
幣種	fee_type	string(10)	是	外幣幣種，詳細(xì)請(qǐng)見(jiàn)參數(shù)規(guī)定示例值：USD
日期	date	string(14)	是	格式為yyyyMMdd，如2009年12月25日表示為20091225。時(shí)區(qū)為GMT+8 beijing 示例值：20150807
簽名	sign	string(64)	是	簽名，詳見(jiàn)簽名生成算法示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS

舉例如下：


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

    
｛
JAVA示例代碼
｝

返回結(jié)果

字段名	變量名	類型	必填	描述
返回狀態(tài)碼	return_code	string(16)	是	SUCCESS/FAIL 此字段是通信標(biāo)識(shí)，非交易標(biāo)識(shí)，交易是否成功需要查看trade_state來(lái)判斷示例值：SUCCESS
返回信息	return_msg	string(128)	是	返回信息，如非空，為錯(cuò)誤原因簽名失敗參數(shù)格式校驗(yàn)錯(cuò)誤示例值：簽名失敗

以下字段在return_code為SUCCESS的時(shí)候有返回

字段名	變量名	類型	必填	描述
公眾賬號(hào)ID	appid	string(32)	是	微信分配的公眾賬號(hào)ID 示例值：wxd678efh567hg6787
商戶號(hào)	mch_id	string(32)	是	微信支付分配的商戶號(hào) 示例值：1230000109
子商戶號(hào)	sub_mch_id	string(32)	否	微信支付分配的子商戶號(hào) 示例值：1230000100
幣種	fee_type	string(10)	是	外幣幣種，詳細(xì)請(qǐng)見(jiàn)參數(shù)規(guī)定示例值：SUCCESS
匯率時(shí)間	rate_time	string(14)	是	格式：yyyyMMdd 示例值：20150807
現(xiàn)匯賣出價(jià)(匯率)	rate	string(16)	是	外幣兌換RMB的比例乘以10的8次方即為此值，例如美元兌換人民幣的比例為6.5，則rate=650000000 示例值：650000000
簽名	sign	string(64)	是	簽名，詳見(jiàn)簽名生成算法示例值：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>