# 创建订单并扣款
# 简要描述
- 创建订单并扣款,将预订单创建和扣款整合在一起,超时时间需要设置60s,调用后需要最长等待60s扣款,一般会在2秒内返回扣款结果
# 请求URL
/openapi/common/schoolOpenApi/schoolOrderPay/v1
# 请求方式
- post
# 业务参数
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
actPayPrice | 是 | int | 实付金额 单位:分 |
totalPrice | 是 | int | 总金额 单位:分 |
applyPaymentDTO | 是 | object | 支付参数 |
equipmentSn | 是 | string | 设备SN |
openOrderNumber | 是 | string | 三方交易单号 需要全局唯一 |
orderSource | 是 | int | 订单来源 需要向平台获取 |
payMethod | 是 | string | 消费场景 参见附录 附录 |
payType | 是 | string | 支付类型 参见附录 附录 |
payWay | 是 | string | 支付方式 参见附录 附录 |
foodInfos | 否 | list | 商品信息 |
schoolUserId | 否 | string | 微信刷脸用户ID 微信离线刷脸SDK返回的outUserId 微信刷脸支付必传 |
userUid | 否 | string | 支付宝刷脸用户ID 支付宝离线刷脸SDK返回的aliPayUid 支付宝刷脸支付必传 |
oneCardNum | 否 | string | 用户一卡通卡号(十进制) 刷卡支付必传 |
serviceId | 否 | string | 智能设备套餐Id,智能设备套餐购买时必传。 即:payType=4/5时 |
# applyPaymentDTO参数
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
deviceIp | 是 | string | 设备IP |
mac | 是 | string | 设备mac |
payCredential | 否 | string | 支付凭证 由微信离线刷脸SDK返回的face_token、支付宝K12刷脸SDK返回的faceToken或者扫码凭证(现金代扣支付必传) |
terminalParams | 否 | string | 支付宝IoTsdk加签字符串 支付宝刷脸支付必传 |
# foodInfos 参数说明
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
foodId | 否 | string | 商品编号 (编号名称二选一) |
foodName | 否 | string | 商品名称 (编号名称二选一) |
price | 是 | int | 商品单价 单位:分 |
number | 是 | int | 商品数量 |
totalPrice | 是 | int | 商品总价 单位:分 |
foodProvider | 否 | string | 商品供应商 |
foodOpenPic | 否 | string | 商品图片(需要网络直接访问的到) |
# 返回示例
{
"code": 200,
"msg": "支付成功",
"obj": {
"schoolUser": {
"id": "1293371440947904512",
"name": "咖啡",
"num": "005",
"oneCardNum": "3397278628",
"clazzName": "一年一班",
"money": 0,
"subsidyMoney": 0,
}
},
"sign": "df951a83e3fc7462241752dd7e65398b"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 返回参数说明
参数名 | 类型 | 说明 |
---|---|---|
schoolUser | object | 刷脸用户信息 |
orderNumber | string | 订单号 |
openOrderNumber | string | 三方交易单号 |
actPayPrice | double | 实付金额 单位:元 |
status | string | 订单状态 附录 |
# schoolUser说明
参数名 | 类型 | 说明 |
---|---|---|
id | string | 用户ID |
name | string | 用户姓名 |
num | string | 编号 |
oneCardNum | string | 一卡通卡号 |
clazzName | string | 班级名称 |
money | double | 余额 单位:分 |
subsidyMoney | double | 餐补 单位:分 |
# serviceInfo说明
参数名 | 类型 | 说明 |
---|---|---|
resCount | string | 可用次数 |
resDay | string | 可用天数 |