拒付通知接入说明
# 异步通知概述
- 如需开通拒付通知,可以联系技术支持同学进行配置。
- 每当,拒付相关事件发生时(如调单发生时),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。
- 地址不能携带参数。
# 处理拒付通知
使用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 | 进入仲裁阶段通知 |
上次更新: 2024/11/14, 13:20:12
Previous
←
拒付API接入说明