本文旨在解决通过PayPal PayerID直接获取交易详情的常见困惑。我们将阐明PayerID的局限性，并详细介绍如何利用PayPal的订单详情API（v2/checkout/orders/{id}）结合订单ID来获取包括客户邮箱在内的完整交易及付款人信息，并提供Java示例代码及关键注意事项。
在paypal集成中，开发者常会遇到一个场景：在交易完成后，回调url中仅包含一个payerid。此时，若需要获取更详细的交易信息，例如客户的电子邮件地址、姓名或其他交易详情，直接通过payerid查询是不可行的。理解payerid与实际交易标识符的区别是解决此问题的关键。
理解PayPal PayerID与交易标识符
PayerID是PayPal系统中用于唯一标识一个付款人的ID。一个付款人可以进行多笔交易，因此PayerID本身并不能唯一地标识某一笔特定的交易。每笔PayPal交易都有其独特的标识符，通常是payment_id（针对较旧的Payment API）或order_id（针对较新的Checkout Orders API）。当PayPal回调仅提供PayerID时，通常意味着你的系统需要在交易流程的早期阶段（例如创建订单时）捕获并存储order_id或payment_id，以便后续查询。
因此，如果你的系统仅收到了PayerID，你需要回顾你的PayPal集成流程，确保在创建或批准订单时，已经获取并保存了对应的order_id。如果order_id在回调中缺失，你需要调整你的集成逻辑，使其在用户完成支付前或支付后立即获取到该ID。
核心策略：利用PayPal订单详情API
获取完整交易详情和付款人信息的正确方法是使用PayPal的“订单详情API”（Orders API）。该API允许你通过一个订单的order_id来检索其所有相关信息，包括付款人（Payer）的详细资料。
API端点：/v2/checkout/orders/{id}
这里的{id}即代表你的order_id。
API调用实现示例（以Java为例）
以下我们将通过Java代码示例，演示如何调用PayPal的订单详情API来获取所需信息。请注意，虽然示例使用Java，但核心概念和API调用逻辑适用于任何编程语言。
1. 获取访问令牌 (Access Token)
在调用任何PayPal REST API之前，你都需要一个有效的访问令牌。这通常通过调用PayPal的OAuth 2.0 API来获取，使用你的客户端ID和密钥进行认证。
// 假设你有一个方法来获取PayPal的OAuth访问令牌public String getPayPalAccessToken() { // 实际应用中，这里应调用PayPal OAuth2.0 API获取Access Token。 // 通常涉及发送POST请求到 /v1/oauth2/token 端点， // 使用你的客户端ID和密钥进行Basic Auth认证。 // 返回响应中的access_token字段。 return "YOUR_PAYPAL_ACCESS_TOKEN"; // 请替换为实际获取到的Access Token}
2. 构建API请求
使用获取到的访问令牌和order_id来构建对订单详情API的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 PayPalOrderService { 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_ENDPOINT = "/v2/checkout/orders/{id}"; /** * 根据订单ID获取PayPal订单详情 * @param orderId PayPal订单ID * @return 包含订单详情的DTO对象 * @throws IOException 如果网络或数据解析失败 * @throws InterruptedException 如果请求被中断 */ public PayPalOrderResponseDTO getOrderDetails(String orderId) throws IOException, InterruptedException { String accessToken = getPayPalAccessToken(); // 获取访问令牌 // 构建请求URL String requestUrl = BASE_URL + ORDER_DETAILS_ENDPOINT.replace("{id}", orderId); // 构建HTTP请求 HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(requestUrl)) .header("Authorization", "Bearer " + accessToken) // 使用Bearer Token进行认证 .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()); } // 解析响应体为DTO对象 String content = response.body(); return objectMapper.readValue(content, PayPalOrderResponseDTO.class); } // 占位符方法，实际应用中需要实现获取AccessToken的逻辑 private String getPayPalAccessToken() { // 实际应用中，这里应调用PayPal OAuth2.0 API获取Access Token // 例如，通过发送POST请求到 /v1/oauth2/token return "YOUR_PAYPAL_ACCESS_TOKEN"; // 请替换为实际获取到的Access Token }}
3. 定义数据传输对象 (DTO)
为了方便地处理API响应，建议定义一个数据传输对象（DTO）来映射PayPal的JSON响应结构。以下是一个简化的PayPalOrderResponseDTO示例，重点展示如何获取付款人信息。
import com.fasterxml.jackson.annotation.JsonProperty;import java.util.List;// 简化版DTO，只包含获取Payer信息所需的核心字段public record PayPalOrderResponseDTO( String id, @JsonProperty("create_time") String creationTime, @JsonProperty("update_time") String updateTime, String status, @JsonProperty("payer") PayPalPayer payPalPayer // 包含付款人详情的对象) { // 内部类或嵌套记录来表示Payer信息 public record PayPalPayer( @JsonProperty("email_address") String emailAddress, PayPalPayerName name, PayPalPhone phone, @JsonProperty("birth_date") String birthDate ) {} public record PayPalPayerName( @JsonProperty("given_name") String givenName, String surname ) {} public record PayPalPhone( @JsonProperty("phone_type") String phoneType, @JsonProperty("phone_number") String phoneNumber ) {}}
解析订单详情数据：获取Payer信息
成功调用API并解析响应后，你将得到一个PayPalOrderResponseDTO对象。在这个对象中，最关键的是payPalPayer字段，它包含了付款人的详细信息。
以下是payer对象中可能包含的关键信息示例（JSON格式）：
{ "id": "89012345678901234", "create_time": "2023-10-26T10:00:00Z", "update_time": "2023-10-26T10:05:00Z", "status": "COMPLETED", "payer": { "email_address": "customer.example@example.com", "name": { "given_name": "John", "surname": "Doe" }, "phone": { "phone_type": "MOBILE", "phone_number": "1234567890" }, "birth_date": "1990-01-01" }, "purchase_units": [ // ... 其他交易单元信息 ] // ... 其他订单详情}
通过访问payPalOrderResponseDTO.payPalPayer().emailAddress()，你就可以轻松获取到客户的电子邮件地址。同样，姓名、电话等信息也可以通过相应字段获取。
注意事项
**`order_id
以上就是PayPal PayerID与订单详情获取指南：通过订单ID检索完整交易数据的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1273484.html
微信扫一扫 
支付宝扫一扫 
