--- 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中的域名和IP是外网可以访问的，不能填写localhost、127.0.0.1、192.168.x.x等本地或内网IP。 - 地址不能携带参数。 #### 正确示例 - 完整公网地址：`https://example.pay.cn:8080/notify/receive` - 使用公网 IP 且包含服务路径：`https://122.X.X.5:8080/notify/receive` #### 错误示例 - 只有相对路径：`./PayNotify.aspx` - 只有地址，没有具体服务路径：`https://example.demo.cn:80` - 本地内网地址，互联网无法访问：`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 | 仲裁阶段通知 |