5.3后付费权益卡开通接口

5.3后付费权益卡开通接口

接口说明

客户可通过该API接口为指定未付款用户先开通权益卡，让用户提前使用权益卡内的权益

路径:/interests-open-api/postPay/createOrder

方法: POST

> Body 请求参数

{
  "thirdOrderNo": "202108310000080000001215",
  "goodsItem": [
    {
      "salesDetailId": "1428284459796115458",
      "buyNum": 1,
      "onTime": "2021-09-03 19:14:21"
    }
  ]
}

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	否		none
» thirdOrderNo	body	string	是	客户权益卡订单号	校验客户订单号是否重复，重复返回对应错误code和描述
» goodsItem	body	[object]	是	购买商品组	商品组以Array形式传入
»» salesDetailId	body	string	是	权益卡商品编号	校验权益卡商品编号是否正确，错误返回对应错误code和描述
»» buyNum	body	integer	是	购买商品数量	目前只支持入参：1
»» onTime	body	string	是	权益卡开通时间	目前只支持默认值，格式：yyyy-MM-dd HH:mm:ss

header:

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

> 返回示例 > > 成功

{
  "code": "0",
  "data": {
    "orderNo": "202204020000000000008461",
    "thirdOrderNo": "20220328000222666",
    "goodsItem": [
      {
        "salesDetailId": "1428284459796115458",
        "userCardInfo": [
          {
            "userCardId": "1411937484253303032",
            "startTime": "2021-09-14 00:00:00",
            "endTime": "2021-09-14 23:59:59"
          }
        ]
      }
    ]
  },
  "message": "请求成功",
  "service": "",
  "success": true
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	string	true	none		none
» data	object	true	none		none
»» orderNo	string	true	none	平台权益卡订单号	none
»» thirdOrderNo	string	true	none	客户权益卡订单号	none
»» goodsItem	[object]	true	none	用户开通权益卡数据	none
»»» salesDetailId	string	true	none	权益卡商品编号	none
»»» userCardInfo	[object]	true	none	用户权益卡信息	none
»»»» userCardId	string	true	none	用户权益卡编号	none
»»»» startTime	string	true	none	用户权益卡生效时间	none
»»»» endTime	string	true	none	用户权益卡失效时间	none
» message	string	true	none		none
» service	string	true	none		none
» success	boolean	true	none		none

支付枚举值

枚举值	描述
ALI	支付宝
WX	微信
BF	宝付
YB	易宝
HSQ	慧收钱
OTHER	其他

错误

codes	问题描述	解决
401	Bearer令牌不允许为空/token无效	请检查Authorization参数
INTERESTS_10055	三方订单号不可重复下单
400	缺少参数	具体内容查阅返回的message字段