PayPal

🔑 BYO Key — Payments

Accept payments via PayPal. Supports one-time payments, Pay Later, Venmo, and 10+ local payment methods. Customers can pay with their PayPal account or credit/debit card.

🔑 Setup Required — Bring Your Own Key This integration requires API credentials. Store them once via setup_integration or the Dashboard Vault — they're encrypted with AES-256-GCM and never exposed.

Required Credentials

paypal_client_id

Client ID

Find your Client ID at developer.paypal.com → Dashboard → My Apps & Credentials. Use Sandbox credentials for testing.

paypal_client_secret

Client Secret

Find your Client Secret under the same app. Click "Show" to reveal it.

Get your API key at developer.paypal.com →

Endpoints (4)

POST create-order

Create a PayPal order. Returns an approval URL to redirect the customer to. After approval, call capture-order to finalize payment.

Field	Type	Required	Description
`intent`	string	No	"CAPTURE" (default, immediate payment) or "AUTHORIZE" (capture later)
`currency_code`	string	No	ISO 4217 currency code (default: EUR)
`amount`	string	✓ Yes	Total amount as string, e.g. "29.99"
`description`	string	No	Order description shown to customer
`return_url`	url	✓ Yes	URL to redirect customer to after payment approval
`cancel_url`	url	✓ Yes	URL to redirect customer to if they cancel
`items`	array	No	Array of line items: [{name, quantity, unit_amount, currency_code}]

POST capture-order

Capture payment for an approved order. Call this after the customer returns from PayPal. Returns payment details including transaction ID.

Field	Type	Required	Description
`order_id`	string	✓ Yes	PayPal Order ID returned from create-order

GET get-order

Get order details and payment status.

Field	Type	Required	Description
`order_id`	string	✓ Yes	PayPal Order ID

POST create-refund

Refund a captured payment. Provide the capture_id from the capture-order response.

Field	Type	Required	Description
`capture_id`	string	✓ Yes	Capture ID from capture-order response
`amount`	string	No	Partial refund amount as string (omit for full refund)
`currency_code`	string	No	Currency for partial refund (required if amount set)
`note_to_payer`	string	No	Message shown to the customer about the refund

MCP Tool Names

When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:

Endpoint	MCP Tool Name
create-order	`paypal_create_order`
capture-order	`paypal_capture_order`
get-order	`paypal_get_order`
create-refund	`paypal_create_refund`

← Back to all integrations