通过PayPal订单详情API获取Payer信息与交易详情

// 假设您已有一个获取Access Token的方法
public String getAccessToken() {
    // 实现获取PayPal Access Token的逻辑
    // 通常涉及向PayPal /v1/oauth2/token 端点发送POST请求
    // 使用您的Client ID和Secret进行基本认证
    return "YOUR_PAYPAL_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解析
import com.fasterxml.jackson.annotation.JsonProperty;
import java.util.List;

public class PayPalService {

    private final HttpClient httpClient;
    private final ObjectMapper objectMapper;
    private static final String BASE_URL = "https://api-m.paypal.com"; // 或沙箱环境 "https://api-m.sandbox.paypal.com"
    private static final String ORDER_DETAILS_PATH = "/v2/checkout/orders/{id}";

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

    /**
     * 获取PayPal订单的详细信息。
     * @param orderId PayPal订单的唯一ID。
     * @return 包含订单详情的DTO对象。
     * @throws IOException 如果发生I/O错误。
     * @throws InterruptedException 如果线程在等待时被中断。
     */
    public PayPalOrderResponseDTO getOrderDetails(String orderId) throws IOException, InterruptedException {
        String accessToken = getAccessToken(); // 获取Access Token

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

        // 创建HTTP请求
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(requestUrl))
                .header("Authorization", "Bearer " + accessToken)
                .GET()
                .build();

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

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

        // 解析JSON响应到DTO对象
        return objectMapper.readValue(response.body(), PayPalOrderResponseDTO.class);
    }

    // 假设的getAccessToken方法，需要您根据实际认证流程实现
    private String getAccessToken() {
        // 在实际应用中，这里会调用PayPal的OAuth2 /v1/oauth2/token 端点获取
        // 为简化示例，此处返回一个占位符
        return "YOUR_PAYPAL_ACCESS_TOKEN";
    }

    // ... PayPalOrderResponseDTO 及相关嵌套DTO的定义将在下一节给出
}

// PayPalOrderResponseDTO.java
public record PayPalOrderResponseDTO(
    @JsonProperty("create_time") String creationTime,
    @JsonProperty("update_time") String updateTime,
    String id,
    @JsonProperty("purchase_units") List<PayPalPurchaseUnit> payPalPurchaseUnits,
    List<PayPalLink> links,
    @JsonProperty("payment_source") PayPalPaymentSource paymentSource,
    PayPalOrderIntent intent,
    @JsonProperty("payer") PayPalPayer payPalPayer, // 付款人信息
    PayPalOrderStatus status
) {}

// PayPalPayer.java
public record PayPalPayer(
    @JsonProperty("email_address") String emailAddress,
    @JsonProperty("payer_id") String payerId, // 注意：这里会返回Payer ID
    PayPalName name,
    PayPalPhone phone,
    @JsonProperty("birth_date") String birthDate,
    PayPalAddress address
) {}

// PayPalName.java
public record PayPalName(
    @JsonProperty("given_name") String givenName,
    String surname
) {}

// 其他辅助DTO，根据实际需要定义
// PayPalPurchaseUnit.java
public record PayPalPurchaseUnit(
    String referenceId,
    @JsonProperty("shipping") PayPalShipping shipping,
    @JsonProperty("payments") PayPalPayments payments
) {}

// PayPalShipping.java
public record PayPalShipping(
    @JsonProperty("name") PayPalName name,
    @JsonProperty("address") PayPalAddress address
) {}

// PayPalAddress.java
public record PayPalAddress(
    @JsonProperty("address_line_1") String addressLine1,
    @JsonProperty("admin_area_2") String adminArea2,
    @JsonProperty("admin_area_1") String adminArea1,
    @JsonProperty("postal_code") String postalCode,
    @JsonProperty("country_code") String countryCode
) {}

// PayPalPayments.java (可能包含授权或捕获信息)
public record PayPalPayments(
    List<PayPalAuthorization> authorizations,
    List<PayPalCapture> captures
) {}

// PayPalAuthorization.java / PayPalCapture.java 等根据实际响应结构定义
// ... (为简洁起见，此处省略了所有嵌套DTO的完整定义，但实际应用中应完整映射)

public void processOrderDetails(String orderId) {
    try {
        PayPalOrderResponseDTO orderDetails = getOrderDetails(orderId);

        // 获取付款人信息
        PayPalPayer payer = orderDetails.payPalPayer();
        if (payer != null) {
            System.out.println("Payer Email: " + payer.emailAddress());
            if (payer.name() != null) {
                System.out.println("Payer Name: " + payer.name().givenName() + " " + payer.name().surname());
            }
            System.out.println("Payer ID (from order details): " + payer.payerId());
            // 更多付款人信息，如地址、电话等
        }

        // 获取其他交易详情
        System.out.println("Order ID: " + orderDetails.id());
        System.out.println("Order Status: " + orderDetails.status());
        // 遍历 purchase_units 获取商品或金额详情
        if (orderDetails.payPalPurchaseUnits() != null && !orderDetails.payPalPurchaseUnits().isEmpty()) {
            orderDetails.payPalPurchaseUnits().forEach(unit -> {
                // 处理每个购买单位的详情
            });
        }

    } catch (IOException | InterruptedException e) {
        System.err.println("Error processing order: " + e.getMessage());
        // 适当的错误处理
    }
}