开发
API
自2022年9月6日起,本文档站不再更新内容,相关文档已迁移至全新“抖音开放平台”前往

支付结果回调

接口功能描述:将用户支付成功消息通知给开发者/服务商

  1. 回调可能存在延时,若实时性要求高,开发者可以通过主动请求支付结果查询接口,感知支付结果。
  2. 只有支付成功才有回调,支付失败或者支付超时不会回调。
  3. 通知失败的重试时间间隔:15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h。
  4. 支付回调一定要做验签处理,防止收到假通知。

参数

类型

是否必填

最大长度

描述

示例值

timestamp

number

取值范围:[1,9999999999]

Unix 时间戳,10 位,整型数

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

签名

52fff5f7a4bf4a921c2daf83c75cf0e716432c73

msg 列表单项

参数

类型

是否必填

最大长度

描述

示例值

appid

string

64

当前交易发起的小程序id

tt07e3715e98c9aac0

cp_orderno

string

64

开发者侧的订单号

out_order_no_1

cp_extra

string

2048

预下单时开发者传入字段


way

string

1

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

抖音侧订单号

71016888186626816

{
  "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\":\"\"}",
  "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"
}
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助