- 小程序 OpenAPI SDK 总览
- OpenAPI 简介
- 用户登录态签名
- 签名算法
- 联合授权
- 接口调用凭证
- 登录
- 小程序码与小程序链接
- Web 化接入
- 私信和群聊
- 解决方案
- 线索组件
- 隐私协议
- 视频能力
- 搜索能力
- 任务能力
- 电商
- 生活服务
- 短剧行业
- 用户信息
- 分享
- 客服
- 交易工具
- 小程序券
- 交易系统
- 素材库
- 内容安全
- 泛知识
- 担保支付
- 评价
- 其它
- 订阅消息
- 小程序推广计划
- 挂载
- 分发
- 数据分析
- 服务类目
- 直播间能力
- 抖音开放能力
- 能力申请
- 页面结构自定义
- 普通二维码绑定
- 抖音号绑定
- 流量主
- 抖店绑定
支付结果回调收藏我的收藏
收藏
我的收藏将用户支付成功消息通知给开发者/服务商。
使用限制
无
接口说明
- 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 | 签名, | 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 | 是 | - | 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"
}
点击纠错