拒付通知接入说明
约 746 字大约 2 分钟
2025-03-07
异步通知概述
- 如需开通拒付通知，可以联系技术支持同学进行配置。
- 每当，拒付相关事件发生时（如调单发生时），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 | 进入仲裁阶段通知 |