签约结果通知
用户完成签约或订单超时后,系统会给向开发者的服务发起请求,将签约结果通知到开发者服务端。
使用限制
接入接口前请先查看接入前准备是否完成
接口说明
- •由于网络波动等原因,可能会产生重复的通知消息,接入方需要做好幂等,正确处理。
- •回调可能存在延时,开发者可以通过主动请求查询订单信息,确认支付结果。
- •在开发者服务端收到回调且处理成功后,需要按以下正常返回示例返回并且 HTTP 响应状态码设为 200,否则会认为通知失败进行重试。
- •签约结果通知地址的配置参考解决方案配置文档。
- •tt.createSignOrder 有 notify_url 字段,如果在签约下单传了该字段,则会优先使用下单的 notify_url 回调地址,否则使用解决方案配置的回调地址。
- ◦注意: 无论是否使用 notify_url 都需要配置解决方案的签约结果通知回调地址,否则即使下单传入 notify_url 也不会生效。
基本信息
基本信息 | ||||
HTTP URL | 在解决方案配置-消息通知中指定的回调地址,配置方式参考解决方案配置文档 | |||
HTTP Method | POST |
请求头
请求参数
Body
参数名称 | 类型 | 是否必填 | 描述 | 示例值 |
msg | string | 是 | 回调相关信息的 json 字符串,详情参见msg字段 | 见请求示例 |
type | string | 是 | 回调类型:
|
|
version | string | 是 | 固定值:"1.0"。回调版本,用于开发者识别回调参数的变更 | "1.0" |
msg 字段
字段名 | 类型 | 是否必填 | 描述 | 示例值 |
app_id | string | 是 |