通知回调接口说明
回调说明
- 对于回调通知,如果华为支付未收到application/json类型响应的数据,或收到应答数据不是“000000”成功,华为支付会通过一定的周期定期重新发起通知,但不保证通知最终能成功。
- 相同通知可能多次重复发送给商户服务器,商户服务器需要正确实现以应对重复请求。 建议在商户服务器收到通知进行业务处理前先检查对应业务状态,对于未处理过的的场景才进行业务处理;已处理的场景则直接返回成功。建议在业务处理时,合理设计同步机制防止并发问题。
- 如果在预期时间内未收到华为支付回调请求,请排查提供的callbackUrl网络是否连通。如排除网络连通性问题,请调用同步查询接口确认订单状态。排查建议:
- 确认callbackUrl为商户系统真实地址,保证url中的域名或IP是外网可以正常访问的。不能填写localhost、127.0.0.1、192.168.x.x、10.xx.xx.xx等。
- callbackUrl必须为https://开头的完整地址。
- 对于收到的异步回调请求,请务必进行验签处理并在验签通过后进行后续业务流程。否则可能因为信息泄露导致对商户潜在的攻击,造成资金损失。
- 因商户自身系统实现问题导致的业务异常,资金损失,有商户自行承担。
- 如商户侧对支付回调地址有IP防火墙策略限制,需要对以下网段开通白名单,后续有变动时会在此处更新。
- 124.70.118.0/24
- 139.159.166.0/24
- 商户系统收到回调通知时,需要在3秒内返回应答响应,否则华为支付会认为通知失败,会触发重试机制。
- 商户系统收到异步通知并返回{"resultCode":"000000","resultDesc":"Success."} 时,服务器异步通知参数 callbackId 才会失效。同一个异步通知请求的多次重试callbackId是不变的。