抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • 接入前准备
  • API接口
  • 能力
  • 历史版本文档(不推荐)
  • 景区团购(在线预约)
  • 设置分佣比例
  • 代运营佣金
  • 建立代运营合作关系
  • 代运营合作
  • 景区日历票
  • 景区行业团购|在线预约解决方案
  • 餐饮团购
  • 线索经营
  • 预置码
  • 批量增加券码
  • 同步订单信息
  • 查询券码对应订单信息
  • 通知增加券码
  • 更新预售券的预约库存日历
  • 酒店日历房接口
  • 三方码
  • 酒店新预售券接口
  • 酒旅
  • 通用能力
  • 接入前准备
  • 查询券码对应订单信息

    收藏
    我的收藏
    用于预置码查询某张券对应的订单信息。

    使用限制

    无

    接口说明

    1、特殊场景下,如三方没有获取到抖音侧推送的订单信息,但用户实际到店使用核销时,可以通过此接口根据券码主动查询抖音侧的订单信息。然后进行核销处理。
    2、预置码解密方法,见文档最后部分解密方法和解密代码示例。

    基本信息

    HTTP URL
    https://open.douyin.com/goodlife/v1/fulfilment/reserve_code/bind_order_info/
    HTTP Method
    GET
    申请权限
    三方码发布
    权限要求
      •需要申请权限 ,路径:抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案
      •需要商家授权,路径:抖音来客>店铺管理>服务应用授权

    请求头

    参数
    描述
    必须
    Content-Type
    application/json
    是
    access-token
    根据这个地址获取的token
    是

    请求参数

    Body 请求

    参数名称
    类型
    参数描述
    必须
    account_id
    string
    商户ID
    是
    code
    string
    预置码
    是
    sku_id
    string
    该预置码适用的商品ID
    否

    请求示例

    https://open.douyin.com/goodlife/v1/fulfilment/reserve_code/bind_order_info/?account_id=123&code=aaa&sku_id=1

    响应字段

    字段
    类型
    描述
    必须
    extra
    object
    ​
    是
    .error_code
    int64
    接口错误码 0代表成功
    是
    .description
    string
    接口错误描述
    否
    .logid
    string
    抖音侧排查问题的标示
    是
    .now
    int64
    (弃用)响应秒时间戳
    是
    data
    ​
    ​
    是
    .error_code
    int64
    接口错误码 0代表成功
    是
    .description
    string
    接口错误描述
    否
    .order
    struct
    绑定订单信息
    否
    ..order_id
    string
    订单ID
    是
    ..codes
    list(string)
    预置码
    是
    ..sku_id
    string
    商品ID
    是
    ..third_sku_id
    string
    三方商品ID
    否
    ..create_time
    int64
    券发放秒时间戳
    是
    ..amount
    struct
    金额信息
    是
    ...original_amount
    int
    原始金额,单位分
    是
    ...pay_amount
    int
    实付金额,单位分
    是
    ...merchant_ticket_amount
    int
    商家营销金额,单位分
    否
    ...platform_ticket_amount
    int
    平台营销金额,单位分
    否
    ...payment_discount_amount
    int
    支付优惠金额,单位分
    否
    ...fee_amount
    int
    支付手续费,单位分
    否
    ..tourists
    list(object)
    出行人信息
    否
    ...name
    string
    姓名
    *非酒旅/票务场景,2024年2月29日起脱敏
    否
    ...phone
    string
    联系电话(需解密)
    *非酒旅/票务场景,2024年2月29日起脱敏
    否
    ...id_card
    string
    身份证号码(需解密)
    *非酒旅/票务场景,2024年2月29日起脱敏
    否

    响应示例

    { "extra": { "error_code": 0, "description": "success", "logid": "202204270930590102251460630F7BE7F3", "now": 1658921730 }, "data": { "error_code": 0, "description": "success", "order": { "order_id": "123", "sku_id": "456", "third_sku_id": "axxx", "codes": ["x1", "x2"], "create_time": 1658921722, "amount_info": { "original_amount": 110, "pay_amount": 50, "platform_ticket_amount": 5, "merchant_ticket_amount": 5, "fee_amount": 0, "payment_discount_amount": 50 }, "tourists": [ { "name": "张三", "phone": "bYlB3dcl8e8rDyAdD7yYCA==", "id_card": "bYlB3dcl8e8rDyAdD7yYCA==" } ] } } }

    错误码

    HTTP 状态码
    错误码
    错误消息
    排查建议
    200
    2190002
    access_token无效
    调用接口重新生成access_token
    200
    2190004
    应用未获得该能力, 请去https://open.douyin.com/申请
    应用申请接口权限
    200
    2190008
    access_token过期,请刷新或重新授权
    规范token刷新机制,检查是否有测试环境在同步刷新token
    200
    2119001
    参数不合法
    请求参数有误,排查参数
    200
    2119002
    系统繁忙,请稍候再试
    重试
    200
    2119003
    请求太过频繁,请稍后再试
    重试
    200
    2119005
    应用未获商家授权
    联系合作商家在商家后台发起授权,并在服务商后台同意授权
    200
    3000001
    根据实际业务错误返回
    对照接口文档规范参数并重试
    200
    4000001
    补充参数
    200
    4000002
    对照接口文档规范参数并重试
    200
    5000001
    联系抖音处理

    解密方法

      1.根据ClientKey找到ClientSecret,将ClientSecret向左右使用字符补齐32位/裁剪至32位,补齐:补位字符:#, 先补左侧再补右侧再补左侧······直到补满32位。裁剪:先裁剪左侧再裁右侧再裁左侧······直到剩余32位。(正常不需要补齐,secret默认为32位,此举是为了以防万一)
      2.将ClientSecret作为Key, 右侧16位为向量IV
      3.将密文进行base64解码。
      4.使用AES-256-CBC模式解密解码后的密文,对齐使用PKCS5Padding方式

    解密用代码示例

    Golang

    package utils import ( "bytes" "crypto/aes" "crypto/cipher" "encoding/base64" ) // AesDecrypt 解密函数 // encryptedStr:base64后的密文 // secret:appid/client_key对应的client_secret // return: []byte 明文 func AesDecrypt(encryptedStr string, secret string) ([]byte, error) { // 加密字符串进行base64解码 decodeBytes, err := base64.StdEncoding.DecodeString(encryptedStr) if err != nil { return nil, err } key, iv := parseSecret(secret) block, err := aes.NewCipher(key) if err != nil { return nil, err } blockSize := block.BlockSize() blockMode := cipher.NewCBCDecrypter(block, iv[:blockSize]) origData := make([]byte, len(decodeBytes)) blockMode.CryptBlocks(origData, decodeBytes) origData = PKCS5UnPadding(origData) return origData, nil } // parseSecret 将secret解析为key和iv func parseSecret(secret string) ([]byte, []byte) { // secret对齐为32位 secret = cutSecret(secret) secret = fillSecret(secret) key, iv := secret, secret[16:] return []byte(key), []byte(iv) } func fillSecret(secret string) string { if len(secret) >= 32 { return secret } rightCnt := (32 - len(secret)) / 2 leftCnt := 32 - len(secret) - rightCnt var byt bytes.Buffer byt.Write(bytes.Repeat([]byte("#"), leftCnt)) byt.WriteString(secret) byt.Write(bytes.Repeat([]byte("#"), rightCnt)) return byt.String() } func cutSecret(secret string) string { if len(secret) <= 32 { return secret } rightCnt := (len(secret) - 32) / 2 leftCnt := len(secret) - 32 - rightCnt return secret[leftCnt: 32+leftCnt] } func PKCS5UnPadding(origData []byte) []byte { length := len(origData) unpadding := int(origData[length-1]) return origData[:(length - unpadding)] }

    Java

    package com.douyin.open.goodlife; import javax.crypto.Cipher; import javax.crypto.spec.IvParameterSpec; import javax.crypto.spec.SecretKeySpec; import java.util.Base64; public class SignUtil { /* * appid/client_key对应的client_secret TODO 这里换成服务商的appsecret */ private static final String secret = "12345678901234566543210987654321"; private static final String key; private static final String iv; static { key = parseSecret(secret); iv = secret.substring(16); } /** * @Description AES解密 * @param data base64后的密文 * @return 明文 */ public static String decryptAES(String data) throws Exception { try { byte[] encrypted1 = decode(data);//先用base64解密 Cipher cipher = Cipher.getInstance("AES/CBC/PKCS5Padding"); SecretKeySpec keyspec = new SecretKeySpec(key.getBytes(), "AES"); IvParameterSpec ivspec = new IvParameterSpec(iv.getBytes()); cipher.init(Cipher.DECRYPT_MODE, keyspec, ivspec); byte[] original = cipher.doFinal(encrypted1); String originalString = new String(original); return originalString.trim(); } catch (Exception e) { e.printStackTrace(); return null; } } /** * base64编码 */ public static String encode(byte[] byteArray) { return new String(Base64.getEncoder().encode(byteArray)); } /** * base64解码 */ public static byte[] decode(String base64EncodedString) { return Base64.getDecoder().decode(base64EncodedString); } private static String parseSecret(String secret) { secret = fillSecret(secret); secret = cutSecret(secret); return secret; } private static String cutSecret(String secret) { if (secret.length() <= 32) { return secret; } int rightCnt = (secret.length() - 32) / 2; int leftCnt = secret.length() - 32 - rightCnt; return secret.substring(leftCnt, 32 + leftCnt); } private static String fillSecret(String secret) { if (secret.length() >= 32) { return secret; } int rightCnt = (32 - secret.length()) / 2; int leftCnt = 32 - secret.length() - rightCnt; StringBuilder sb = new StringBuilder(""); for (int i = 0; i < leftCnt; i++) { sb.append('#'); } sb.append(secret); for (int i = 0; i < rightCnt; i++) { sb.append('#'); } return sb.toString(); } }
    ​