# 接口文档 ## 接口列表 | 名称 | 路径 | 请求方法 | Content-Type|字段| | -------- | -------- | -------- | -------- | -------- | | 插件列表 | /list | GET | / | / | | 交互统一接口 | /core | POST | application/x-www-form-urlencoded | sign | ## 回调方式 *如回调时,httpcode != 200 则会每隔3s 总共3次 重新发起回调* *body数据全部通过aes加密* post -> callback content-type -> application/x-www-form-urlencoded body -> 解密后:```{"code":200,"msg":"","data":x}``` 参数传递,通过在callback添加get参数进行确定 如请求ID:https://callback.com/c?request_id=123456 --- ## 加密方式 交互统一接口只有一个外层结构,字段“sign” 如状态查询 ```javascript all_data = { // 插件名称 "plugin-name": "gome-alipay-h5", // 回调地址(如果值是一个正确的URL,则代表异步请求,建议同步请求,异步会多一个HTTP请求) "callback":"", // 调用的方法 "method":"state", // 方法所需数据,如果是异步,请求创建成功 -> data = null "data": { "order_id":"1UC2NUC0305RQE8C", "ots":"1672299493000", "cookies":"", "proxy":"127.0.0.1:1234" } } ``` ```javascript! // RSA加密上述JSON,可去除空格 sign_text = aes_encrypt(all_data) // URL编码Sign 全编码模式 encodeURIComponent sign = urlencode(sign_text) ``` --- ### 插件 : gome-alipay-h5 #### method:keep *Cookie保活* *请求* | 字段名 | 字段类型 |字段说明 | | --- | --- | --- | | cookies | string | Cookies列表 | |proxy|string|代理IP 代理协议目前支持HTTP 格式:ip:端口 | *响应* code != 200 -> 保活失败 msg -> 失败原因 data != null -> 新的Cookie,需替换原有Cookie #### method:state *请求* | 字段名 | 字段类型 |字段说明 | | --- | --- | --- | | order_id | string | 下单时返回的订单ID | | cookies | string | Cookies列表 | |proxy|string|代理IP 代理协议目前支持HTTP 格式:ip:端口 | *响应* | 字段名 | 字段类型 |字段说明 | | --- | --- | --- | | order_id | string | 订单ID | | state | string | 'pending' = 等待付款,'paid' = 充值中,'canceled' = 已取消,'error' = 充值失败,'success' - 充值成功 | ```jsonld! { "code": 200, "msg": "", "data": { "id": "1058889086460497920", "pluginName": "gome-alipay-h5", "addTime": "2022-12-31T23:27:11.420721", "endTime": "2022-12-31T23:27:11.420743", "amount": 100, "state": "pending", "payUrl": "https://mapi.alipay.com/gateway.do?_input_charset=utf-8&body=%E7%9C%9F%E5%BF%AB%E4%B9%90%E5%95%86%E5%93%81&it_b_pay=720m&notify_url=http%3A%2F%2Fj.gpay.gome.com.cn%2Fcashierapi%2Fpay%2FALIPAYWAPVIRTON.dhtml&out_trade_no=10111800120441916966&partner=2088311598608551&payment_type=1&return_url=https%3A%2F%2Fwww.baidu.com&seller_email=gomefin002%40yolo24.com&seller_id=2088311598608551&service=alipay.wap.create.direct.pay.by.user&subject=%E7%9C%9F%E5%BF%AB%E4%B9%90%E5%95%86%E5%93%81-10111800120441916966&total_fee=100&sign=197379f6704aa457c3b78609c4a76c94&sign_type=MD5", "pluginOrderId": "1UC2NUC0305RQEAR", "pluginParameter1": "", "pluginParameter2": "", "requestId": "", "callback": "" } } ``` #### method:place *请求* | 字段名 | 字段类型 |字段说明 | | --- | --- | --- | | phone | string | 充值的电话号码 | | amount | string | 充值的金额 | | cookies | string | Cookies列表 | |proxy|string|代理IP 代理协议目前支持HTTP 格式:IP:端口 | ```jsonld! { "plugin-name":"gome-alipay-h5", "method":"place", "data":{ "phone":"13888888888", "amount":"100", "cookies":"uid=CmoFZGOn8r5Jx7eWEZ5iAg==; global_key=9dd85f913fa34e5f8f2b9f12d789d1c0; ssaa=4e80002e77b0498e88750d82cab22655; DYN_USER_ID=88157666966; gradeId=G1; sensorsdata2015jssdkcross=%7B%22distinct_id%22%3A%2288157666966%22%2C%22first_id%22%3A%22185480c379d781-0935ba781948b1-a3e3164-1764000-185480c379e16d7%22%2C%22props%22%3A%7B%22%24latest_traffic_source_type%22%3A%22%E7%9B%B4%E6%8E%A5%E6%B5%81%E9%87%8F%22%2C%22%24latest_search_keyword%22%3A%22%E6%9C%AA%E5%8F%96%E5%88%B0%E5%80%BC_%E7%9B%B4%E6%8E%A5%E6%89%93%E5%BC%80%22%2C%22%24latest_referrer%22%3A%22%22%7D%2C%22%24device_id%22%3A%22185480c379d781-0935ba781948b1-a3e3164-1764000-185480c379e16d7%22%7D; __uls=Y; __unick=gm_180%255E_%255E5563toul; gpid=11000000; gcid=11010000; gdid=11010200; gtid=110102002; organizationId=1001; gpName=%E5%8C%97%E4%BA%AC; gcName=%E5%8C%97%E4%BA%AC%E5%B8%82; gdName=%E6%9C%9D%E9%98%B3%E5%8C%BA; gtName=%E6%9C%9D%E5%A4%96%E8%A1%97%E9%81%93; addr_lng=116.44901575951573; addr_lat=39.92654605581156; awaken=true; cartnum=0_0-1_0; __ugk=; __uxglt=; ufpd=5ce4839a43995154038688c9407ba132e7265563af151e336e41262abe4d448e0c1134884b1d6531a9424d127a7754455bdd95b3db7378628c5b481914b2c03c|63a9bcb2zUGeBSNM0x7ASB4XIRsv4wShoxpUH431; SCN=NICD0w17dkH58GhwhqvvDsTS%2B4%2FV9g%2FgLXc%2BdlH3o9bOfY2%2FYpbHNz2Dwol1kABkMfN71Sft617D9sHSeZG%2FbUczh6Hv5E4wkR%2FT58zHi90ydZNYyh0wIw%3D%3D71d9eb158140669b326219f862e9ad0f; DYN_USER_CONFIRM=NICD0w17dkH58GhwhqvvDsTS%2B4%2FV9g%2FgLXc%2BdlH3o9bOfY2%2FYpbHNz2Dwol1kABkMfN71Sft617D9sHSeZG%2FbUczh6Hv5E4wkR%2FT58zHi90ydZNYyh0wIw%3D%3D71d9eb158140669b326219f862e9ad0f; SSO_USER_ID=88157666966; ctx=app-shangcheng|ver-v7.0.0|plt-wap|cmpid-; ads=0; http_referer=https%3A%2F%2Fprom.m.gome.com.cn%2Fgcms%2FMobsaleXeJZtP71hvW.html; JSESSIONID=DF8DA5FA2435DA8302AFFCD0C492B817", "proxy":"127.0.0.1:10871" } } ``` *响应* | 字段名 | 字段类型 |字段说明 | | --- | --- | --- | | phone | string | 充值的电话号码 | | url | string | 支付宝充值链接 | | ots | string | 订单创建时间,用于查询状态 | | order_id | string | 订单ID | ```jsonld! { "code": 200, "msg": "", "data": { "id": "1058889086460497920", "pluginName": "gome-alipay-h5", "addTime": "2022-12-31T23:27:11.420721", "endTime": "2022-12-31T23:27:11.420743", "amount": 100, "state": "pending", "payUrl": "https://mapi.alipay.com/gateway.do?_input_charset=utf-8&body=%E7%9C%9F%E5%BF%AB%E4%B9%90%E5%95%86%E5%93%81&it_b_pay=720m&notify_url=http%3A%2F%2Fj.gpay.gome.com.cn%2Fcashierapi%2Fpay%2FALIPAYWAPVIRTON.dhtml&out_trade_no=10111800120441916966&partner=2088311598608551&payment_type=1&return_url=https%3A%2F%2Fwww.baidu.com&seller_email=gomefin002%40yolo24.com&seller_id=2088311598608551&service=alipay.wap.create.direct.pay.by.user&subject=%E7%9C%9F%E5%BF%AB%E4%B9%90%E5%95%86%E5%93%81-10111800120441916966&total_fee=100&sign=197379f6704aa457c3b78609c4a76c94&sign_type=MD5", "pluginOrderId": "1UC2NUC0305RQEAR", "pluginParameter1": "", "pluginParameter2": "", "requestId": "", "callback": "" } } ``` 支付宝启动: 1. alipays://platformapi/startapp?appId=20000067&url=(URL全编码) 1. alipays://platformapi/startapp?appId=20000987&url=(URL全编码) 如: ``` alipays://platformapi/startapp?appId=20000067&url=https%3A%2F%2Fmapi.alipay.com%2Fgateway.do%3F_input_charset%3Dutf-8%26body%3D%25E7%259C%259F%25E5%25BF%25AB%25E4%25B9%2590%25E5%2595%2586%25E5%2593%2581%26it_b_pay%3D721m%26notify_url%3Dhttp%253A%252F%252Fj.gpay.gome.com.cn%252Fcashierapi%252Fpay%252FALIPAYWAPVIRTON.dhtml%26out_trade_no%3D10111800120438313966%26partner%3D2088311598608551%26payment_type%3D1%26return_url%3Dhttps%253A%252F%252Fwww.baidu.com%26seller_email%3Dgomefin002%2540yolo24.com%26seller_id%3D2088311598608551%26service%3Dalipay.wap.create.direct.pay.by.user%26subject%3D%25E7%259C%259F%25E5%25BF%25AB%25E4%25B9%2590%25E5%2595%2586%25E5%2593%2581-10111800120438313966%26total_fee%3D100%26sign%3D10d49a8d07aab033124c976a7e174215%26sign_type%3DMD5 ```