抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • OpenAPI 简介
  • 通用参数
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 触达与营销
  • 支付
  • 运营
  • 生活服务
  • 通用能力
  • 生活服务交易系统(全融合版)
  • 生活服务交易系统(账号融合版)
  • 错误码和返回码
  • 通用参数
  • 预约
  • 查询接口
  • 预下单
  • 营销算价
  • 支付
  • 核销
  • 抖音码
  • 三方码
  • 核销工具
  • 查询用户券列表
  • 查询订单可用门店
  • 券核销消息通知
  • 撤销核销消息通知
  • 设置商家展示信息
  • 查询商家配置文案
  • 设置订单详情页按钮白名单接口
  • 设置小程序跳转path
  • 原生券信息查询
  • 【核销】核销原生券(简化版独有)
  • 【核销】加解锁(简化版独有)
  • 推结算状态
  • 兜底核销通知
  • 分账
  • 退货退款
  • CPS佣金设置与查询
  • 随心团解决方案
  • 核销工具解决方案
  • 历史版本(不推荐使用)
  • 垂直行业
  • 其它
  • 平台兜底核销时,通知开发者
    注意:
      此通知仅针对平台兜底核销逻辑
      此通知目前仅混合双开外卖配送/自提场景适用
      平台兜底核销目前走白名单机制,需要接入请联系产运同学配置appid和推送兜底核销时间间隔
      此通知复用混合双开外卖支付成功通知回调url,type增加履约完成枚举,详见下文请求参数

    使用限制

    白名单机制

    接口说明

      由于网络波动等原因,可能会产生重复的通知消息,接入方需要做好幂等,正确处理。
      在开发者服务端收到回调且处理成功后,需要按以下正常返回示例返回并且 HTTP 响应状态码设为 200,否则会认为通知失败进行重试。

    基本信息

    基本信息
    HTTP URL
    在解决方案配置-消息通知中指定的回调地址,配置方式参考解决方案配置文档
    HTTP Method
    POST

    请求头

    参见通用参数

    请求参数

    参数名称
    类型
    是否必填
    描述
    示例值
    msg
    string
    订单相关信息的 json 字符串
    见请求示例
    type
    string
    枚举值
    fulfillment
    fulfillment
    version
    string
    固定值:"2.0"。
    回调版本,用于开发者识别回调参数的变更
    2.0

    msg 字段

    字段名
    类型
    是否必填
    描述
    示例值
    app_id
    string
    小程序 app_id
    ttcxxxxxx
    status
    string
    支付结果状态,目前有两种状态:
    •"SUCCESS" (支付成功 )
    •"CANCEL" (支付取消)
    SUCCESS
    order_id
    string
    抖音开平侧订单id,长度 <= 64byte
    ot7057416814925531429
    event_time
    int64
    用户支付成功/支付取消时间戳,单位为毫秒
    1643189272388
    out_order_id
    string
    开发者系统生成的订单号,与抖音开平交易单号 order_id 唯一关联,长度 <= 64byte
    ext_order_no_164318867591
    out_fulfill_order_id
    string
    外部履约单号
    参考更新履约状态out_fulfill_order_id字段
    ot7057416814925531429
    reason
    string
    原因
    系统兜底核销

    请求示例

    curl --location --request POST 'https://xxxxxxx.net/api/v2/result_callback?timestamp=1345678901234&nonce=iuy987q4htafreqw' \--header 'Content-Type: application/json' \ --data-raw='{ "version": "2.0", //本次固定为2.0, 通过版本信息识别,用不同的结构体去解析上述关键参数 "msg": "{\"app_id\":\"ttcce0ba5d53axxxxx\",\"status\":\"已送达\",\"order_id\":\"ots760078130087367xxxxx\",\"cp_extra\":\"{\\\"hostName\\\":\\\"Douyin\\\",\\\"use_trade_delivery\\\":1234511111}\",\"message\":\"\",\"event_time\":1769695801525,\"out_fulfill_order_id\":\"out_fulfill_order_id_ots76007813008736771006110\",\"out_order_id\":\"waimai_ots76007813008736771006110\",\"reason\":\"系统兜底核销\"}", "type": "fulfillment" }'

    msg 字段内容示例

    { "app_id": "ttcce0ba5d53aa5c0f01", "status": "已送达", "order_id": "ots76007813008736771006110", "cp_extra": "{\"hostName\":\"Douyin\",\"use_trade_delivery\":1234567890}", "message": "", "event_time": 1769695801525, "out_fulfill_order_id": "out_fulfill_order_id_ots76007813008736771006110", "out_order_id": "waimai_ots76007813008736771006110", "reason": "系统兜底核销" }

    响应参数

    参数名称
    类型
    描述
    示例值
    err_no
    int64
    错误码
    0
    err_tips
    string
    错误提示
    success

    响应示例

    正常示例

    //正常返回响应且http状态码为200 //注意://正常返回时一定要保证err_no和err_tips为下面标准返回方式,不然都认为失败,将会重试{"err_no": 0,"err_tips": "success"}

    异常示例

    //异常响应或http状态码为非200, //字节服务端会不断重试{"err_no": 1, //非0"err_tips": "system error" //非success}