支付回调和查单实现指引
约 599 字大约 2 分钟
2025-03-07
背景
PingPongCheckout V4提供两种同步商户服务端和PingPongCheckout 服务端的状态的方式：
如果仅仅依靠异步通知，由于网络异常或者系统的波动，可能会导致用户支付成功，但是商户侧未能成功接收到支付结果通知，进而显示订单未支付的情况。商户侧的订单状态更新不及时，容易造成用户投诉。
解决方案
- 商户前端页面重定向到payResultUrl页面，商户需要调用商户查单接口确认订单状态，并把查询结果展示给用户。
- 商户后台需要准确、高效地处理PingPongCheckout V4 支付发送的异步支付结果通知，并按接口规范把处理结果返回。
- 商户后台未收到异步支付结果通知时，商户应该主动调用 交易查询 ，同步订单状态。
提示
上述方案最契合收银台接入方式，若是Non-hosted模式接入，可以直接从下单并支付同步返回结果中获取订单状态。若获取的结果不是终态，可以按照上述流程执行。
PingPongCheckout主导的关单
由于用户长时间未支付的订单，PingPongCheckout V4会进行关单处理，关闭订单后，用户无法继续支付，商户可以通过查询接口或者异步通知获取到CLOSED状态。
提示
如果上送了自定义关单结果通知地址 closeNotificationUrl，订单到达CLOSED状态会发送关单通知。