PayPal PayerID与订单详情获取指南：通过订单ID检索完整交易数据

// 假设你有一个方法来获取PayPal的OAuth访问令牌
public String getPayPalAccessToken() {
    // 实际应用中，这里应调用PayPal OAuth2.0 API获取Access Token。
    // 通常涉及发送POST请求到 /v1/oauth2/token 端点，
    // 使用你的客户端ID和密钥进行Basic Auth认证。
    // 返回响应中的access_token字段。
    return "YOUR_PAYPAL_ACCESS_TOKEN"; // 请替换为实际获取到的Access Token
}

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import com.fasterxml.jackson.databind.ObjectMapper; // 假设使用Jackson库进行JSON处理

public class PayPalOrderService {

    private final HttpClient httpClient = HttpClient.newHttpClient();
    private final ObjectMapper objectMapper = new ObjectMapper();
    private static final String BASE_URL = "https://api-m.sandbox.paypal.com"; // 或生产环境URL
    private static final String ORDER_DETAILS_ENDPOINT = "/v2/checkout/orders/{id}";

    /**
     * 根据订单ID获取PayPal订单详情
     * @param orderId PayPal订单ID
     * @return 包含订单详情的DTO对象
     * @throws IOException 如果网络或数据解析失败
     * @throws InterruptedException 如果请求被中断
     */
    public PayPalOrderResponseDTO getOrderDetails(String orderId) throws IOException, InterruptedException {
        String accessToken = getPayPalAccessToken(); // 获取访问令牌

        // 构建请求URL
        String requestUrl = BASE_URL + ORDER_DETAILS_ENDPOINT.replace("{id}", orderId);

        // 构建HTTP请求
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(requestUrl))
                .header("Authorization", "Bearer " + accessToken) // 使用Bearer Token进行认证
                .GET() // GET请求
                .build();

        // 发送请求并获取响应
        HttpResponse<String> response = httpClient.send(request, HttpResponse.BodyHandlers.ofString());

        // 检查响应状态码
        if (response.statusCode() != 200) {
            System.err.println("Error fetching order details: " + response.statusCode() + " - " + response.body());
            throw new IOException("Failed to get order details: " + response.body());
        }

        // 解析响应体为DTO对象
        String content = response.body();
        return objectMapper.readValue(content, PayPalOrderResponseDTO.class);
    }

    // 占位符方法，实际应用中需要实现获取AccessToken的逻辑
    private String getPayPalAccessToken() {
        // 实际应用中，这里应调用PayPal OAuth2.0 API获取Access Token
        // 例如，通过发送POST请求到 /v1/oauth2/token
        return "YOUR_PAYPAL_ACCESS_TOKEN"; // 请替换为实际获取到的Access Token
    }
}

import com.fasterxml.jackson.annotation.JsonProperty;
import java.util.List;

// 简化版DTO，只包含获取Payer信息所需的核心字段
public record PayPalOrderResponseDTO(
    String id,
    @JsonProperty("create_time")
    String creationTime,
    @JsonProperty("update_time")
    String updateTime,
    String status,
    @JsonProperty("payer")
    PayPalPayer payPalPayer // 包含付款人详情的对象
) {
    // 内部类或嵌套记录来表示Payer信息
    public record PayPalPayer(
        @JsonProperty("email_address")
        String emailAddress,
        PayPalPayerName name,
        PayPalPhone phone,
        @JsonProperty("birth_date")
        String birthDate
    ) {}

    public record PayPalPayerName(
        @JsonProperty("given_name")
        String givenName,
        String surname
    ) {}

    public record PayPalPhone(
        @JsonProperty("phone_type")
        String phoneType,
        @JsonProperty("phone_number")
        String phoneNumber
    ) {}
}

{
  "id": "89012345678901234",
  "create_time": "2023-10-26T10:00:00Z",
  "update_time": "2023-10-26T10:05:00Z",
  "status": "COMPLETED",
  "payer": {
    "email_address": "customer.example@example.com",
    "name": {
      "given_name": "John",
      "surname": "Doe"
    },
    "phone": {
      "phone_type": "MOBILE",
      "phone_number": "1234567890"
    },
    "birth_date": "1990-01-01"
  },
  "purchase_units": [
    // ... 其他交易单元信息
  ]
  // ... 其他订单详情
}