商户接入指南 商户接入指南
  • V2 (opens new window)
  • V3 (opens new window)
  • V4-English (opens new window)
  • V4-专业版 (opens new window)
  • V2 (opens new window)
  • V3 (opens new window)
  • V4-English (opens new window)
  • V4-专业版 (opens new window)
  • 概述

    • 起步
    • 对接流程
    • 联调资源
  • 服务

    • Checkout

      • 概览
      • Hosted
      • Non-Hosted
      • APIs

        • 下单(Hosted模式)
        • 下单并支付(Non-Hosted模式)
        • 交易查询
        • 申请退款
        • 退款查询
        • 预授权确认
        • 预授权确认查询
        • 预授权取消
        • 预授权取消查询
        • 异步通知
          • 异步通知概述
          • 接收异步通知
          • PingPongCheckout回调通知服务器信息
          • 通知报文
        • 上传物流信息
        • SFTP对账单下载
    • 订阅

      • 概览
      • 接入流程
    • 线下付款码支付

      • 接入流程
    • Tokenization

      • 概览
      • 接入流程
      • APIs

    • 风险管理

      • 概览
      • Dynamic 3D Secure
      • Disputes
      • APIs

    • 一键支付

      • 概览
      • 接入流程
      • APIs

    • ApplePay

    • GooglePay

    • KYB

    • 支付链

    • 建站工具

    • 工具

  • 附录

  • v4

异步通知

# 异步通知概述

  • 首先,商户侧配置异步回调通知notificationUrl地址。
  • 每当,交易相关事件发生时(如交易成功),PingPongCheckOut 通知服务将会创建一个JSON对象,其中包含事件相关的数据等信息。
  • 然后,PingPongCheckOut 通知服务通过 HTTP POST 请求将JSON对象发送到开发者配置的回调通知notificationUrl中。 商户侧在收到回调通知后,可根据异步通知报文做下一步的业务处理。

其流程描述如下:

# 接收异步通知

# 准备一个支持 HTTP POST 的web服务

PingPongCheckOut 通知服务将以 HTTP POST 方式推送 JSON 格式的数据,因此开发者所提供的 Web 服务需要能够接收并解析来自HTTP POST 请求的 JSON 数据并能够返回相应 HTTP 状态码。

# 设置回调通知地址

开发者可以通过各接口入参中的 notificationUrl 参数配置回调通知Url地址。

异步通知受双方网络连接状态影响,请确保通知地址公网可访问

# 接收并响应

对于商户交易通知响应,遵循以下约定:

接收结果 HTTP Code 约定 应答报文格式约定
接收成功 200 <= httpcode < 300,比如:200、201、204 无需返回应答报文(返回不会产生影响)
接收失败
  • httpcode > 300 或 httpcode < 200
  • 200 <= httpcode < 300,比如:200、201、204
  • 报文体任意
  • 需返回应答报文「FAIL」

重试机制:接收失败的情况下会触发重试机制,PingPongCheckout 会在随后的一段时间内,以递增的时间间隔重发,间隔为 5s/5s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h(若中间重试通知成功,则中断不再继续重试)。


注意 :

1. 商户不能仅仅依赖于异步通知,如果⻓时间未收到交易结果,商户应该主动向 PingPongCheckout 发起交易查询,查询对应的交易结果。

2. 请不要在`notificationUrl`后面携带query类型的参数,以免丢失,如果一定要携带,请使用pathInfo的URL模式。

3. 异步通知代码处理逻辑不能做登录态校验。


# PingPongCheckout回调通知服务器信息

如果商户侧需要防火墙配置后才允许 PingPongCheckout 消息通知服务推送数据,请根据下方信息进行防火墙设置,将IP加入到白名单:

生产环境 沙箱环境
3.125.243.2 52.76.198.228
3.126.196.22
18.195.199.34

# 通知报文

交易异步通知
退款异步通知
预授权确认通知
预授权撤销通知

上次更新: 2024/06/04, 14:22:43

← 预授权取消查询 上传物流信息→

杭州乒乓智能技术有限公司 | Copyright © 2015-2024 checkout.pingpongx.com.All Rights Reserved.
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式