PayPal的PayerID主要用于标识付款人并确认授权，但无法直接用于获取完整的交易详情和付款人信息。要获取这些详细数据，您需要利用PayPal的订单详情API（/v2/checkout/orders/{id}），并传入在创建订单时获得的order_id。通过此API响应，您可以解析出包括付款人邮箱、姓名等在内的所有相关信息。
理解PayerID与OrderID的区别
在PayPal的支付流程中，您可能会遇到两种重要的标识符：PayerID和OrderID（或PaymentID）。理解它们的区别对于正确获取交易详情至关重要。
PayerID (付款人ID)：这个ID主要在用户授权支付时返回，例如在PayPal将用户重定向回您的网站的return_url中。它标识了同意进行支付的特定PayPal账户。然而，PayerID本身并不包含具体的交易详情，因为它仅仅是付款人的一个标识符，一个付款人可以进行多笔交易。因此，无法通过PayerID直接查询到某一笔特定交易的所有细节。OrderID (订单ID)：OrderID是您在通过PayPal API（例如/v2/checkout/orders）创建一笔订单时由PayPal生成的唯一标识符。它是特定交易的核心标识，包含了该笔交易的所有信息，包括商品详情、金额、支付状态以及付款人的详细信息。
关键流程： 当您在前端收到包含PayerID的重定向时，您需要结合您在后端创建订单时存储的OrderID来查询交易详情。PayerID通常用于后续的支付执行或捕获操作，以确认用户授权。
使用PayPal订单详情API获取数据
要获取完整的交易详情和付款人信息，您需要调用PayPal的“获取订单详情”API。
API 端点：GET /v2/checkout/orders/{id}
其中{id}是您在创建订单时获得的order_id。
1. 获取访问令牌 (Access Token)
所有PayPal API调用都需要一个有效的OAuth 2.0访问令牌。您需要使用您的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"; // 替换为实际获取到的令牌}
2. 构建API请求
使用获取到的order_id和访问令牌来构建HTTP 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解析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 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"; }}
3. 定义响应数据传输对象 (DTO)
为了方便地处理JSON响应，您可以定义一个Java Record（或POJO类）来映射PayPal API的响应结构。
import com.fasterxml.jackson.annotation.JsonProperty;import java.util.List;// 主订单响应DTOpublic record PayPalOrderResponseDTO( @JsonProperty("create_time") String creationTime, @JsonProperty("update_time") String updateTime, String id, @JsonProperty("processing_instruction") PayPalProcessingInstruction processingInstruction, @JsonProperty("purchase_units") List payPalPurchaseUnits, List links, @JsonProperty("payment_source") PayPalPaymentSource paymentSource, PayPalOrderIntents intent, @JsonProperty("payer") PayPalPayer payPalPayer, // 付款人信息在这里 PayPalOrderStatus status) {}// 付款人信息DTOpublic record PayPalPayer( @JsonProperty("email_address") String emailAddress, PayPalPayerName name, PayPalPhone phone, @JsonProperty("birth_date") String birthDate, @JsonProperty("payer_id") String payerId // PayerID也包含在订单详情中) {}// 付款人姓名DTOpublic record PayPalPayerName( @JsonProperty("given_name") String givenName, String surname) {}// 付款人电话DTOpublic 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}
4. 提取付款人信息
一旦您成功解析了PayPalOrderResponseDTO对象，就可以从中提取付款人信息。
// 假设您已经获取到 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.");}
注意事项与最佳实践
错误处理： 在实际应用中，务必对API响应进行全面的错误检查。例如，检查HTTP状态码、解析错误信息等。安全性： 妥善保管您的PayPal API凭据（客户端ID和密钥）和访问令牌。不要在客户端代码中暴露它们。环境区分： PayPal提供沙箱（Sandbox）和生产（Live）环境。确保您的代码在不同环境下使用正确的API基础URL和凭据。幂等性： 对于创建或修改资源的API调用，考虑实现幂等性以避免重复操作。Webhook/IPN： 对于更健壮的交易状态管理，建议结合使用PayPal的Webhooks（或旧版IPN）。Webhooks可以实时通知您的系统关于交易状态的更新，而无需您主动查询。数据隐私： 在处理和存储付款人敏感信息时，请务必遵守相关的数据隐私法规（如GDPR、CCPA）。API版本： PayPal API会不断更新。请确保您使用的API版本与您的代码和预期功能兼容。本文示例基于v2版本。
总结
尽管PayPal在某些场景下会返回PayerID，但它并非用于直接查询完整的交易和付款人详情。正确的做法是，在您的系统创建PayPal订单时，存储由PayPal返回的order_id。随后，当您需要获取交易或付款人详细信息时，使用这个order_id通过PayPal的“获取订单详情”API (/v2/checkout/orders/{id}) 进行查询。通过这种方式，您可以获取到包括付款人邮箱、姓名、电话等在内的所有相关数据，从而实现完整的交易管理和客户信息追踪。
以上就是PayPal交易详情获取：通过订单ID检索完整付款人及交易数据的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1273508.html
微信扫一扫 
支付宝扫一扫 
