抖音开放平台Logo
开发者文档
控制台

订单查询能力

收藏
我的收藏

业务场景

用于服务商/自研开发者查询抖音侧订单状态,主要两个作用:

  • 查询并校验两侧订单状态一致性。
  • 查询并感知订单状态,由于网络等原因该部分状态可能当时未感知到。

接入前期准备

根据以下文档完成开发者账号开通认证、生活服务应用的创建、申请解决方案和接口权限。

技术服务商:技术服务商接入指南

自研:自研商家接入指南

需要申请的能力

订单查询

业务流程

1、订单查询

服务商通过接口查询订单详情,支持三种查询方式:

  • 订单 ID 或第三方订单号,查询对应订单详情,入参:订单 ID/第三方订单号、商户 id。
  • 根据订单状态和商户 id,查询指定时间内该商户下的订单列表,入参:商户 id、订单状态、创单起止时间/修改起止时间。
  • 根据用户 id 和商户 id,查询某用户在该商户下的所有订单,入参:商户 id、用户 id、创单起止时间/修改起止时间。

2、订单通知

  • 订单消息通知,用于用户下单完以后向商家通知订单消息。
  • 券消息通知,用于用户下单完以后向商家通知券消息,和订单消息区别是维度不一样,一张订单下面可能会有多张券。

对接接口

接口

接口路径

调用方

订单查询

https://open.douyin.com/goodlife/v1/trade/order/query/

商家/服务商

订单消息通知

地址由服务商/商家提供

抖音

券消息通知

地址由服务商/商家提供

抖音

该文档是否有帮助?