支付结果回调_抖音开放平台

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

使用限制

无

接口说明

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 返回表示处理成功，否则小程序服务端会认为通知失败进行重试。

{
  "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

回调示例

{
  "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

响应示例

正常响应示例

{
  "err_no": 0,
  "err_tips": "success"
}

异常响应示例

{
  "err_no": 400,
  "err_tips": "business fail"
}

开发者文档

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

使用限制

接口说明

回调参数

回调示例

响应参数

公共响应参数

响应示例

正常响应示例

异常响应示例

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

​使用限制​

​接口说明​

​回调参数​

​回调示例​

​响应参数​

​公共响应参数​

​响应示例​

​正常响应示例​

​异常响应示例​

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

使用限制

接口说明

回调参数

回调示例

响应参数

公共响应参数

响应示例

正常响应示例

异常响应示例