* * * * *
> ### 一、點卡API支付接口
##### 1、支付網關地址
>[danger]地址:http://sendcurl.anvpay.com:7399/allapp/gateway<br>
傳遞方式:HTTP模擬請求提交
##### 2、支付提交參數
| 類型 | 參數 | 必填 | | 長度 | 簽名 | 描述 |
| --- | --- | --- | --- | --- | --- | --- |
| string | appid | 是 | 100 | 是 | "商戶應用ID",易匯卡后臺獲取 |
| string | bank_code | 是 | 10 | 是 | 點卡渠道編碼,固定CARD|
| string | bank_code_info | 是 | 10 | 是 | 點卡名稱代碼,參照本頁【充值卡支持類型】 |
| string | card_num | 是 | 25 | 是 | 充值卡卡號 |
| string | card_pwd | 是 | 25 | 是 | 充值卡密碼 |
| string | extra_return_param | 否 | 500 |是 | 公用回傳參數,異步回調時回傳 |
| string | interface_version | 是 | 10 | 是 | 接口版本,固定 V3.0 |
| string | notify_url | 是 | 500 | 是 | 異步通知地址,格式為URL完整地址|
| float | order_amount | 是 | 10 | 是 | 點卡金額,精確到小數點后2位。如:12.00 |
| string | order_no | 是 | 100 | 是 | 商戶支付訂單編號,同一個商戶必須保持唯一性|
| string | return_url | 是 | 500 | 是 | 同步通知地址,格式為URL完整地址 |
| string | sign | | | | base64格式的md5小寫簽名!
**sign簽名說明**:按先后順序,把參與簽名字段md5小寫加密后base64轉碼!
**appid=參數&bank_code=參數&bank_code_info=參數&card_num=參數&card_pwd=參數&interface_version=參數¬ify_url=參數&order_no=參數&order_amount=參數&order_no=參數&return_url=參數&key=商戶密鑰**|
####3、支付訂單處理結果(系統有兩次返回)
>[danger]1、第一次提交響應參數
~~~
"code": 200,
"msg": "成功",
"datas": "",
"sign": "dfcd7538ffd7af0c9a8cf2532940f374"
##提交200只表時當前提交成功,等待處理。是否支付成功需要等異步通知結果!
~~~
>[danger]2、第二次異步通知notify_url(回調)!
| 類型 | 參數 | 參與簽名 | 長度 | 說明 |
| --- | --- | --- | --- | --- | --- |
| string | appid | 是 | ~ | 應用id,訂單提交時的APPID |
| string | bank_code_info | 是 | ~ | 充值卡類型|
| string | card_num | 是 | 25 | 充值卡卡號 |
| string | code | 是 | ~ | 數字“200”為成功唯一結果,表示支付成功|
| string | extra_return_param | 否 | ~ | **支付時商戶傳遞的參數,如果支付時候有內容提交,就必須參與簽名!**|
| string | msg | 是 | ~ | 附加消息 |
| string | order_amount | 是 | ~ | 用戶提交金額[并不一定是真實金額],精確到小數點后4位1.00 |
| string | order_no | 是 | | 商戶訂單號 |
| string | order_rate | 是 | ~ | 交易手續費,精確到小數點后2位如1.00|
| string | true_order_amount | 是 | ~ | 真實面值,精確到小數點后4位12.1000,卡面值真實金額請以此字段為準!|
| string | sign | | ~ | md5簽名, 非空字段均參與簽名,簽名報文順序如下 **appid=參數&bank_code_info=參數}&card_num=參數&code=參數&extra_return_param=參數&msg=參數&order_amount=參數&order_no=參數&order_rate=參數&true_order_amount=參數&key=商戶密鑰**|
**sign簽名說明**:按先后順序,把參與簽名字段md5加密!
>[danger]不論點卡支付成功與失敗。異步通知驗簽完成后, 必須輸出英文字符串大寫“SUCCESS”給易匯卡,否則會間隔20秒再次補發通知,直到通知15次!**<br>
>[danger]#### 3、狀態碼
200:表明提交成功待處理,或處理成功,通常會在10秒~3分鐘內進行通知。
214:表明處理失敗,錯誤原因可能是點卡類型、卡密錯誤或已使用過。
4、提交說明
例如:
100元的面值,用戶提交時金額錯選為50元,則實際到帳50,剩余50不退回!
50元的面值,用戶提交錯選為100元,則實際到帳50元。
提交的金額一定只能是整數。
>[danger]5、充值卡類型
|編號| 充值卡名稱 | 編碼 | 開啟 | 卡號位數 |
|編號| 銀行名稱 | 銀行編碼 | 開啟 | 限額 |
|---| --- | --- | --- | --- | --- | --- |
|1|移動充值卡|SZX|是|卡號17位,密碼18位1000,500,300,200,100,50,30,20,10|
|2|電信充值卡|TELECOM|是|卡號19位,密碼18位,面額:1000,500,300,200,100,50,30,20,10|
|3|聯通充值卡|UNICOM|是|卡號15位,密碼19位,面額:500,300,100,50,30,20|
|4|完美一卡通|WANMEI|是|卡號9,10位,密碼6,15位,面額:100,50,30,15|
|5|搜狐一卡通|SOHU|是|卡號20位,密碼12位,面額:100,40,30,15,10,5|
|6|征途巨人一卡通|ZHENGTU|是|卡號16位,密碼8位,面額:500,468,300,100,60,50,30,25,20,10|
|7|網易一卡通|NETEASE|是|卡號13位,密碼9位,面額:50,30,20,15,10|
|8|駿網一卡通|JUNNET|是|卡號16位,密碼16位,面額:1000,500,200,100,50,30,15,10,6,5|
|9|久游一卡通|JIUYOU|是|卡號12、13位,密碼6、10位,面額:50,30,25,20,10,5|
|10|光宇一卡通|GUANGYU|停用|卡號20位,密碼8位,面額:100,50,30,20,10|
|11|盛付通|SFTCARD|是|卡號15,16位,密碼8,8位,面額:350,300,100,50,45,35,30,25,15,10,5|
|12|盛大卡|SNDACARD|是|卡號16位密碼8位|
|13|天下一卡通|TIANXIA|停用|卡號15位,密碼8位,面額:100,90,80,70,60,50,40,30,20,10|
|14|QQ一卡通|QQCARD|是|卡號9位,密碼12位,面額:200,100,60,30,15,10,5|
|15|天宏一卡通|TIANHONG|是|卡號10,12位,密碼10,15位,面額:100,50,30,15,10,5|
|16|縱游一卡通|ZHONGYOU|停用| |
|17|電信大額充值卡|TELECOMMAX|是|卡號19位,密碼18位,面額:500,300|
|18|聯通大額充值卡|UNICOMMAX|是|卡號15位,密碼19位,面額:500,300|
|19|移動大額充值卡|SZXMAX|是|卡號17位,密碼18位,面額:500,300|