1.接口说明
- 白标自研服务通过白标后台设置webhook地址。后续指定的事件发生时,会对此接口进行数据推送
- 推送数据失败后,会每隔3秒进行再次推送,推送失败5次后将不在进行推送。
- 设置的webhook地址需先提供给UPay进行验证,才能进行成功推送
2.请求方式
请求方式 | POST |
请求体 | 以content-type=application/json ;charset=UTF-8形式传输 |
3.Header参数
参数 | 类型 | 是否必填项 | 描述 |
---|---|---|---|
X-UPA-REQUESTID | String | 是 | 全局唯一请求ID,保持唯一便于后续定位问题 |
X-UPA-TIMESTAMP | long | 是 | 13位时间戳,请求发起时间 |
4.请求体参数
- 请求体说明
请求体内容通过白标后台设置的公钥进行加密。 - 卡webhook事件和数据格式
参考卡
5.返回参数
白标自研服务接到请求,需在5秒内响应.
- 成功:Http状态码等于200并且响应内容为SUCCESS
- 失败:超时、HTTP状态码不等于200或返回结果不是SUCCESS会被UPay判定为失败。
如果响应判定为失败,会进行重发,每隔3秒重试1次,重发次数上限5次。白标自研服务需要做好幂等处理,防止业务异常。