3.5烈熊收银台接口(购买权益卡)
路径:/api/order/createOrder
方法: POST
header:
| 参数名称 | 类型 | 长度限制 | 是否必填 | 介绍 |
|---|---|---|---|---|
| Authorization | String | 是 | Bearer 客户认证令牌/会员认证令牌 |
请求参数:
| 字段名称 | 类型 | 长度限制 | 是否必填 | 介绍 |
|---|---|---|---|---|
| thirdOrderNo | String | 是 | 第三方订单号 | |
| goodsItem | Array | 是 | 商品组以Array形式传入 | |
| goodsItem.salesDetailId | String | 是 | 购卡详情id | |
| goodsItem.buyNum | int | 是 | 购卡数量 | |
| goodsItem.buyPrice | int | 是 | 购卡金额单位（分） | |
| goodsItem.onTime | String | 是 | 开通时间格式：yyyy-MM-dd HH:mm:ss | |
| thirdAttach | String | 否 | 客户自定义参数，推送时返回 | |
| notifyUrl | String | 是 | 订单状态推送通知地址 | |
| payType | String | 否 | 支付类型 | |
| successReturnUrl | String | 否 | 支付成功跳转页面successReturnUrl和failReturnUrl须同时传入 | |
| failReturnUrl | String | 否 | 支付失败跳转页面successReturnUrl和failReturnUrl须同时传入 |
{
"thirdOrderNo": "xmytest20221107087989",
"successReturnUrl": "http://139.196.203.17:18080/notify",
//支付成功跳转页面
"failReturnUrl": "http://139.196.203.17:18080/notify",
//支付失败跳转页面
"thirdAttach": "xmytest",
"payType": "",
"notifyUrl": "https://push.liexiong.net/push/下单权益卡",
"goodsItem":[
{
"salesDetailId":"{{salesDetailId}}",
"buyNum":1,
"buyPrice":"1",
"onTime":"2022-11-07 01:20:19"
}
]
}返回:
| 字段名称 | 类型 | 长度限制 | 介绍 |
|---|---|---|---|
| orderNo | String | 烈熊订单号 | |
| thirdOrderNo | 第三方订单号 | ||
| goodsItem | Array | 商品信息 | |
| goodsItem.salesDetailId | String | 商品ID | |
| goodsItem.userCardInfo | Array | 用户权益卡信息 | |
| goodsItem.userCardInfo.userCardId | String | 用户权益卡id | |
| goodsItem.userCardInfo.startTime | String | 用户权益卡生效时间 | |
| goodsItem.userCardInfo.startTime | String | 用户权益卡失效时间 |
{
"code": "0",
"data": {
"cashierUrl": "https://interests-m-prev.billbear.vip/cashier/?customerId=1402914735558414337&memberId=1589812189468639234&payOrderId=1589813267058184193&token=OPEN_MEMBER.bed853a691eb4b7e88a229bd253453be.6372fe19&tradeType=H5&sceneId=INTERESTS_CARD&payType=&success=http://139.196.203.17:18080/notify&fail=http://139.196.203.17:18080/notify&index=https://interests-m-prev.billbear.vip/ecard/pages/mineequitycard/index",
"orderNo": "202211081053148161122"
},
"message": "请求成功",
"service": "",
"success": true
}错误：
| codes | 问题描述 | 解决 |
|---|---|---|
| 401 | Bearer令牌不允许为空/token无效 | 请检查Authorization参数 |
| INTERESTS_10055 | 三方订单号不可重复下单 | |
| 400 | 缺少参数 | 具体内容查阅返回的message字段 |
加入权益卡订单状态处理结果通知 注 · 当 notifyUrl 推送url参数不为空时，系统将按照下列格式像目标URL以body体json格式进行数据推送 三方接收到推送消息后，需给烈熊返回标识 success 表示成功接收到数据，就算本次推送完成 推送参数:
| 字段名称 | 类型 | 长度限制 | 是否必填 | 介绍 |
|---|---|---|---|---|
| orderNo | String | 32 | 是 | 烈熊订单编号 |
| thirdOrderNo | String | 32 | 是 | 第三方订单编号 |
| thirdUserId | String | 32 | 是 | 第三方用户唯一标识 |
| orderState | String | 32 | 是 | 订单状态TO_PAY 待付款，COMPLETE 完成，CANCEL 取消，CLOSE 关闭（退款） |
| orderTime | String | 是 | 烈熊订单创建时间 | |
| thirdAttach | String | 否 | 如接口请求时有携带该参数，则会原样返回 | |
| goodsItem | Array | 是 | 商品组以Array形式传入 | |
| goodsItem.salesDetailId | String | 是 | 售卡详情id | |
| goodsItem.buyNum | int | 是 | 购卡数量，当前仅支持1 | |
| goodsItem.buyPrice | int | 是 | 购卡金额，单位分 | |
| goodsItem.userCardInfo | Array | 是 | 用户权益卡信息 | |
| goodsItem.userCardInfo.startTime | String | 是 | 权益卡生效时间，yyyy-MM-dd HH:mm:ss | |
| goodsItem.userCardInfo.endTime | String | 是 | 权益卡失效时间，yyyy-MM-dd HH:mm:ss |