- 餐饮
- 接入前准备
- 餐饮团购
- 门店管理
- 团购核销
- 团购退款
- 团购对账
- 会员接入
- 订单查询
- 三方码
- 商品发布及查询
- 酒旅
- 预置码
- 线索经营
- 代运营
撤销核销
更新时间 2024-10-12 09:51:16
收藏
我的收藏接口说明
1、针对“抖音团购券码、三方券码”两种券码误核销之后的撤销操作,订单状态由“已使用”回改为“待使用”,用于验券错误需要撤回验券等场景, 有时间限制,验券超过一个小时就不可再撤销。
2、extra.error_code、data.error_code 均为 0 代表撤销成功。
权限要求
- 需要申请权限 ,路径:抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案
- 需要商家授权,路径:抖音来客>店铺管理>第三方应用授权
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/goodlife/v1/fulfilment/certificate/cancel/ |
HTTP Method | POST |
Scope | life.capacity.fulfilment |
权限要求 | 团购核销 |
请求头
名称 | 字段类型 | 是否必填 | 示例 | 描述 |
---|---|---|---|---|
access-token | String | 是 | clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ | |
content-type | String | 是 | 固定值"application/json" |
请求参数
Body
名称 | 字段类型 | 是否必填 | 示例 | 描述 |
---|---|---|---|---|
certificate_id | String | 是 | 代表一张券码的标识(验券时返回) 该字段通过 /goodlife/v1/fulfilment/certificate/verify/ 接口返回的 data.verify_results[].certificate_id 字段获取 | |
verify_id | String | 是 | 代表券码一次核销的唯一标识(验券时返回) (次卡撤销多次时请填0) 该字段通过 /goodlife/v1/fulfilment/certificate/verify/ 接口返回的 data.verify_results[].verify_id 字段获取 | |
batch_cancel_info | Struct | 否 | 批量撤销某个订单下的一批验券记录(目前只支持次卡批量撤销!)
| |
batch_cancel_info_list | List | 否 | 批量撤销多个订单下的一批验券记录 | |
cancel_token | String | 否 | 撤销核销幂等操作,主要针对次卡,避免因超时等原因在短时间内重复请求导致撤销多次(幂等有效期1小时) 注意:如果是分门店结算,此字段不要传!!! | |
shop_order_id | String | 否 | 所属的订单id | |
times_card_cancel_count | Int64 | 否 | 取消核销总次数(多次卡商品可传,优先级低于verify_id) 注意:如果是分门店结算,此字段不要传!!! |
请求示例
{
"verify_id": "123456789",
"certificate_id": "987654321"
}