查询券码对应订单信息
用于预置码查询某张券对应的订单信息。
使用限制
无
接口说明
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 | 是 |
请求参数
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 | 应用申请接口权限 | |
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(); } }
