支付结果回调
收藏
我的收藏订单支付成功/取消时,抖音开平交易系统会向开发者的服务发起请求,将支付结果通知到开发者服务端。
使用限制
接口说明
- •收不到支付回调,请自查是否配置了回调地址, 参考解决方案配置文档。
- •由于网络波动等原因,可能会产生重复的通知消息,接入方需要做好幂等,正确处理。
- •回调可能存在延时,若实时性要求高,开发者可以通过主动请求查询订单信息,确认支付结果。
- •支付回调一定要做验签处理,防止收到假通知,可参考下文验签示例代码。
- •在开发者服务端收到回调且处理成功后,需要按以下正常返回示例返回并且 HTTP 响应状态码设为 200,否则会认为通知失败进行重试。重试频率为 15s/30s/1m/2m/4m/8m/16m/32m/64m/128m - 总共4小时12m。
- •JS API 下单 有 payNotifyUrl 字段,如果在下单传了该字段,则会优先使用下单的 payNotifyUrl 回调地址,否则使用解决方案配置的回调地址。
- ◦注意: 无论是否使用 payNotifyUrl 都需要配置解决方案的支付回调地址,否则即使下单传入 payNotifyUrl 也不会生效,详见接入前准备
基本信息
基本信息 | ||||
HTTP URL | ||||
HTTP Method | POST |
请求头
请求参数
参数名称 | 类型 | 是否必填 | 描述 | 示例值 |
msg | string | 是 | 订单相关信息的 json 字符串 | 见请求示例 |
type | string | 是 | 回调类型(支付结果回调为 payment):payment(支付成功/支付取消) | payment |
version | string | 是 | 固定值:"3.0"。回调版本,用于开发者识别回调参数的变更 | "3.0" |
msg 字段
字段名 | 类型 | 是否必填 | 描述 | 示例值 |
app_id | string | 是 | 小程序 app_id | ttcfdbb96650e33350 |
out_order_no | string | 是 | 开发者系统生成的订单号,与抖音开平交易单号 order_id 唯一关联,长度 <= 64byte | "motb52726742593307630520652" |
order_id | string | 是 | 抖音开平侧订单id,长度 <= 64byte | "ext_order_123" |
status | string | 是 | 支付结果状态,目前有两种状态: "SUCCESS" (支付成功 ) "CANCEL" (支付取消) | "SUCCESS" |
total_amount | int64 | 是 | 订单总金额,单位分支付金额为 = total_amount - discount_amount | 1000 |
discount_amount | int64 | 否 | 订单优惠金额,单位分,接入营销时请关注这个字段 | 0 |
pay_channel | int32 |