在paypal交易流程中，有时回调url或某些场景下仅提供payerid。然而，payerid主要用于标识一个付款人，它本身并非一个唯一的交易标识符，因此paypal并没有直接通过payerid获取特定交易所有详细信息的api。要获取包括客户电子邮件地址、姓名及其他交易详情在内的完整数据，我们需要依赖于交易的唯一标识符，即order_id（订单id）或payment_id（支付id），并通过paypal的订单详情api进行查询。
当您在回调URL中只收到PayerID时，这通常意味着支付授权已完成，但您需要使用之前在支付发起阶段获得的order_id来查询该笔授权对应的订单详情。
PayPal的订单详情API是获取交易完整信息的官方途径。该API允许您通过order_id检索特定订单的所有相关数据，包括付款人信息、购买单位详情、交易状态等。
所有PayPal API请求都需要进行认证。通常，这意味着您需要获取一个有效的Bearer Access Token。这个Token通过OAuth 2.0流程从PayPal的认证服务获取，并需要在每个API请求的Authorization头中传递。
// 假设您已有一个获取Access Token的方法
public String getAccessToken() {
// 实现获取PayPal Access Token的逻辑
// 通常涉及向PayPal /v1/oauth2/token 端点发送POST请求
// 使用您的Client ID和Secret进行基本认证
return "YOUR_PAYPAL_ACCESS_TOKEN"; // 示例
}获取订单详情的API端点是：/v2/checkout/orders/{id}。您需要将{id}替换为实际的order_id。
以下是一个使用Java HttpClient发送GET请求获取订单详情的示例：
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的定义将在下一节给出
}PayPal订单详情API的响应是一个包含丰富数据的JSON对象。其中，付款人信息位于payer字段下。
响应DTO结构示例 (Java Record 类型):
// 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的完整定义，但实际应用中应完整映射)通过上述PayPalOrderResponseDTO，您可以轻松访问payPalPayer字段，进而获取emailAddress、givenName、surname、payerId等付款人详细信息。
示例：提取付款人信息
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());
// 适当的错误处理
}
}当PayPal仅返回PayerID而您需要完整的交易和付款人详情时，正确的做法是利用您在支付流程初期获得的order_id（或payment_id），调用PayPal的订单详情API（/v2/checkout/orders/{id}）。通过此API，您可以获取一个包含所有必要信息的JSON响应，其中包括付款人的电子邮件地址、姓名等。遵循本文提供的指导和示例，您可以有效地集成PayPal API，并安全、准确地获取所需的交易数据。
以上就是通过PayPal订单详情API获取Payer信息与交易详情的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
834
收藏
