在SpringBoot中使用PayPal REST API接收对象遇问题

一、Webhook验证返回false的可能原因及修复 #

• Header大小写不匹配：PayPal的Webhook验证逻辑对Header名大小写敏感，但部分服务器会自动将请求头转为小写。修改getHeadersInfo方法，统一将Header名转为小写后存入Map，确保与PayPal要求的头名匹配：

  private static Map<String, String> getHeadersInfo(HttpServletRequest request) {
      Map<String, String> map = new HashMap<>();
      Enumeration<String> headerNames = request.getHeaderNames();
      while (headerNames.hasMoreElements()) {
          String key = headerNames.nextElement();
          String lowerKey = key.toLowerCase();
          String value = request.getHeader(key);
          map.put(lowerKey, value);
      }
      return map;
  }
  

• Webhook ID或环境不匹配：确认代码中的WebhookId与PayPal后台创建Webhook时生成的ID完全一致，同时mode参数（沙箱/生产）需与Webhook创建的环境对应。

• 请求Body读取不完整：检查getBody方法是否完整读取了请求体，可在读取后打印Body内容，与ngrok捕获的请求体对比，避免因流读取截断导致验证失败。

• SDK版本兼容性问题：你使用的旧版PayPal Java SDK已归档，可能与最新Webhook验证逻辑不兼容。建议升级至官方推荐的SDK版本，或直接调用PayPal的Webhook验证API接口。

二、找不到订阅/订单/客户类的解决方案 #

旧版paypal-api-payments库仅支持PayPal v1 API，而订阅、订单等属于v2 API范畴，因此SDK中没有对应的实体类。可通过以下两种方式解决：

1. 自定义POJO+JSON解析 #

使用Jackson或Gson等JSON库，根据PayPal Webhook返回的Payload结构创建自定义实体类，验证通过后直接解析Body：

// 引入Jackson依赖后，创建Subscription实体类
@JsonIgnoreProperties(ignoreUnknown = true)
public class Subscription {
    @JsonProperty("id")
    private String id;
    @JsonProperty("status")
    private String status;
    // 按需添加其他字段及getter/setter
}

// 在Servlet中解析
ObjectMapper mapper = new ObjectMapper();
String body = getBody(req);
JsonNode eventNode = mapper.readTree(body);
String eventType = eventNode.get("event_type").asText();

if ("BILLING.SUBSCRIPTION.CREATED".equals(eventType)) {
    Subscription subscription = mapper.treeToValue(eventNode.get("resource"), Subscription.class);
    // 处理订阅数据
}

2. 迁移至PayPal v2 SDK #

尽管部分旧SDK已归档，PayPal仍提供v2 API的Java支持。更新项目依赖至对应v2 SDK，即可直接使用官方提供的订阅、订单等实体类。

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