同步核销状态接口

开发者通过同步核销状态接口,当用户在开发者小程序中核销卡券后,将核销状态同步至百度服务器,用户卡券包中会对所核销的卡券进行使用状态变更。

核销卡券接口

HTTP 请求方式

  1. POST/form https://openapi.baidu.com/rest/2.0/smartapp/v1.0/coupon/code/consume?access_token=ACCESS_TOKEN

请求参数

参数说明类型是否必传
couponId卡券 IDString
couponTakeId百度分配的用户领取 idLong
openId用户 idString

返回示例

  1. {
  2. "errno": 0,
  3. "msg": "success",
  4. "data": true
  5. }

返回参数说明

参数名描述
errno错误码
msg错误信息
datatrue 退还成功 false 退还失败

取消核销接口(卡券退回)

当用户在小程序内关闭 / 取消订单,或者发起退款等售后的场景下,若开发者小程序内的业务逻辑允许退回卡券,可通过该接口退回用户的卡券,为核销卡券的逆向流程。

HTTP 请求方式

  1. POST/form https://openapi.baidu.com/rest/2.0/smartapp/v1.0/coupon/return?access_token=ACCESS_TOKEN

请求参数

参数名必填类型描述
couponIdString卡券 ID
openIdString用户 id
couponTakeIdLong百度分配的用户领取 id

返回示例

  1. {
  2. "errno":0,
  3. "msg":"success",
  4. "data":true
  5. }

返回参数说明

参数名描述
errno错误码
msg错误信息
datatrue 退还成功 false 退还失败