用户手机号授权结果回调通知
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/open-capacity/trade-system/invoke-api/signature-algorithm/
使用限制
接口说明
如果抖音开平收到开发者的响应不符合规范或超时未收到，抖音开平会认为通知失败，并通过一定的重试策略再次发起通知。开发者应尽可能提高接收通知的成功率，抖音开平不保证通知最终能成功。
回调信息
| HTTP URL | 券模板配置的回调通知callback_url，详细可见券模板创建 。 要求必须为https地址。请确保回 调通知URL是外部可正常访问的，且不能携带后缀参数，否则可能导致无法接收到回调通知。 |
|---|---|
| HTTP Method | POST |
回调通知签名验证，可参考： 签名算法，重点关注 “签名验证” 部分。如下图所示部分：
请求 Body
| 参数 | 类型 | 是否必填 | 描述 | 示例值 |
|---|---|---|---|---|
| coupon_id | string | 是 | 券id，由平台生成，全局唯一 开发者可以用coupon_id作为幂等键，实现通知消息的幂等处理 | 709243586555366 |
| app_id | string | 是 | 小程序appid | ttxxxxxx |
| user_open_id | string | 是 | 领券用户的小程序open_id | 543SXXXXf234 |
| user_union_id | string | 是 | 领券用户的union_id | 3d5f4913-xxxx-443d-b7ab-538db3f4e237 |
| encrypted_phone | string | 是 | 加密后的手机号 | tFtxSF1KRkL4dxnMzqKCoApxnKAXXXXXXXXXXXXXLZl+h1I5JRhgCGPg/pQNXYtNbiDV== |
| rsa_key_version | int32 | 是 | rsa加解密密钥版本号。 抖音开放平台默认使用开发者在平台上上传的最新版本的密钥，但在发券期间如果开发者进行变更，会存在短时间内仍使用旧版本公钥进行加密的场景，因此需要开发者根据版本号使用对应的私钥进行解密。 | 1 |
| talent_open_id | string | 是 | 主播的小程序open_id | 6879SAVs5XXX0093 |
| talent_account | string | 是 | 主播的抖音号 | 687899XX92 |
密文手机号解密
1.
1.
示例：
回调示例
请求参数
Header 参数
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/open-capacity/trade-system/invoke-api/signature-algorithm/' \
--header 'Byte-Timestamp;' \
--header 'Byte-Nonce-Str;' \
--header 'Byte-Signature;' \
--header 'Authorization: Bearer <token>'响应示例响应示例
200 - 示例 1
{
"err_no": 0,
"err_msg": "string"
}修改于 2025-11-10 09:07:17