feat: add scoped cookie operations for support
This commit is contained in:
@@ -0,0 +1,7 @@
|
||||
店铺ID:A20260813141939
|
||||
默认账号
|
||||
B178660196602145988
|
||||
默认密码
|
||||
afac3645
|
||||
AppKey: 2AJjbWmZ28cu723Q
|
||||
AppSecret: 5SDFbYEMgDITOKYzDUhBOQAPyTYBQ4UK
|
||||
@@ -0,0 +1,106 @@
|
||||
# 接口规范
|
||||
|
||||
# 一、请求格式
|
||||
|
||||
# 二、AppId、AppKey 和 AppSercet
|
||||
|
||||
- 由双方协定,或由我平台提供
|
||||
|
||||
- AppId:商户号
|
||||
|
||||
- AppKey:长度为16位
|
||||
|
||||
- AppSecret:长度为32位
|
||||
|
||||
- 用于
|
||||
|
||||
- 卡券、卡密类订单的数据的加密
|
||||
|
||||
- 签名时的补充数据
|
||||
|
||||
- *AppSercet需考虑定期更换*
|
||||
|
||||
|
||||
|
||||
# 三、请求接口公共参数
|
||||
|
||||
***可选参数在对接时,请联系对接方,非特殊说明情况下,默认不传递***
|
||||
|
||||
|
||||
|
||||
# 四、请求签名规则
|
||||
|
||||
**注意:签名前,需双方协定或由厂商提供AppSecret**
|
||||
|
||||
sign签名时
|
||||
|
||||
1. 去掉空格:剔除参数名和参数值的前后空格,包括\\n和\\r等空值
|
||||
|
||||
2. 剔除空值:如果参数没有值,不参与签名
|
||||
|
||||
3. **sign不参与签名,其他字段均参与签名**
|
||||
|
||||
4. 排序生成待签名串:
|
||||
|
||||
1. 所有参数名**按照ascii顺序**进行排序
|
||||
|
||||
2. 并且参数名与参数值**通过a=1\&b=2的方式**将所有参数进行组合
|
||||
|
||||
3. 生成新的字符串后在字符串后**加上请求的方式**
|
||||
|
||||
4. 再**加上AppSecret**后获得待签名字符串
|
||||
|
||||
5. 进行加密
|
||||
|
||||
1. 默认进行MD5加密
|
||||
|
||||
2. 将第三步的待签名字符串进行utf8编码
|
||||
|
||||
3. 再进行md5操作后得到字符串
|
||||
|
||||
4. 最后转小写后为签名字符串
|
||||
|
||||
```JSON
|
||||
// 假定 AppSercet 为 ac9fa79db418fd2c61d9bd4c60956f2d5db3a6d781d6f91f2e96327c74dfaccd
|
||||
// 假定是下订单的接口 POST
|
||||
// 待签名参数
|
||||
{
|
||||
// 公共参数
|
||||
app_id: '15945681 ',
|
||||
timestamp: 1740916504,
|
||||
|
||||
// 业务参数
|
||||
charge_account: '18888888888',
|
||||
buy_num: 2,
|
||||
customer_price: 1.21,
|
||||
customer_order_no: 'DD202507010010208888',
|
||||
product_id: '66668888'
|
||||
}
|
||||
// 上述参数的签名字符串(去掉空值、去掉空格;最后加上请求方法和AppSecret)
|
||||
app_id=15945681&buy_num=2&charge_account=18888888888&
|
||||
customer_order_no=DD202507010010208888&customer_price=1.21&
|
||||
product_id=66668888×tamp=1740916504
|
||||
POSTac9fa79db418fd2c61d9bd4c60956f2d5db3a6d781d6f91f2e96327c74dfaccd
|
||||
|
||||
// MD5后转小写,签名字符串为:
|
||||
4087a959f3488ecb13efe6ef58e3bc67
|
||||
```
|
||||
|
||||
|
||||
|
||||
# 五、响应公共信息
|
||||
|
||||
**响应签名规则请参考“请求签名规则”**
|
||||
|
||||
**sign不参与签名,其他字段均参与签名**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,76 @@
|
||||
# 创建订单【必要】
|
||||
|
||||
# 接口说明
|
||||
|
||||
- 下单接口
|
||||
|
||||
- POST 请求
|
||||
|
||||
- application/json
|
||||
|
||||
- 接口地址 ***adapter\-apiaccess/open/api/createOrderV2***
|
||||
|
||||
|
||||
|
||||
# 请求参数
|
||||
|
||||
**notify\_url**:
|
||||
|
||||
- 一些直充类的订单时间比较久,但不能持续占用连接
|
||||
|
||||
- 不传就不回调,订单的状态在查询时处理
|
||||
|
||||
|
||||
|
||||
**recharge\_arg**:(此处数据为用户填写和对应模板)
|
||||
|
||||
```Plain Text
|
||||
[
|
||||
{
|
||||
"templateName": "模板名,一般是中文,如手机号,只是标识用,调用方可自行决定",
|
||||
"templateVal": "用户填写的充值账号,比如:19876543210",
|
||||
}
|
||||
]
|
||||
```
|
||||
|
||||
这里是用户填写的信息,比如:充值手机号:19876543210
|
||||
|
||||
templateName:充值手机号
|
||||
|
||||
templateVal:19876543210
|
||||
|
||||
|
||||
|
||||
**ext\_arg**:(此处数据均为双方约定)
|
||||
|
||||
```Plain Text
|
||||
{
|
||||
"skuid": 243241231238888888,
|
||||
"skuname: "电商平台的商品名称"
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
|
||||
# 响应信息
|
||||
|
||||
## code数据对业务流程的影响
|
||||
|
||||
- 如果返回 200 的状态码,则下单成功,后续通过【查询订单】或者【订单异步通知】来获取订单结果状态
|
||||
|
||||
- 如果返回非 200 的状态码,订单失败,流程结束
|
||||
|
||||
|
||||
|
||||
## order\_status数据对业务流程的影响
|
||||
|
||||
- 0,待处理;1,处理中;2,成功;3,失败; 4,异常
|
||||
|
||||
- 当为 0 和 1 时,订单没有结束,
|
||||
|
||||
- 需要调用方自轮询查询订单;
|
||||
|
||||
- 或本平台订单结束后,异步通知订单结果
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,54 @@
|
||||
# 查询订单【必要】
|
||||
|
||||
# 接口说明
|
||||
|
||||
- 订单查询接口
|
||||
|
||||
- GET 请求
|
||||
|
||||
- application/x\-www\-form\-urlencoded
|
||||
|
||||
- 接口地址 ***adapter\-apiaccess/open/api/queryOrderV2***
|
||||
|
||||
|
||||
|
||||
# 请求参数
|
||||
|
||||
|
||||
|
||||
# 响应信息
|
||||
|
||||
## code数据对业务流程的影响
|
||||
|
||||
- 查询订单时如果返回非 200 的状态码,订单失败,流程结束
|
||||
|
||||
|
||||
|
||||
## order\_status数据对业务流程的影响
|
||||
|
||||
- 当为 0 和 1 时,订单没有结束,
|
||||
|
||||
- 需要调用方自轮询查询订单;
|
||||
|
||||
- 或本平台订单结束后,异步通知订单结果
|
||||
|
||||
- 当为 2 和 3 、4 时,订单结束
|
||||
|
||||
|
||||
|
||||
## cards解密后的结构如下
|
||||
|
||||
```JSON
|
||||
[
|
||||
{
|
||||
card_no: 'CN88889999',(无卡号就填""空串)
|
||||
card_pwd: 'ABCD-DEFG-GHIJ-JKLM',
|
||||
expired_time: '2026-09-27 08:36:58',(过期时间,可不传)
|
||||
price: '8.8',(卡密单价,可不传)
|
||||
card_type: '0'(不传时,默认为0。0.普通卡密 1.短链)
|
||||
}
|
||||
]
|
||||
```
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,34 @@
|
||||
# 订单异步通知【推荐】
|
||||
|
||||
# 接口说明
|
||||
|
||||
- 下单后,如订单流程、时间较长,需要第一时间返回下单成功状态,之后的流程中再去通知外部平台订单的状态
|
||||
|
||||
- POST 请求
|
||||
|
||||
- 接口地址一般为 ***http://IP******\[:PORT\]/网关/业务/callBackV2***
|
||||
|
||||
- 具体地址,请双方开发协定,或联系运营获取
|
||||
|
||||
|
||||
|
||||
# 请求参数
|
||||
|
||||
## cards解密后的结构如下:
|
||||
|
||||
```JSON
|
||||
[
|
||||
{
|
||||
card_no: 'CN88889999',(无卡号就填""空串)
|
||||
card_pwd: 'ABCD-DEFG-GHIJ-JKLM',
|
||||
expired_time: '2026-09-27 08:36:58',(过期时间,可不传)
|
||||
price: '8.8',(卡密单价,可不传)
|
||||
card_type: '0'(不传时,默认为0。0.普通卡密 1.短链)
|
||||
}
|
||||
]
|
||||
```
|
||||
|
||||
# 响应信息
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,20 @@
|
||||
# 账户信息查询
|
||||
|
||||
# 接口说明
|
||||
|
||||
- 下单接口
|
||||
|
||||
- GET 请求
|
||||
|
||||
- 接口地址 ***adapter\-apiaccess/open/api/userInfoV2***
|
||||
|
||||
|
||||
|
||||
# 请求参数
|
||||
|
||||
|
||||
|
||||
# 响应信息
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,20 @@
|
||||
# 账户信息查询
|
||||
|
||||
# 接口说明
|
||||
|
||||
- 下单接口
|
||||
|
||||
- GET 请求
|
||||
|
||||
- 接口地址 ***adapter\-apiaccess/open/api/userInfoV2***
|
||||
|
||||
|
||||
|
||||
# 请求参数
|
||||
|
||||
|
||||
|
||||
# 响应信息
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user