PayPal Integration

Pro v1.0.0

Integrate with PayPal REST API to manage orders, process payments, search transactions, and handle payouts

Requires Claude Code CLI

This skill integrates with PayPal through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

Create Order

Create a new PayPal order for a specific amount and currency

Parameters

Name	Type	Required	Description
amount	string	Required	Order amount (e.g., '50.00')
currency	string	Optional	Currency code (default: USD)

Returns

object Order object with ID, status, and approval links

Try saying...

"Create a PayPal order for $50"
"Create a 25 EUR PayPal order"
"Make a new PayPal order for $100 USD"

Get Order

Retrieve details for a specific order by ID

Parameters

Name	Type	Required	Description
order_id	string	Required	PayPal order ID

Returns

object Order details including status, amount, and payer information

Try saying...

"Get PayPal order 5O190127TN364715T"
"Show me details for order 5O190127TN364715T"
"Retrieve PayPal order information for 5O190127TN364715T"

Capture Order

Capture payment for an approved order

Parameters

Name	Type	Required	Description
order_id	string	Required	PayPal order ID to capture

Returns

object Capture result with transaction details

Try saying...

"Capture payment for order 5O190127TN364715T"
"Complete PayPal order 5O190127TN364715T"
"Process payment for order 5O190127TN364715T"

Search Transactions

Search for transactions within a date range

Parameters

Name	Type	Required	Description
start_date	string	Required	Start date in YYYY-MM-DD format
end_date	string	Optional	End date in YYYY-MM-DD format (defaults to today)

Returns

object List of transactions matching the criteria

Try saying...

"Search PayPal transactions from January 1 to January 15, 2026"
"Find transactions since 2026-01-01"
"Show me PayPal transactions for the last week"

Get Transaction

Retrieve details for a specific transaction

Parameters

Name	Type	Required	Description
transaction_id	string	Required	PayPal transaction/capture ID

Returns

object Transaction details including amount, status, and timestamps

Try saying...

"Get PayPal transaction 8MC585209K746392H"
"Show transaction details for 8MC585209K746392H"
"Retrieve information about transaction 8MC585209K746392H"

Getting Started

OAuth 2.0 Easy Setup

1 Log in to PayPal Developer Dashboard at https://developer.paypal.com/dashboard/
2 Click on Apps & Credentials
3 Toggle to Sandbox (testing) or Live (production) mode
4 Click Create App or select an existing app
5 Copy your Client ID and Secret (click Show to reveal)
6 Add to shell config: echo 'export PAYPAL_CLIENT_ID="YOUR_ID"' >> ~/.zshrc
7 Add secret: echo 'export PAYPAL_CLIENT_SECRET="YOUR_SECRET"' >> ~/.zshrc
8 Set environment: echo 'export PAYPAL_ENVIRONMENT="sandbox"' >> ~/.zshrc
9 Restart terminal or run: source ~/.zshrc

View full setup guide

Security & Access

Access Scope

Full access to create orders, process payments, issue refunds, send payouts, and view transaction history on the associated PayPal account

These credentials can perform real financial transactions if used in production mode
Never commit credentials to version control or share them publicly
Use sandbox mode for all testing - it uses test money, not real funds
Monitor your PayPal account regularly for unauthorized activity
Rotate credentials periodically and when team members change
Different applications should use different API credentials when possible

Limitations

Vault API for payment method tokens is US-only
Transaction search limited to last 3 years
Sandbox environment uses test data only - no real money
Some features require additional approval or business verification

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type: PYTHON_SDK
Auth: OAuth 2.0
Setup: Easy Setup
Tools Required: Bash
Python Dependencies: paypal-server-sdk>=0.5.1

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements