针对PayPal返回URL中仅包含PayerID，无法直接获取交易详情的问题，本教程将指导您如何利用PayPal的订单详情API（Order Details API），通过订单ID（或支付ID）来检索完整的交易数据，包括支付人的电子邮件地址、姓名及其他关键信息。文章将提供API调用示例和数据结构解析，助您高效集成PayPal支付。
理解PayerID的局限性
在paypal的支付流程中，当用户完成支付授权并重定向回您的网站时，返回url中通常会包含一个payerid。payerid是一个标识支付人的唯一id，它能够识别执行支付操作的用户账户。然而，需要明确的是，payerid本身并不能直接提供特定交易的详细信息，例如交易金额、商品列表或支付人的电子邮件地址等。这是因为一个支付人（由payerid标识）可能进行了多笔交易，payerid仅指向用户，而非具体的交易实例。要获取某一笔特定交易的完整详情，我们需要依赖更精确的交易标识符，即order_id（订单id）或payment_id（支付id）。
核心解决方案：利用PayPal订单详情API
获取PayPal交易详情及支付人信息的正确方法是使用PayPal的订单详情API（Order Details API）。这个API通过提供一个唯一的order_id（或在某些旧版集成中为payment_id），能够返回该订单的所有相关数据，包括但不限于：
订单创建和更新时间订单状态购买单元（purchase units）详情，如商品、金额支付来源信息最重要的，支付人（payer）的详细信息，包括其电子邮件地址、姓名、电话等。
订单详情API的端点通常是/v2/checkout/orders/{id}，其中{id}即为您的订单ID。
获取订单ID（Order ID）
在调用订单详情API之前，您必须拥有对应的order_id。order_id通常在您首次通过PayPal API创建订单（例如，调用/v2/checkout/orders的POST请求）时，由PayPal在响应中返回。这是一个至关重要的步骤：
创建订单： 当您的应用程序准备发起PayPal支付时，您会向PayPal发送一个请求来创建一个订单。保存订单ID： PayPal响应此创建请求时，会返回一个order_id。您必须将此order_id妥善存储在您的后端系统或会话中。后续查询： 即使PayPal在重定向回您的网站时只提供了PayerID，您也可以通过之前存储的order_id来查询交易详情。在一些情况下，PayPal的返回URL也可能包含一个token参数，该token往往就是order_id，您也可以从中提取。
API调用实现示例（以Java为例）
以下是一个使用Java调用PayPal订单详情API的示例，展示了如何构建HTTP请求、发送请求以及解析响应。虽然示例是Java，但核心逻辑适用于任何支持HTTP请求和JSON解析的编程语言。
1. 认证
所有PayPal API调用都需要一个有效的访问令牌（access_token）。您需要首先通过PayPal的OAuth2 API获取此令牌，通常涉及使用您的客户端ID和密钥进行认证。
2. 构建并发送请求
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 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() { ... } }
3. 定义数据传输对象（DTO）
为了方便地处理API响应，建议定义一个数据传输对象（DTO）来映射JSON结构。以下是一个简化的Java record 示例，展示了关键字段：
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 payPalPurchaseUnits, @JsonProperty("payer") PayPalPayer payPalPayer, // 支付人信息 @JsonProperty("payment_source") PayPalPaymentSource paymentSource, List 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 items) {}// 其他辅助DTO，此处省略详细定义，如 PayPalAmountWithBreakdown, PayPalPayee, PayPalItem, PayPalPaymentSource, PayPalLinks
在PayPalOrderResponseDTO中，最关键的是payPalPayer字段，它包含了支付人的详细信息，例如：
{ "email_address": "example@example.com", "name": { "given_name": "John", "surname": "Doe" }, "phone": { "phone_type": "HOME", "phone_number": "1234567890" }, "birth_date": "1990-01-01"}
通过解析这个payer对象，您就可以获取到所需的客户电子邮件地址、姓名等信息。
注意事项
安全性与权限： 访问支付人敏感信息（如电子邮件、电话、生日）可能需要您的PayPal应用具备相应的权限。请确保您的PayPal应用配置了正确的权限范围。错误处理： API调用可能因网络问题、认证失败、无效订单ID或PayPal服务中断而失败。务必实现健壮的错误处理机制，包括捕获异常、检查HTTP状态码和解析错误响应。环境区分： PayPal提供沙箱（Sandbox）环境用于开发和测试，生产（Live）环境用于实际交易。请确保您的API客户端根据当前环境配置正确的BASE_URL和认证凭据。数据映射： 使用DTO或类似的数据模型来映射API响应可以大大提高代码的可读性、可维护性和类型安全性。这在TypeScript、Python等语言中也有对应的实现方式。PayerID的作用： 尽管PayerID不能直接获取交易详情，但在某些场景下它仍有其用途，例如用于识别回头客、个性化用户体验或与PayPal的某些特定功能集成。
总结
当PayPal在返回URL中只提供PayerID时，获取完整的交易详情和支付人信息的核心策略是利用PayPal的订单详情API，并通过订单ID（order_id）进行查询。order_id是您在创建PayPal订单时从PayPal获得的唯一标识符，您需要在支付流程中妥善保存它。通过构建包含访问令牌的GET请求并解析返回的JSON响应，您可以轻松提取包括支付人电子邮件、姓名在内的所有必要交易数据。遵循本文提供的指南和注意事项，将帮助您高效且安全地集成PayPal支付功能。
以上就是PayPal交易详情获取：通过订单ID检索支付人信息与交易数据的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1294273.html
微信扫一扫 
支付宝扫一扫 
