# 通知

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

### 1. 通知规范

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

(2) 商户在收到PayerMax结果通知时，需要正确响应，如果不正确响应，PayerMax会判定本次通知失败，并重新发送通知，直到成功为止（在通知一直不成功的情况下，PayerMax 总共会发起多次通知，通知频率为0s/30s/300s/600s/3600s/43200s - 总计6次），但 PayerMax 不能保证这些通知最终一定能成功。

(3) 在订单状态不明或者没有收到PayerMax支付结果通知的情况下，建议商户主动调用 PayerMax的[【付款查询】](https://docs.payermax.com/202606-version/disbursement/inquiry.md)确认订单状态。

(4) 商户在收到通知时，需要依据通知中的status更新交易结果，status的状态描述见[【交易状态/错误码】](/202606-version/appendix/disbursement/transaction-status.md)。

::: warning 注意：
不可以根据code和message更新交易结果。
:::

::: danger 特别提醒：
1. 商户系统对于支付结果通知的内容需要做签名验证。

2. 当收到通知进行处理时，应首先检查对应业务数据的状态，判断该通知是否已经被处理过，如果没有处理请再进行处理，处理过的可直接返回成功。 

3. 通常只会在交易到达终态时（成功、失败、退票）进行回调，但是当该支付方式在支付中状态下存在需要商户/用户感知的信息时，也会进行回调通知。 

:::

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

详情参阅：[异步回调通知](https://docs.payermax.com/api.html?docName=New%20Version&docVer=v1.0&docLang=cn#/paths/disbursementResultNotifyUrl/post)

### 3. 商户侧返回参数
| 参数 | 类型   | 是否必填 | 最大长度 | 描述           | 示例值 |
| ---- | ------ | -------- | -------- | -------------- | ------ |
| code | String | M        | 32       | 响应 ‘SUCCESS’ |    SUCCESS    |
| msg  | String | O        | 256      | 响应 ‘Success’ |    Success    |