说明

1.接口说明

  • 白标自研服务通过白标后台设置webhook地址。后续指定的事件发生时,会对此接口进行数据推送
  • 推送数据失败后,会每隔3秒进行再次推送,推送失败5次后将不在进行推送。
  • 设置的webhook地址需先提供给UPay进行验证,才能进行成功推送

2.请求方式

请求方式POST
请求体以content-type=application/json ;charset=UTF-8形式传输

3.Header参数

参数类型是否必填项描述
X-UPA-REQUESTIDString全局唯一请求ID,保持唯一便于后续定位问题
X-UPA-TIMESTAMPlong13位时间戳,请求发起时间

4.请求体参数

  • 请求体说明
    请求体内容通过白标后台设置的公钥进行加密。
  • 卡webhook事件和数据格式
    参考

5.返回参数

白标自研服务接到请求,需在5秒内响应.

  • 成功:Http状态码等于200并且响应内容为SUCCESS
  • 失败:超时、HTTP状态码不等于200或返回结果不是SUCCESS会被UPay判定为失败。

如果响应判定为失败,会进行重发,每隔3秒重试1次,重发次数上限5次。白标自研服务需要做好幂等处理,防止业务异常。