通知
支付完成后,PayerMax会把相关支付结果通过数据流的形式发送给商户,商户需要接收处理,并按文档规范返回应答。
1. 通知规范
(1) 因网络异常会重试通知,商户需要正确处理幂等。
(2) 商户在收到PayerMax结果通知时,需要正确响应,如果不正确响应,PayerMax会判定本次通知失败,并重新发送通知,直到成功为止(在通知一直不成功的情况下,PayerMax 总共会发起多次通知,),但 PayerMax 不能保证这些通知最终一定能成功。
(3) 在订单状态不明或者没有收到PayerMax支付结果通知的情况下,建议商户主动调用 PayerMax的【付款查询】确认订单状态。
(4) 商户在收到通知时,需要依据通知中的status更新交易结果,status的状态描述见【交易状态/错误码】。
注意:
不可以根据code和message更新交易结果。
特别提醒:
- 商户系统对于支付结果通知的内容需要做签名验证。
- 当收到通知进行处理时,应首先检查对应业务数据的状态,判断该通知是否已经被处理过,如果没有处理请再进行处理,处理过的可直接返回成功。
- 通常只会在交易到达终态时(成功、失败、退票)进行回调,但是当该支付方式在支付中状态下存在需要商户/用户感知的信息时,也会进行回调通知。
2. 付款结果异步回调通知
详情参阅:异步回调通知
3. 商户侧返回参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
code | String | M | 32 | 响应 ‘SUCCESS’ | SUCCESS |
msg | String | O | 256 | 响应 ‘Success’ | Success |