接入指南 接入指南
  • V2 (opens new window)
  • V3 (opens new window)
  • V4-English (opens new window)
  • V4-经典版 (opens new window)
  • 接入指南
    • 接入准备
    • 快速启动
    • 开发指南
    • 接入方式
    • 工具
    • 附录
    • 术语
  • API文档
    • checkout
    • dispute
    • Tokenization
    • 异步通知
    • Marketplaces
    • Terminal integration API
  • Marketplaces
  • Accept in-person payments with Terminal
  • 覆盖国家
  • 风险管理
  • 对账服务
  • 支付方式
  • V2 (opens new window)
  • V3 (opens new window)
  • V4-English (opens new window)
  • V4-经典版 (opens new window)
  • 风险管理

    • Authentication

      • 动态3D接入说明
    • Disputes

      • 概览
      • Disputes API

        • 拒付API接入说明
        • 拒付通知接入说明
          • 异步通知概述
          • 接收异步通知
  • v4

拒付通知接入说明

# 异步通知概述

  • 如需开通拒付通知,可以联系技术支持同学进行配置。
  • 每当,拒付相关事件发生时(如调单发生时),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接入说明

杭州乒乓智能技术有限公司 | Copyright © 2015-2026 checkout.pingpongx.com.All Rights Reserved.
  • 浅色模式