接入指南 接入指南
  • 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)
  • 开发指南

    • API调用说明
    • 如何生成请求签名
    • 支付通知接入说明
    • 最佳实践

      • klarna OSM
      • 如何获取订单状态
        • 背景
        • 解决方案
        • PingPongCheckout主导的关单
      • 换汇说明
      • 交易幂等
      • 交易挽回
      • APM 接入方式实践
      • 特殊支付方式退款
    • 常见问题

      • 集成问题
  • v4

支付回调和查单实现指引

# 支付回调和查单实现指引

# 背景

PingPongCheckout V4提供两种同步商户服务端和PingPongCheckout 服务端的状态的方式:

  1. 异步通知
  2. 交易查询

如果仅仅依靠异步通知,由于网络异常或者系统的波动,可能会导致用户支付成功,但是商户侧未能成功接收到支付结果通知,进而显示订单未支付的情况。商户侧的订单状态更新不及时,容易造成用户投诉。

# 解决方案

加载中...
状态查询时序图
  1. 商户前端页面重定向到payResultUrl页面,商户需要调用商户查单接口确认订单状态,并把查询结果展示给用户。
  2. 商户后台需要准确、高效地处理PingPongCheckout V4 支付发送的异步支付结果通知,并按接口规范把处理结果返回。
  3. 商户后台未收到异步支付结果通知时,商户应该主动调用 交易查询 ,同步订单状态。

提示

上述方案最契合收银台接入方式,若是Non-hosted模式接入,可以直接从下单并支付同步返回结果中获取订单状态。若获取的结果不是终态,可以按照上述流程执行。

# PingPongCheckout主导的关单

由于用户长时间未支付的订单,PingPongCheckout V4会进行关单处理,关闭订单后,用户无法继续支付,商户可以通过查询接口或者异步通知获取到CLOSED状态。

提示

如果上送了自定义关单结果通知地址 closeNotificationUrl,订单到达CLOSED状态会发送关单通知。

上次更新: 2025/01/14, 17:47:54

Previous
← klarna OSM
Next
换汇说明→

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