Paypal

🚀 PayPal代理與Claude桌面集成指南

本指南詳細介紹了PayPal代理的安裝配置、Claude桌面集成的操作步驟，以及訪問令牌管理和相關安全注意事項，幫助你順利實現PayPal相關功能的集成與使用。

🚀 快速開始

PayPal代理快速入門

1. 創建與註冊應用：訪問PayPal開發者控制檯，點擊創建新應用並填寫必要信息。
2. 獲取API密鑰：進入所選或新建的應用詳情頁，找到並記錄下：
   • Client ID：應用的公開標識符
   • Client Secret：應用的私有密鑰（點擊“顯示”以查看）

Claude桌面集成快速入門

1. 環境變量配置：更新Claude Desktop的環境變量以支持PayPal集成。
2. 連接器配置：在Claude Desktop中添加或編輯特定的連接器配置。
3. 功能測試：通過向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"}'

🔧 技術細節

訪問令牌管理

獲取步驟

1. 創建應用：在PayPal開發者控制檯創建新應用。
2. 獲取憑證：進入應用詳情頁，點擊“顯示”以獲取Client Secret。
3. 調用API：使用cURL或Postman發送請求以換取訪問令牌。

刷新策略

• 刷新間隔：建議設置為令牌過期前15分鐘進行刷新。
• 自動重試：集成冪等操作，防止重複請求導致的錯誤。

⚠️ 注意事項

• 權限管理：確保API調用具備必要的權限（如payments.read）。
• 日誌記錄：詳細記錄所有API請求與響應，便於排查問題。
• 性能優化：合理控制併發請求量，避免觸發PayPal的速率限制。

🔒 安全提示

• 加密傳輸：確保所有敏感信息通過HTTPS傳輸。
• 最小權限原則：僅授予必要的API訪問權限。
• 定期審計：定期審查和更新API密鑰及令牌策略。