From 176e1e8869ba83caac73f63e9c0f7df67be1384c Mon Sep 17 00:00:00 2001 From: vee <897831508@qq.com> Date: Wed, 19 Apr 2023 17:01:45 +0800 Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E5=AF=B9=E6=8E=A5=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 对接.md | 112 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 112 insertions(+) create mode 100755 对接.md diff --git a/对接.md b/对接.md new file mode 100755 index 0000000..1b48b4b --- /dev/null +++ b/对接.md @@ -0,0 +1,112 @@ +## 签名规范 + +简要描述: + + +- 签名规范 + + +测试URL: + + +- http://newpay-api.weirui0755.com + + + +**接口公共参数(head)** + +| 参数名 | 参数类型 | 说明 | +| -- | -- | -- | +| sign |string | 签名 | +| timestamp |long | 时间戳(毫秒) | + +接口签名说明 + +- a、 获取接收到的所有请求参数字段,签名明文为除了sign之外的其他字段,加上分配的key + + +- b、 所有参与签名的字段,按字段名的ASCLL码从小到大排序后,拼接在json参数后面 + + +- c、 sign=md5(string+key). + + +- 如接收到的全部参数如下: + + + {"payee":"ciroe","money":100,"numid":"7896827676478687436","payTime":"2023-03-12 09:12:00","payeeCard":"999999"} + + +- 组成的明文为(头部的timestamp参与签名): + + + {"payee":"ciroe","money":100,"numid":"7896827676478687436","payTime":"2023-03-12 09:12:00","payeeCard":"999999","timestamp":67826574938789}PBcGdWvA7dUintx7WNOR11cOdCrEpasM + + +- 则签名数据为=md5(string+key) .toLowerCase() + + + +## 1.接收订单 + +**请求URL:** + +- ` /vodafone/orderTaking ` + +**请求方式:** + +- POST + +**接口参数** + +| 参数名 | 参数类型 | 说明 | +| -- | -- | -- | +| numid | string | 唯一订单号,回调可能会重复请求,可根据此单号如果存在则无需再次处理业务逻辑 | +| payee | string | 收款卡姓名 | +| payeeCard | string | 收款卡卡号/手机号 | +| money | BigDecimal | 订单金额,单位元,精确到两位小数 | +| payTime | string | 支付时间,形如 "2022-10-09 08:22:03" | + +**返回参数列表** + +```javascript +{ + "msg":"成功", + "code":200, + "data":{}, + "timestamp":"1681892285429" +} +``` +## 2.同步设备 + +**请求URL:** + +- ` /vodafone/deviceSync ` + +**请求方式:** + +- POST + +**接口参数** + +| 参数名 | 参数类型 | 说明 | +| -- | -- | -- | +| id | int | 设备编号 | +| name | string | 账户名称 | +| aliasName | string | 设备名 | +| cardNo | String | 手机号 | +| state | string | 状态:go_online上线,offline下线 | + +**返回参数列表** + +```javascript +{ + "msg":"成功", + "code":200,//200成功,其他都为失败,并会有 message 提示 + "data":{}, + "timestamp":"1681892285429" +} +``` + + +