Paypal

🚀 PayPal Agent and Claude Desktop Integration Guide

This guide provides comprehensive instructions on installing and configuring the PayPal agent, integrating it with Claude Desktop, managing access tokens, and ensuring security.

🚀 Quick Start

PayPal Agent Installation and Configuration

Follow these steps to install and configure the PayPal agent:

# Download and extract the PayPal agent
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

# Configure environment variables
export PATH=$PATH:/path/to/unzip/folder

Create and Register an Application

Visit the PayPal Developer Dashboard and click Create a new app to fill in the required information.

Obtain API Keys

Go to the details page of the selected or newly created app, and find and record the following:

• Client ID: The public identifier of the app.
• Client Secret: The private key of the app (click "Show" to view).

📦 Installation

PayPal Agent

# Download and extract the PayPal agent
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

# Configure environment variables
export PATH=$PATH:/path/to/unzip/folder

Claude Desktop Integration

Environment Variable Configuration

Update the environment variables of Claude Desktop to support PayPal integration:

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

Connector Configuration

Add or edit the following connector configuration in Claude Desktop:

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

💻 Usage Examples

Basic Usage - PayPal Agent

Create and Register an Application

Visit the PayPal Developer Dashboard and click Create a new app to fill in the required information.

Obtain API Keys

Go to the details page of the selected or newly created app, and find and record the following:

• Client ID: The public identifier of the app.
• Client Secret: The private key of the app (click "Show" to view).

Advanced Usage - PayPal Agent

OAuth 2.0 Authentication

Obtain an Access Token

Use the following cURL command to obtain an access token for the 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"

Replace CLIENT_ID and CLIENT_SECRET with your actual credentials. Use https://api-m.paypal.com for the production environment.

Refresh an Access Token

When the access token is about to expire, use the same cURL command to refresh the token without changing any parameters.

Webhooks Integration

Register and configure Webhooks to receive real-time notifications from 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"}'

Claude Desktop Integration

Function Testing

Verify the integration by asking Claude to perform a task, such as "List my PayPal invoices".

📚 Documentation

Access Token Management

Obtaining Steps

1. Create an App: Create a new app in the PayPal Developer Dashboard.
2. Get Credentials: Go to the app details page and click "Show" to get the Client Secret.
3. Call the API: Use cURL or Postman to send a request to exchange for an access token.

Refresh Strategy

• Refresh Interval: It is recommended to set the refresh interval to 15 minutes before the token expires.
• Automatic Retry: Integrate idempotent operations to prevent errors caused by duplicate requests.

🔧 Technical Details

Best Practices

• Secure Storage: Keep the Client ID and Client Secret safe to avoid leakage.
• Environment Isolation: Use the Sandbox in the development environment and the Production mode in the production environment.
• Error Handling: Integrate a comprehensive error capture and retry mechanism to ensure the reliability of API calls.

Notes

• Permission Management: Ensure that the API calls have the necessary permissions (e.g., payments.read).
• Logging: Record all API requests and responses in detail for easy troubleshooting.
• Performance Optimization: Reasonably control the concurrent request volume to avoid triggering PayPal's rate limit.

Security Tips

• Encrypted Transmission: Ensure that all sensitive information is transmitted via HTTPS.
• Principle of Least Privilege: Only grant the necessary API access permissions.
• Regular Auditing: Regularly review and update the API keys and token policies.

📄 License

No license information provided in the original document.