新权益开放API文档

烈熊新权益系统


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

页面列表

ITEM_HTML