paypal javasdk支付接口

### PayPal Java SDK支付接口集成指南

由于官方已停止对Java服务端SDK的支持并建议采用REST API来接入支付功能[^1]，因此下面将以基于REST API的方式说明如何在Java应用中实现PayPal支付。

#### 准备工作

为了能够顺利地调用PayPal REST API，在开始编码之前需完成如下准备工作：

- 注册成为PayPal开发者账号，并创建应用程序以获得客户端ID(Client ID) 和 客户端密钥(Secret)[^2]。
- 设置好开发环境，确保安装有JDK以及构建工具如Maven或Gradle用于管理依赖项。

#### 添加依赖库

对于希望简化HTTP请求处理过程的情况，可以选择加入一些流行的开源框架作为辅助。例如Apache HttpClient可以帮助发送HTTPS POST/GET请求给PayPal服务器。如果使用的是Spring Boot，则可以直接利用`spring-boot-starter-web`中的RestTemplate组件来进行网络通信[^3]。

<!-- Maven pom.xml -->
<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.13</version>
</dependency>

<!-- 或者 Spring Boot 的 starter -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

#### 创建OAuth令牌

每次向PayPal发起API请求前都需要先获取有效的OAuth access token。这可以通过POST方法提交认证信息到特定URL(`https://api.sandbox.paypal.com/v1/oauth2/token`) 来完成。成功响应会返回一个JSON对象，其中包含了access_token字段值[^4]。

// 使用HttpClient获取Access Token示例代码
CloseableHttpClient httpClient = HttpClients.createDefault();
HttpPost postRequest = new HttpPost("https://api-m.sandbox.paypal.com/v1/oauth2/token");

postRequest.setHeader(HttpHeaders.AUTHORIZATION, "Basic " + Base64.getEncoder().encodeToString((clientId + ":" + clientSecret).getBytes()));
postRequest.setEntity(new StringEntity("grant_type=client_credentials"));

try (CloseableHttpResponse response = httpClient.execute(postRequest)) {
    // 解析Response...
}

#### 发起支付请求

有了合法的token之后就可以按照文档指引构造相应的body参数并向指定路径发送POST请求了。这里假设要执行一笔简单的付款动作，那么应该指向 `/v2/checkout/orders` 路径上传送必要的交易详情数据结构体。

{
  "intent": "CAPTURE",
  "purchase_units": [
    {
      "amount": {
        "currency_code": "USD",
        "value": "100.00"
      }
    }
  ]
}

最后提醒一点，虽然旧版的服务端SDK还能正常运作一段时间内，但从长远来看还是尽早迁移到最新的RESTful风格API更为明智的选择。