--- url: >- https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/risk/disputeNotify/index.md description: 说明拒付相关异步通知的开通、接收、验签和响应要求，帮助商户按 eventCode 更新争议处理状态。 --- ## 异步通知概述 - 如需开通拒付通知，可以联系技术支持同学进行配置。 - 每当，拒付相关事件发生时（如调单发生时），PingPongCheckOut 通知服务将会创建一个JSON对象，其中包含事件相关的数据等信息。 - 然后，PingPongCheckOut 通知服务通过 HTTP POST 请求将JSON对象发送到已配置的通知地址中。商户侧在收到回调通知后，可根据异步通知报文做下一步的业务处理。 ## 接收异步通知 ### 准备一个支持 HTTP POST 的web服务 PingPongCheckOut 通知服务将以 HTTP POST 方式推送 JSON 格式的数据，因此开发者所提供的 Web 服务需要能够接收并解析来自HTTP POST 请求的 JSON 数据并能够返回相应 HTTP 状态码。 ### 技术支持配置回调通知地址 - 通知地址需要提供商户自己系统的真实地址，不能填写接口文档或demo上的示例地址。 - 必须是以 `https://` 或 `http://` 开头的完整全路径地址，并且确保 URL 中的域名是外网可以访问的，不能填写 localhost、127.0.0.1、192.168.x.x 等本地或内网地址。 - 建议使用标准 Web 端口：`https://` 默认使用 443 端口，`http://` 默认使用 80 端口。 - 如需区分不同业务场景，建议使用路径形式，例如 `/notify/dispute`。 #### 正确示例 - 完整公网地址：`https://pay.example.com/notify/receive` - 使用不同业务路径：`https://pay.example.com/callback/dispute` - HTTP 标准端口地址：`http://notify.example.com/receive` #### 错误示例 - 只有相对路径：`./PayNotify.aspx` - 只有地址，没有具体服务路径：`https://example.demo.cn` - 本地内网地址，互联网无法访问：`https://localhost:8080/notify/` ### 处理拒付通知使用eventCode来确定拒付处于哪个阶段。商户在成功收到异步处理结果后，响应 HttpCode 为 200，表示商户已经成功收到异步结果通知，否则，会当作通知失败处理，触发重试机制重试 3 次，3 次后还是失败则不再继续通知，商户可通过查询接口查询拒付状态。 | eventCode | 描述 | |-----------------------------------------------------------|-------------| | NOTIFICATION_OF_PREDISPUTE | 未升级争议 | | REQUEST_FOR_INFORMATION | 调单通知 | | NOTIFICATION_OF_FRAUD | 欺诈提醒通知 | | NOTIFICATION_OF_CHARGEBACK | 拒付通知 | | CHARGEBACK_RETURN | 拒付驳回通知 | | PREARBITRATION | 预仲裁通知 | | CHARGEBACK_REVERSED | 拒付撤销通知 | | PREARBITRATION_WON | 预仲裁成功的结果通知 | | PREARBITRATION_LOST | 预仲裁失败的结果通知 | | DISPUTE_DEFENSE_PERIOD_ENDED | 拒付抗辩时间已截止通知 | | ARBITRATION | 仲裁阶段通知 |