同步核销状态接口
开发者通过同步核销状态接口,当用户在开发者小程序中核销卡券后,将核销状态同步至百度服务器,用户卡券包中会对所核销的卡券进行使用状态变更。
核销卡券接口
HTTP 请求方式
POST/form https://openapi.baidu.com/rest/2.0/smartapp/v1.0/coupon/code/consume?access_token=ACCESS_TOKEN
请求参数
参数 | 说明 | 类型 | 是否必传 |
---|---|---|---|
couponId | 卡券 ID | String | 是 |
couponTakeId | 百度分配的用户领取 id | Long | 是 |
openId | 用户 id | String | 是 |
返回示例
{
"errno": 0,
"msg": "success",
"data": true
}
返回参数说明
参数名 | 描述 |
---|---|
errno | 错误码 |
msg | 错误信息 |
data | true 退还成功 false 退还失败 |
取消核销接口(卡券退回)
当用户在小程序内关闭 / 取消订单,或者发起退款等售后的场景下,若开发者小程序内的业务逻辑允许退回卡券,可通过该接口退回用户的卡券,为核销卡券的逆向流程。
HTTP 请求方式
POST/form https://openapi.baidu.com/rest/2.0/smartapp/v1.0/coupon/return?access_token=ACCESS_TOKEN
请求参数
参数名 | 必填 | 类型 | 描述 |
---|---|---|---|
couponId | 是 | String | 卡券 ID |
openId | 是 | String | 用户 id |
couponTakeId | 是 | Long | 百度分配的用户领取 id |
返回示例
{
"errno":0,
"msg":"success",
"data":true
}
返回参数说明
参数名 | 描述 |
---|---|
errno | 错误码 |
msg | 错误信息 |
data | true 退还成功 false 退还失败 |