Paypal Transaction Search API交易状态更新延迟（退款后仍显示成功）求助

Transaction Search API本身存在状态同步延迟，官方说明部分交易的状态更新可能需要数小时甚至24小时，这就是你明明在Paypal后台看到退款完成，但API返回状态还是"S"的原因——依赖这个API的transaction_status参数过滤退款交易不可靠。

给你两个能实时获取交易状态的可行方案：

• 调用交易详情端点实时校验
  使用Paypal REST API的/v1/payments/sale/{sale_id}端点，这个端点能实时返回交易的最新状态，包括关联的退款记录。你可以先通过Transaction Search API拿到目标交易的sale_id，再单独调用这个端点，检查是否存在退款记录，以此判断交易是否已退款。

  示例代码（PHP）：

  // 假设已完成Paypal API客户端初始化
  $saleId = '从Transaction Search结果中提取的sale_id';
  $response = $paypalClient->get("/v1/payments/sale/{$saleId}");
  
  // 判断是否已退款
  if (isset($response->refunds) && count($response->refunds) > 0) {
      // 该交易已完成退款，可跳过或标记
  }
  

• 配置Webhook实时接收退款通知
  在Paypal后台配置Webhook，订阅PAYMENT.SALE.REFUNDED事件。当客户完成退款操作后，Paypal会主动向你指定的服务器地址推送通知，你可以在收到通知后立即更新本地系统中的交易状态，完全不用主动轮询，这是最高效的实时方案。

另外，你当前用transaction_status='S'过滤仍出现退款交易，本质就是API状态更新延迟导致的，暂时没有办法让Transaction Search API本身实时同步状态，只能通过上述两种方案绕过这个限制。

内容的提问来源于stack exchange，提问作者that guy