新权益开放API文档

烈熊新权益系统


3.6申请售后接口(需要烈熊审核)

权益卡订单申请售后退款,需要走烈熊系统人工审核,审核通过后会进行退款

路径:/api/afterSales/afterSalesRequest

方法: POST

header:

参数名称 类型 长度限制 是否必填 介绍
Authorization String Bearer 客户认证令牌/会员认证令牌

请求参数:

字段名称 类型 长度限制 是否必填 介绍
orderNo String 32 烈熊订单编号
salesDetailId String 32 售卡商品id
afterType int 32 退款类型0.退款退卡
refundNum int 11 退货数量(1)
refundPrice int 11 退货金额(单位分)
afterRemark String 退款原因
notifyUrl String 通知推送地址
{
    "orderNo": "烈熊订单id",
    "salesDetailId": "售卡商品id",
    "afterType": "0",
    "refundNum": "1",
    "refundPrice": "1",
    "afterRemark": "kehutuikuan",
    "notifyUrl": "通知推送地址"
}

返回:

字段名称 类型 长度限制 介绍
afterSalesOrderNo String 烈熊售后单号
{
  "code": "0",
  "message": "请求成功",
  "data": {
    "afterSalesOrderNo": "1502178186748788737"
  },
  "success": true
}

错误:

codes 问题描述 解决
401 Bearer令牌不允许为空/token无效 请检查Authorization参数
INTERESTS_10045 已有进行中的售后单 请检查订单状态
INTERESTS_10044 订单状态不合法,不能申请售后 请检查订单状态
INTERESTS_10058 退款金额错误
400 缺少参数 具体内容查阅返回的message字段

加入售后状态消息通知接口 注 · 当 notifyUrl 推送url参数不为空时,系统将按照下列格式像目标URL以body体json格式进行数据推送 三方接收到推送消息后,需给烈熊返回标识 success 表示成功接收到数据,就算本次推送完成。

推送参数:

字段名称 类型 长度限制 是否必填 介绍
orderNo String 32 烈熊订单编号
thirdOrderNo String 32 第三方订单编号
afterNo String 32 售后单号
refundNo String 11 退款单号
remark String 11 拒绝原因
pushTime String 11 推送时间
applyStatus int 11 处理结果,0.同意退款 1.拒绝退款 2.退款成功
{
   "afterNo": "1572137673509298178",
   "orderNo": "202209200000000000000657",
   "thirdOrderNo": "c74d00a9-457e-477e-8736-ffce8d3ae5ec",
   "pushTime": "2022-09-20 16:16:44",
   "applyStatus": 0
}

页面列表

ITEM_HTML