Skip to content

通知

支付完成后,PayerMax会把相关支付结果通过数据流的形式发送给商户,商户需要接收处理,并按文档规范返回应答。

1. 通知规范

(1) 因网络异常会重试通知,商户需要正确处理幂等。

(2) 商户在收到PayerMax结果通知时,需要正确响应,如果不正确响应,PayerMax会判定本次通知失败,并重新发送通知,直到成功为止(在通知一直不成功的情况下,PayerMax 总共会发起多次通知,),但 PayerMax 不能保证这些通知最终一定能成功。

(3) 在订单状态不明或者没有收到PayerMax支付结果通知的情况下,建议商户主动调用 PayerMax的【付款查询】确认订单状态。

(4) 商户在收到通知时,需要依据通知中的status更新交易结果,status的状态描述见【交易状态/错误码】

注意:

不可以根据code和message更新交易结果。

特别提醒:

  1. 商户系统对于支付结果通知的内容需要做签名验证。
  2. 当收到通知进行处理时,应首先检查对应业务数据的状态,判断该通知是否已经被处理过,如果没有处理请再进行处理,处理过的可直接返回成功。
  3. 通常只会在交易到达终态时(成功、失败、退票)进行回调,但是当该支付方式在支付中状态下存在需要商户/用户感知的信息时,也会进行回调通知。

2. 付款结果异步回调通知

详情参阅:异步回调通知

3. 商户侧返回参数

参数类型是否必填最大长度描述示例值
codeStringM32响应 ‘SUCCESS’SUCCESS
msgStringO256响应 ‘Success’Success

此页面的内容有帮助吗?

感谢您帮助改进 PayerMax 产品文档!

Last updated:

Released under the MIT License.