抖音开放平台Logo
控制台

支付结果回调
收藏
我的收藏

将用户支付成功消息通知给开发者/服务商。​

​使用限制​

无​

​接口说明​

    1.​回调地址会优先使用开发者在预下单接口传入的notify_url，如果预下单时没有传入，会请求开发者在进件时设置的支付URL，该URL查看步骤如下【开放平台控制台->小程序->能力->支付能力->支付设置】。​
    2.​支付回调一定要做验签处理，防止收到假通知，回调验签的Token见上图中的Token【开放平台控制台->小程序->能力->支付能力->支付设置】；Token在发生变更时，会以订单在支付时设置的Token为准。​
    3.​回调可能存在延时，若实时性要求高，开发者可以通过主动请求支付结果查询接口，感知支付结果。​
    4.​只有支付成功才有回调，支付失败或者支付超时不会回调。​
    5.​通知失败的重试时间间隔:15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h。​
    6.​如果没有收到回调，可以排查下回调地址是否正常，能否正确处理外部请求。​
    7.​在开发者服务端收到回调且处理成功后，需要按以下 json 返回表示处理成功，否则小程序服务端会认为通知失败进行重试。​
json
复制
{
"err_no": 0,
"err_tips": "success"
}

​回调参数​

名称​
类型​
是否必填​
最大长度​
描述​
示例值​
timestamp​
string​
是​
12​
Unix 时间戳，字符串类型​
1644399124​
nonce​
string​
是​
4​
随机数​
797​
msg​
string​
是​
-​
订单信息的 json 字符串​
{\"appid\":\"tt07e3715e98c9aac0\",\"cp_orderno\":\"out_order_no_1\",\"cp_extra\":\"\",\"way\":\"2\",\"payment_order_no\":\"2021070722001450071438803941\",\"total_amount\":9980,\"status\":\"SUCCESS\",\"seller_uid\":\"69631798443938962290\",\"extra\":\"null\",\"item_id\":\"\"}​
type​
string​
是​
32​
回调类型标记，支付成功回调为"payment"​
payment​
msg_signature​
string​
是​
128​
签名，​
详见签名DEMO​
52fff5f7a4bf4a921c2daf83c75cf0e716432c73​
msg 列表单项​
名称​
类型​
是否必填​
最大长度​
描述​
示例值​
appid​
string​
是​
64​
当前交易发起的小程序id​
tt07e3715e98c9aac0​
cp_orderno​
string​
是​
64​
开发者侧的订单号​
out_order_no_1​
cp_extra​
string​
是​
2048​
预下单时开发者传入字段​
​
way​
string​
是​
2​
way 字段中标识了支付渠道： 1-微信支付，2-支付宝支付，10-抖音支付​
2​
channel_no​
string​
是​
128​
支付渠道侧单号(抖音平台请求下游渠道微信或支付宝时传入的单号)​
2022052622001412479999452734​
payment_order_no​
string​
是​
128​
支付渠道侧PC单号，支付页面可见(微信支付宝侧的订单号)​
12107010014028882037​
total_amount​
number​
是​
取值范围:​
[0,99999999999]​
支付金额，单位为分​
100，即1元​
status​
string​
是​
7​
固定SUCCESS​
SUCCESS​
item_id​
string​
是​
-​
订单来源视频对应视频 id​
52fff5f7a4bf4a921c2daf83c​
seller_uid​
string​
是​
64​
该笔交易卖家商户号​
69631798443938962290​
paid_at​
number​
是​
取值范围:​
[0,9999999999]​
支付时间，Unix 时间戳，10 位，整型数​
1644399124​
order_id​
string​
是​
64​
抖音侧订单号​
N71016888186626816​

​回调示例​

json
复制
{
"timestamp": "1602507471",
"nonce": "797",
"msg": "{\"appid\":\"tt07e3715e98c9aac0\",\"cp_orderno\":\"out_order_no_1\",\"cp_extra\":\"\",\"way\":\"2\",\"payment_order_no\":\"2021070722001450071438803941\",\"total_amount\":9980,\"status\":\"SUCCESS\",\"seller_uid\":\"69631798443938962290\",\"extra\":\"null\",\"item_id\":\"\",\"order_id\":\"N71016888186626816\"}",
"msg_signature": "52fff5f7a4bf4a921c2daf83c75cf0e716432c73",
"type": "payment"
}

​响应参数​

​公共响应参数​

名称​
类型​
是否必填​
最大长度​
描述​
示例值​
err_no​
number​
是​
-​
返回码，0代表成功​
0​
err_tips​
string​
是​
-​
返回码信息​
SUCCESS​

​响应示例​

​正常响应示例​

json
复制
{
"err_no": 0,
"err_tips": "success"
}

​异常响应示例​

json
复制
{
"err_no": 400,
"err_tips": "business fail"
}
​