抖音开放平台Logo
控制台

抖音服务市场订单事件

更新时间 2024-07-24 02:58:49
收藏
我的收藏

概述

Webhooks 说明文档可参考:Webhooks 概述

webhook 是用户事件触发反向通知的机制,用户需要申请market.service.user这个 scope,抖音服务市场提供的 Webhooks 事件如下。

事件名称

事件介绍

订单事件

触发时机:用户订单状态改变

使用限制

  • 需要在抖音服务市场申请平台应用类服务,且勾选“是否需要订阅webhook消息”,且服务通过审核。
  • 服务接入的应用申请market.service.user这个scope。

申请地址:抖音开放平台-控制台-我的应用-权限管理-特殊权限

申请链接:https://developer.open-douyin.com/webapp/应用 client_key/ability/special

  • 服务接入的应用订阅服务市场订单事件。

申请地址:抖音开放平台-控制台-我的应用-设置-开发设置

申请链接:https://developer.open-douyin.com/webapp/应用 client_key/setting/develop-info

事件说明

  • 事件名称 : "抖音服务市场订单事件"。
  • 事件介绍 : 对于抖音服务市场的用户购买“平台应用类服务”的订单,在订单状态改变时,服务市场会通过开放平台Webhooks机制,将事件推送到开发者配置好的回调地址。
  • 事件内容定义如下:其中响应参数中的 remain_service_times、effective_time 和 expire_time,根据服务周期的不同返回不同的结果:对于服务周期为“按次服务”和“按条服务”的服务,返回 remain_service_times。对于服务周期为“时间类型”的服务,返回 effective_timeexpire_time

事件参数

名称

类型

描述

示例值

event

string

事件名称

service_market_order

client_key

string

应用client_key

awa3utacdjjpxxxx

from_user_id

string

购买用户open_id

c97cdcb3-76a1-433b-92c9-7abc6241xxxx

content

string

消息内容,json格式



order_id

string

订单id

701913106392234xxxx


order_event

int

事件类型

1:用户支付订单

2:服务商接单

3:服务商确认实施订单

4:用户确认订单

5:取消订单


order_snapshot

struct

订单快照信息




order_id

string

订单id

701913106392234xxxx



service_id

string

服务id,服务的唯一标识

7021602203591******



service_name

string

服务名称

服务名称



service_mode_id

string

服务规格id,由服务商在创建服务时指定

standard_1



specification_type

int

服务规格类型

1:体验版

2:定制版

3:标准版



specification_title

string

服务规格名称

标准版



create_time

int64

订单创建时间

1631850028000



order_event_time

int64

订单状态改变时间,对应order_event类型

1631850028000


purchase_info

struct

用户与服务规格订购关系




order_id

string

订单id

701913106392234xxxx



service_id

string

服务id,服务的唯一标识

7021602203591******



service_mode_id

string

服务规格id,由服务商在创建服务时指定

standard_1



specification_type

int

服务规格类型

1:体验版

2:定制版

3:标准版



effective_time

int64

服务生效毫秒级时间戳

1651409686000



expire_time

int64

服务失效毫秒级时间戳

1651841686602



remain_service_times

int64

剩余服务次数/条数

1

log_id

string

日志id

202209021108180101350232201xxxxxx

事件参数示例

{
   "event": "service_market_order",
   "client_key": "awa3utacdjjpxxxx",
   "from_user_id": "c97cdcb3-76a1-433b-92c9-7abc6241xxxx",
   "content": "{\"order_id\":\"701913106392234xxxx\",\"order_event\":1,\"order_snapshot\":{\"order_id\":\"701913106392234xxxx\",\"service_id\":\"7021602203591******\",\"service_name\":\"服务名称\",\"service_mode_id\":\"standard_1\",\"specification_type\":3,\"specification_title\":\"标准版\",\"create_time\":1631850028000,\"order_event_time\":1631850028000},\"purchase_info\":{\"order_id\":\"701913106392234xxxx\",\"service_id\":\"7021602203591******\",\"service_mode_id\":\"standard_1\",\"specification_type\":3,\"effective_time\":1651409686000,\"expire_time\":1651841686602}}",
   "log_id": "2022090211081801013502322010023F26"
 }

 // content unstringfy后
{
    "order_id": "701913106392234xxxx",
    "order_event": 1,
    "order_snapshot": {
        "order_id": "701913106392234xxxx",
        "service_id": "7021602203591******",
        "service_name": "服务名称",
        "service_mode_id": "standard_1",
        "specification_type": 3,
        "specification_title": "标准版",
        "create_time": 1631850028000,
        "order_event_time": 1631850028000
    },
    "purchase_info": {
        "order_id": "701913106392234xxxx",
        "service_id": "7021602203591******",
        "service_mode_id": "standard_1",
        "specification_type": 3,
        "effective_time": 1651409686000,
        "expire_time": 1651841686602
    }
}