Browse Source

添加对接文档

master
vee 2 years ago
commit
176e1e8869
  1. 112
      对接.md

112
对接.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"
}
```
Loading…
Cancel
Save