PayPal交易详情获取：通过订单ID检索支付人信息与交易数据

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库

public class PayPalApiClient {

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

    public PayPalApiClient() {
        this.httpClient = HttpClient.newHttpClient();
        this.objectMapper = new ObjectMapper();
    }

    /**
     * 获取PayPal订单详情
     * @param orderId 订单ID
     * @param accessToken PayPal访问令牌
     * @return PayPalOrderResponseDTO 包含订单详情的数据传输对象
     * @throws IOException
     * @throws InterruptedException
     */
    public PayPalOrderResponseDTO getOrderDetails(String orderId, String accessToken) 
            throws IOException, InterruptedException {

        // 1. 构建请求URL
        String requestUrl = BASE_URL + ORDER_DETAILS_ENDPOINT + orderId;

        // 2. 构建HTTP请求
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(requestUrl))
                .header("Authorization", "Bearer " + accessToken) // 添加认证头
                .GET() // GET请求
                .build();

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

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

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

    // 假设 getAuthResponse() 方法用于获取 accessTokenDTO，此处省略实现
    // private AccessTokenDTO getAuthResponse() { ... } 
}

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

// 顶级响应对象
public record PayPalOrderResponseDTO(
    String id,
    @JsonProperty("create_time") String creationTime,
    @JsonProperty("update_time") String updateTime,
    PayPalOrderStatus status,
    PayPalOrderIntents intent,
    @JsonProperty("purchase_units") List<PayPalPurchaseUnit> payPalPurchaseUnits,
    @JsonProperty("payer") PayPalPayer payPalPayer, // 支付人信息
    @JsonProperty("payment_source") PayPalPaymentSource paymentSource,
    List<PayPalLinks> links
) {}

// 支付人信息
public record PayPalPayer(
    @JsonProperty("email_address") String emailAddress,
    PayPalPayerName name,
    PayPalPayerPhone phone,
    @JsonProperty("birth_date") String birthDate // 注意：隐私敏感信息，可能需要特定权限
) {}

// 支付人姓名
public record PayPalPayerName(
    @JsonProperty("given_name") String givenName,
    String surname
) {}

// 支付人电话
public record PayPalPayerPhone(
    @JsonProperty("phone_type") String phoneType,
    @JsonProperty("phone_number") String phoneNumber
) {}

// 订单状态枚举 (示例)
public enum PayPalOrderStatus {
    CREATED, SAVED, APPROVED, VOIDED, COMPLETED, PAYER_ACTION_REQUIRED
}

// 订单意图枚举 (示例)
public enum PayPalOrderIntents {
    CAPTURE, AUTHORIZE
}

// 购买单元 (示例)
public record PayPalPurchaseUnit(
    String reference_id,
    @JsonProperty("amount_with_breakdown") PayPalAmountWithBreakdown amountWithBreakdown,
    PayPalPayee payee,
    List<PayPalItem> items
) {}

// 其他辅助DTO，此处省略详细定义，如 PayPalAmountWithBreakdown, PayPalPayee, PayPalItem, PayPalPaymentSource, PayPalLinks

{
  "email_address": "example@example.com",
  "name": {
    "given_name": "John",
    "surname": "Doe"
  },
  "phone": {
    "phone_type": "HOME",
    "phone_number": "1234567890"
  },
  "birth_date": "1990-01-01"
}