🚀 PayPal代理与Claude桌面集成指南
本指南详细介绍了PayPal代理的安装配置、Claude桌面集成的操作步骤，以及访问令牌管理和相关安全注意事项，帮助你顺利实现PayPal相关功能的集成与使用。
🚀 快速开始
PayPal代理快速入门
- 创建与注册应用：访问PayPal开发者控制台，点击创建新应用并填写必要信息。
- 获取API密钥：进入所选或新建的应用详情页，找到并记录下：
- Client ID：应用的公开标识符
- Client Secret：应用的私有密钥（点击“显示”以查看）
Claude桌面集成快速入门
- 环境变量配置：更新Claude Desktop的环境变量以支持PayPal集成。
- 连接器配置：在Claude Desktop中添加或编辑特定的连接器配置。
- 功能测试：通过向Claude提出任务，如“列出我的PayPal发票”，验证集成是否成功。
📦 安装指南
安装与配置PayPal代理
请参考以下步骤安装和配置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
Claude桌面集成环境变量配置
更新Claude Desktop的环境变量以支持PayPal集成：
export PAYPAL_ACCESS_TOKEN="YOUR_PAYPAL_ACCESS_TOKEN"
export PAYPAL_ENVIRONMENT="SANDBOX" # 或 PRODUCTION
Claude桌面集成连接器配置
在Claude Desktop中添加或编辑以下连接器配置：
{
"env": {
"PAYPAL_ACCESS_TOKEN": "YOUR_NEW_ACCESS_TOKEN",
"PAYPAL_ENVIRONMENT": "SANDBOX"
}
}
💻 使用示例
PayPal代理基础用法
创建与注册应用
访问PayPal开发者控制台，点击创建新应用并填写必要信息。
获取API密钥
进入所选或新建的应用详情页，找到并记录下：
- Client ID：应用的公开标识符
- Client Secret：应用的私有密钥（点击“显示”以查看）
PayPal代理高级用法
OAuth 2.0认证
获取访问令牌
使用以下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。
刷新访问令牌
当访问令牌即将过期时，使用相同的cURL命令刷新令牌，无需更改任何参数。
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"}'
🔧 技术细节
访问令牌管理
获取步骤
- 创建应用：在PayPal开发者控制台创建新应用。
- 获取凭证：进入应用详情页，点击“显示”以获取Client Secret。
- 调用API：使用cURL或Postman发送请求以换取访问令牌。
刷新策略
- 刷新间隔：建议设置为令牌过期前15分钟进行刷新。
- 自动重试：集成幂等操作，防止重复请求导致的错误。
⚠️ 注意事项
- 权限管理：确保API调用具备必要的权限（如
payments.read）。 - 日志记录：详细记录所有API请求与响应，便于排查问题。
- 性能优化：合理控制并发请求量，避免触发PayPal的速率限制。
🔒 安全提示
- 加密传输：确保所有敏感信息通过HTTPS传输。
- 最小权限原则：仅授予必要的API访问权限。
- 定期审计：定期审查和更新API密钥及令牌策略。