5 匯率查詢接口
5.1 匯率查詢接口
5.1.1 業務功能
商戶網站的商品以外幣標價時，通過該接口可以即時查詢到微信使用的轉換匯率。匯率更新時間為北京時 間上午 10:00，一天更新一次。
5.1.2 交互模式
請求：後臺請求交互模式
返回結果：後臺請求交互模式
5.1.3 請求參數列表
** 請求 url：https://pay.wepayez.com/pay/gateway **
| 字段名 | 變數名 | 必填 | 類型 | 說明 |
|---|---|---|---|---|
| 接口類型 | service | 是 | String(32) | 接口類型：unified.trade.refund |
| 版本號 | version | 否 | String(8) | 版本號，version 默認值是 2.0。 |
| 字元集 | charset | 否 | String(8) | 取值： UTF-8 |
| 簽名方式 | sign_type | 否 | String(8) | 簽名類型，取值：MD5 |
| 商戶號 | mch_id | 是 | String(32) | 商戶唯一标识码，由平臺分配 |
| 終端 IP | mch_create_ip | 是 | String(16) | 訂單生成的機器 IP |
| 幣種 | fee_type | 否 | String(10) | 外幣幣種，詳細請見參數規定，默認商戶幣種 |
| 日期 | date | 是 | String(10) | 格式為 yyyyMMdd，如 2009 年 12 月 25 日表示為20091225。時區為 GMT+8 beijing |
| 查詢通道 | query_channel | 否 | String(32) | 可空，默認查詢微信匯率通道，包括如下：weixin/alipay/tenpay，不區分大小寫，目前只支持微信通道匯率查詢 |
| 隨機字串 | nonce_str | 是 | String(32) | 隨機字串，不長於 32 位 |
| 簽名 | sign | 是 | String(32) | MD5 簽名結果，詳見“第 4 章 MD5 簽名規則” |
POST XML 內容體進行請求
5.1.4 返回結果
數據按 XML 的格式即時返回
| 字段名 | 變數名 | 必填 | 類型 | 說明 |
|---|---|---|---|---|
| 版本號 | version | 是 | String(8) | 版本號，version 默認值是 2.0。 |
| 字元集 | charset | 是 | String(8) | 字元集，取值：UTF-8 |
| 簽名方式 | sign_type | 是 | String(8) | 簽名類型，取值：MD5 |
| 返回狀態碼 | status | 是 | String(16) | 0表示成功非0表示失敗。此字段是通信標識，非交易標識 ，交易是否成功需要查看result_code來判斷 |
| 返回資訊 | message | 否 | String(128) | 返回資訊，如非空，為錯誤原因簽 名失敗參數格式校驗錯誤 |
以下字段在 status 為 0 的時候有返回
| 字段名 | 變數名 | 必填 | 類型 | 說明 |
|---|---|---|---|---|
| 業務結果 | result_code | 是 | String(16) | 0 表示成功非 0 表示失敗 |
| 商戶號 | mch_id | 是 | String(32) | 商戶號，由平臺分配 |
| 設備號 | device_info | 否 | String(32) | 終端設備號 |
| 隨機字串 | nonce_str | 是 | String(32) | 隨機字串，不長於 32 位 |
| 錯誤代碼 | err_code | 否 | String(32) | 參考錯誤碼 |
| 錯誤代碼描述 | err_msg | 否 | String(128) | 結果資訊描述 |
| 簽名 | sign | 是 | String(32) | MD5 簽名結果，詳見“第 4 章 MD5 簽名規則” |
以下字段在 status 和 result_code 都為 0 的時候有返回
| 字段名 | 變數名 | 必填 | 類型 | 說明 |
|---|---|---|---|---|
| 幣種 | fee_type | 否 | String(10) | 外幣幣種，詳細請見參數規定 |
| 匯率時間 | rate_time | 是 | String(10) | 格式：yyyyMMdd |
| 現匯賣出價(匯率) | rate | 是 | String(16) | 外幣兌換 RMB 的比例乘以 10 的 8 次方即為此值，例如美元兌換人民幣的比例為 6.5，則rate=650000000 |
| 查詢通道 | query_channel | 否 | String(32) | 查詢通道 |