PayPal交易详情获取：通过订单ID检索完整付款人及交易数据

// 示例：获取访问令牌的方法 (伪代码)
public String getPayPalAccessToken() throws IOException, InterruptedException {
    // 实际实现会涉及向PayPal的/v1/oauth2/token端点发送POST请求
    // 使用您的客户端ID和密钥进行基本认证，并解析响应获取accessToken
    // 这里仅为示意，具体实现请参考PayPal官方文档
    // var accessTokenDTO = getAuthResponse();
    // return accessTokenDTO.accessToken();
    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解析

public class PayPalService {

    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_PATH = "/v2/checkout/orders/{id}";

    /**
     * 根据订单ID获取PayPal订单详情
     * @param orderId PayPal订单的唯一标识符
     * @return 包含订单详情的DTO对象
     * @throws IOException IO异常
     * @throws InterruptedException 中断异常
     */
    public PayPalOrderResponseDTO getOrderDetails(String orderId) throws IOException, InterruptedException {
        String accessToken = getPayPalAccessToken(); // 获取访问令牌

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

        // 构建HTTP请求
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(requestUrl))
                .header("Authorization", "Bearer " + accessToken) // 设置认证头
                .header("Content-Type", "application/json") // 通常GET请求不需要Content-Type，但加上无妨
                .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());
        }

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

    // 示例：获取访问令牌的方法 (实际项目中应实现OAuth2流程)
    private String getPayPalAccessToken() {
        // 实际应用中，您需要调用PayPal的/v1/oauth2/token端点来获取access token
        // 这里为了示例简化，直接返回一个模拟的令牌
        return "A21AAJ-YOUR-ACTUAL-ACCESS-TOKEN-EXAMPLE";
    }
}

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

// 主订单响应DTO
public record PayPalOrderResponseDTO(
    @JsonProperty("create_time") String creationTime,
    @JsonProperty("update_time") String updateTime,
    String id,
    @JsonProperty("processing_instruction") PayPalProcessingInstruction processingInstruction,
    @JsonProperty("purchase_units") List<PayPalPurchaseUnit> payPalPurchaseUnits,
    List<PayPalLinks> links,
    @JsonProperty("payment_source") PayPalPaymentSource paymentSource,
    PayPalOrderIntents intent,
    @JsonProperty("payer") PayPalPayer payPalPayer, // 付款人信息在这里
    PayPalOrderStatus status
) {}

// 付款人信息DTO
public record PayPalPayer(
    @JsonProperty("email_address") String emailAddress,
    PayPalPayerName name,
    PayPalPhone phone,
    @JsonProperty("birth_date") String birthDate,
    @JsonProperty("payer_id") String payerId // PayerID也包含在订单详情中
) {}

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

// 付款人电话DTO
public record PayPalPhone(
    @JsonProperty("phone_type") String phoneType,
    @JsonProperty("phone_number") String phoneNumber // 注意：这里可能需要根据API文档调整类型
) {}

// 其他辅助DTO（根据实际API响应结构定义，此处仅为示例）
public record PayPalProcessingInstruction(
    // ...
) {}

public record PayPalPurchaseUnit(
    // ...
) {}

public record PayPalLinks(
    // ...
) {}

public record PayPalPaymentSource(
    // ...
) {}

public enum PayPalOrderIntents {
    CAPTURE, AUTHORIZE
}

public enum PayPalOrderStatus {
    CREATED, SAVED, APPROVED, VOIDED, COMPLETED, PAYER_ACTION_REQUIRED
}

// 假设您已经获取到 orderResponseDTO 对象
PayPalPayer payerInfo = orderResponseDTO.payPalPayer();

if (payerInfo != null) {
    String email = payerInfo.emailAddress();
    String givenName = payerInfo.name() != null ? payerInfo.name().givenName() : "N/A";
    String surname = payerInfo.name() != null ? payerInfo.name().surname() : "N/A";
    String fullPayerId = payerInfo.payerId(); // 订单详情中也包含PayerID

    System.out.println("Payer Email: " + email);
    System.out.println("Payer Name: " + givenName + " " + surname);
    System.out.println("Full Payer ID from Order: " + fullPayerId);

    if (payerInfo.phone() != null) {
        System.out.println("Payer Phone: " + payerInfo.phone().phoneNumber());
    }
    if (payerInfo.birthDate() != null) {
        System.out.println("Payer Birth Date: " + payerInfo.birthDate());
    }
} else {
    System.out.println("Payer information not found in order details.");
}