返回顶部

抖音核销接口

只做【订单明细查询 + 核销明细查询】所需全部内容

目标：拉取成交订单列表（支付成功订单）、拉取券核销历史记录；不需要验券准备、验券核销、撤销核销等核销操作接口，那些是前台收银用的，你只读数据不用接。

✅ 一、必须对接的2个业务接口

  1. 成交明细（订单查询）

  2. 核销明细（验券历史查询）

✅ 二、必须额外对接：Client_token 获取接口（调用凭证）

所有接口请求头都要携带 access-token，需要定时刷新（有效期2小时）

这是基础凭证接口，必须开发，否则无法调用上面两个业务接口。

✅ 三、平台侧准备工作（开发前）

  1. 抖音开放平台注册，创建【生活服务商家应用】
  2. 在应用的解决方案里申请开通两个权限：
    • life.capacity.order.query（订单查询）
    • life.capacity.billing（团购对账）
  3. 商家在抖音来客后台，对你这个应用做授权（服务商模式需要；自研商家主体一致则简化）
  4. 获取：client_key(AppId)、client_secret(AppSecret)、商户 account_id（商家总店ID）

✅ 四、开发逻辑要点（分页逻辑）

两个业务接口都是游标分页（cursor）：

  1. 首次查询：cursor=0，指定 size（订单接口最多100，核销记录接口最多20）
  2. 拿到返回的 next_cursor，循环带入下一次请求
  3. 直到返回 next_cursor 为空，代表全部数据拉取完成
  4. 入参带上时间范围（start_time、end_time，时间戳秒）做增量同步，避免每次全量拉取

✅ 五、可选（按需，非必需）

分账账单接口 ledger/query/：如果你后续还要查结算金额、佣金，才需要；单纯订单+核销明细查询不需要。

❌ 完全不需要接入的接口

验券准备、验券核销、撤销核销、单张券查询、批量券查询，全部不用。

这些是前台扫码核销用的，你的场景只是查询报表。

极简汇总清单

接口：3个（订单查询、核销记录查询、client_token获取）
权限：2个（life.capacity.order.query + life.capacity.billing）
核心参数：account_id、access-token、cursor、size、起止时间戳

posted @ 2026-09-22 11:31  怪奇  阅读(4)  评论(0)    收藏  举报