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 |