一、PayPal代理指南

1.1 安装与配置

请参考以下步骤安装和配置PayPal代理：

# 下载并解压PayPal代理
wget https://github.com/paypal/agent/releases/download/v2.0.0/paypal-agent-2.0.0-linux-x64.tar.gz
tar -xzvf paypal-agent-2.0.0-linux-x64.tar.gz

# 配置环境变量
export PATH=$PATH:/path/to/unzip/folder

1.2 快速入门

1.2.1 创建与注册应用

访问PayPal开发者控制台，点击创建新应用并填写必要信息。

1.2.2 获取API密钥

进入所选或新建的应用详情页，找到并记录下：

• Client ID: 应用的公开标识符
• Client Secret: 应用的私有密钥（点击“显示”以查看）

1.3 高级功能

1.3.1 OAuth 2.0认证

1.3.1.1 获取访问令牌

使用以下cURL命令获取PayPal API的访问令牌：

curl -v https://api-m.sandbox.paypal.com/v1/oauth2/token \
-H "Accept: application/json" \
-H "Accept-Language: en_US" \
-u "CLIENT_ID:CLIENT_SECRET" \
-d "grant_type=client_credentials"

将CLIENT_ID和CLIENT_SECRET替换为您的实际凭证。生产环境请使用https://api-m.paypal.com。

1.3.1.2 刷新访问令牌

当访问令牌即将过期时，使用相同的cURL命令刷新令牌，无需更改任何参数。

1.3.2 Webhooks集成

注册并配置Webhooks以接收PayPal的实时通知：

curl -v -X POST https://api-m.sandbox.paypal.com/v1/notifications/webhooks \
-H "Content-Type: application/json" \
-u "CLIENT_ID:CLIENT_SECRET" \
-d '{"webhook_url":"https://your-server.example.com/paypal-webhook"}'

1.4 最佳实践

• 安全存储：妥善保管Client ID和Client Secret，避免泄露。
• 环境隔离：在开发环境中使用Sandbox，在生产环境中使用Production模式。
• 错误处理：集成完善的错误捕捉与重试机制，确保API调用的可靠性。

二、Claude桌面集成指南

2.1 环境变量配置

更新Claude Desktop的环境变量以支持PayPal集成：

export PAYPAL_ACCESS_TOKEN="YOUR_PAYPAL_ACCESS_TOKEN"
export PAYPAL_ENVIRONMENT="SANDBOX"  # 或 PRODUCTION

2.2 连接器配置

在Claude Desktop中添加或编辑以下连接器配置：

{
  "env": {
    "PAYPAL_ACCESS_TOKEN": "YOUR_NEW_ACCESS_TOKEN",
    "PAYPAL_ENVIRONMENT": "SANDBOX"
  }
}

2.3 功能测试

通过向Claude提出任务，如“列出我的PayPal发票”，验证集成是否成功。

三、访问令牌管理

3.1 获取步骤

1. 创建应用：在PayPal开发者控制台创建新应用。
2. 获取凭证：进入应用详情页，点击“显示”以获取Client Secret。
3. 调用API：使用cURL或Postman发送请求以换取访问令牌。

3.2 刷新策略

• 刷新间隔：建议设置为令牌过期前15分钟进行刷新。
• 自动重试：集成幂等操作，防止重复请求导致的错误。

四、注意事项

• 权限管理：确保API调用具备必要的权限（如payments.read）。
• 日志记录：详细记录所有API请求与响应，便于排查问题。
• 性能优化：合理控制并发请求量，避免触发PayPal的速率限制。

五、安全提示

• 加密传输：确保所有敏感信息通过HTTPS传输。
• 最小权限原则：仅授予必要的API访问权限。
• 定期审计：定期审查和更新API密钥及令牌策略。

以上为完整翻译内容，涵盖PayPal代理安装配置、Claude桌面集成、访问令牌管理及安全注意事项等核心知识点。