>### 一、代付網關:
http://outcurl.anvpay.com:9963/allapp/outpaygateway
* * * * *
傳遞方式:HTTP請求,服務器CURL、HttpWebRequest提交!
接收類型:數組
注意:商戶需要報備IP白名單。
###二、代付接口請求參數
| 類型 | 參數 | 必須 | 默認 | 長度 | 參與簽名 | 描述 |
| --- | --- | --- | --- | --- | --- | --- |
| string | appid | 1 | | ~ | 1 | "商戶應用ID",易匯卡后臺獲取 |
| string | bank_city_code | 1 | | ~ | 1 | 收款銀行開戶市,參見城市地區表 |
| string | bank_code | 1 | | ~ | 1 | 代付產品編碼 [固定:DF] |
| string | bank_full_name | 0 | | ~ | 1 | 收款銀行開戶行全稱 |
| string | bank_name | 1 | | ~ | 1 | 收款銀行名稱 ,參見銀行支持表 |
| string | bank_province_code | 1 | | ~ | 1 | 收款銀行開戶省 ,參見城市地區表 |
| string | bank_user_cardnum | 1 | | ~ | 1 | 收款銀行帳號,15-19位數 |
| string | bank_user_name | 1 | | ~ | 1 | 收款帳戶名 |
| string | fee_type | 1 | | ~ | 1 | 手續費扣款類型,付款方 "pay",收款方 "receive" |
| string | extra_return_param | 0 | | 1000 | 1 | 公用回傳參數, 此參數必須自行base64編碼! |
| string | interface_version | 1 | | ~ | 1 | 接口版本,【固定V1.0】 |
| string | notify_url | 1 | | 200 | 1 | 異步通知地址 |
| string | order_no | 1 | | 100 | 1 | 代付訂單編號,必須唯一 |
| float | order_amount | 1 | | 11 | 1 | 代付金額。舉例:12.00,精確到小數點后兩位 |
| string | sign | 1 | | ~ | 0 | 密文,簽名內容,把以上字段按順序連接后進行MD5編碼后再base64轉碼) |
sing簽名明文如下:
appid=app_6256eaeaebfda060e0f6937c796751b0&bank_city_code=北京&bank_code=DF&bank_name=中信銀行&bank_province_code=上海&bank_user_cardnum=2342342342342342&bank_user_name=楊華&client_ip=127.0.0.1&fee_type=pay&interface_version=V1.0¬ify_url=http://www.pay.com//Home/Enterprise/df_notify.html&order_amount=119&order_no=DFPL_3148195cfd7e503c06326ef40b8fba38&order_time=1488869986&key=sk_live_57af2467293fd1eac13876ee3d49212
響應參數 JSON
| 類型 | 參數 | 必須 | 默認 | 長度 | 參與簽名 | 描述 |
| --- | --- | --- | --- | --- | --- | --- |
| string | appid | 1 | | ~ | 1 | "商戶應用ID",易匯卡后臺獲取 |
| string | order_no | 1 | | ~ | 1 | 商戶付訂單號 |
| string | code | 1 | | ~ | 1 | 200-成功,等待銀行處理<br>211-提交失敗[退款唯一標識]<br>212-成功,等待系統處理<br> 213-成功,系統排隊處理
| string | msg | 1 | | ~ | 1 | 付加文字狀態信息 |
| string | order_time | 1 | | ~ | 1 | 代付訂單提交時間 |
| string | order_amount | 1 | | ~ | 1 | 訂單提交金額,精確到小數點后兩位如10:00 |
| string | true_order_amount | 1 | | ~ | 1 | 訂單實際到帳金額,精確到小數點后兩位 |
| string | sign | 1 | | ~ | 0 | 簽名,把字段按a-b順序連接后進行MD5[小寫字母] ] |
###三、 異步通知回調參數
代付提交正確后,易匯卡會異步通知notify_url地址,請確保此url有效!回調數據如下!
| 簽名順序 | 類型 | 參數 | 參與簽名 | 長度 | 說明 |
| --- | --- | --- | --- | --- | --- | --- |
| 1 | string | appid | 1 | ~ | 應用id,訂單提交時的APPID |
| 2 | string | code | 1 | ~ | 代付狀態<br>200-付款成功-唯一成功結果<br>211-付款失敗,退款唯一參數</br>如果未有以上code碼,說明在處理中,一定不要進行退款|
| 3 | string | extra_return_param | 1 | ~ | **自定義參數,代付時商戶傳遞的參數**|
| 4 | string | msg | 1 | ~ | 付加代付狀態,SUCCESS成功,! |
| 5 | string | order_amount | 1 | ~ | 商戶發起代付金額,如10.00,精確到2位小數|
| 6 | string | true_order_amount | 1 | | 商戶代付到帳金額,如10.00,精確到2位小數 |
| 7 | string | order_pay_time | 1 | | 代付成功時間綴,10位數 |
| 8 | string | order_no | 1 | | 代付訂單號,商戶傳遞的訂單號 |
| 9 | string | order_time | 1 | |代付信息創建時間綴,10位數|
| 10 | string | sign | 0 | ~ | 簽名內容,根據以上排列字段組成的明文通過MD5密文[小寫字母], **注:字段非空時必須參與簽名**|
:sing簽名明文如下:
appid=app_0a1f76bb1a246571cf815217507e5587&code=200&extra_return_param=1111&msg=SUCEESS&order_amount=100.00&order_no=dfwweewew&order_pay_time=1489117717&order_time=1489117717&true_order_amount=90.00&key=sk_live_14b99e668891cdb3540b57788ea9e4fb
####注: 不論代付狀態成功與失敗,通知時notify_url時需輸出 “SUCCESS”大寫字符,否則系統會補發至15次,每分鐘1次!
二、代付訂單查詢
a:接口地址
http://http://122.10.84.169:7033/Outpaygateway/Payquery/gateway
| 類型 | 參數 | 必須 | 默認 | 長度 | 參與簽名 | 描述 |
| --- | --- | --- | --- | --- | --- | --- |
| string | appid | 1 | | ~ | 1 | "商戶應用ID",易匯卡后臺獲取 |
| string | order_no | 1 | | ~ | 1 | 商戶訂單號 |
| string | sign | 1 | | ~ | 1 | 簽名] |
b:響應參數 JSON
| 類型 | 參數 | 必須 | 默認 | 長度 | 參與簽名 | 描述 |
| --- | --- | --- | --- | --- | --- | --- |
| string | appid | 1 | | ~ | 1 | "商戶應用ID",易匯卡后臺獲取 |
| string | order_no | 1 | | ~ | 1 | 商戶付訂單號 |
| string | code | 1 | | ~ | 1 | 200-付款成功br>211-付款失敗<br>212-付款處理中<br>214-查詢失敗<br>215-訂單失敗 |
| string | msg | 1 | | ~ | 1 | 付加代付狀態,SUCCESS成功,! |
| string | order_time | 1 | | ~ | 1 | 代付訂單提交時間 |
| string | order_amount | 1 | | ~ | 1 | 訂單提交金額,精確到小數點后兩位 |
| string | true_order_amount | 1 | | ~ | 1 | 訂單實際到帳金額,精確到小數點后兩位 |
| string | sign | 1 | | ~ | 1 | 簽名,把字段按a-b順序連接后進行MD5[小寫字母] ] |
訂單完成后無通知:請檢查是否服務器拒絕
說明:
(1).支付請求是HTTPS協議請求,商戶以POST方式發送到易匯卡。
(2).ASP環境要求操作系統:HTTP應用服務器在IIS5.0以上。
(3).易匯卡統一使用UTF-8編碼方式。
(4).參數名稱和參數說明中規定的固定值必須與列表中完全一致(大小寫敏感)。
(5).涉及到的中文需要正確編碼。