PayPal Integration for AI Agents
Connect your AI agent to 61 QA'd PayPal actions via MCP, A2A, or SDK, with agent authentication, tool-calling execution, and security built-in, plus 51 events to subscribe to.
PayPal AI Agent Actions
61 production-ready actions for your agent to do more on PayPal.
61 Actions
Create Order - Create a new PayPal order for payment processing
Get Order - Show details for an order by ID
Capture Order Payment - Capture payment for an approved order
Authorize Order Payment - Authorize payment for an approved order
Update Order - Update an order with CREATED or APPROVED status
Get Captured Payment - Retrieve details of a captured payment
Refund Captured Payment - Refund a captured payment in full or partially
Get Refund - Retrieve details of a specific refund
Get Authorization - Retrieve details of an authorized payment
Capture Authorized Payment - Capture an authorized payment
Void Authorization - Void an authorized payment
List Invoices - List invoices with optional filtering and pagination
Get Invoice - Retrieve details of a specific invoice by ID
Create Draft Invoice - Create a new draft invoice
Update Invoice - Fully update an existing invoice — use this to change payment terms, line items, recipient, amounts, or any other invoice field. This is a full replacement (PUT), not a partial update.
Delete Invoice - Delete a draft invoice by ID
Send Invoice - Send or schedule a draft invoice to the recipient
Cancel Sent Invoice - Cancel a sent invoice
Record Invoice Payment - Records an external payment (cash, check, bank transfer, etc.) against a sent invoice via POST /v2/invoicing/invoices/{invoice_id}/payments. The invoice must be in SENT, PARTIALLY_PAID, or PAYMENT_PENDING status — DRAFT or CANCELLED invoices return 422 Unprocessable Entity, so use send_invoice first if needed. Returns an EXTR-prefixed payment_id usable with delete_external_payment to reverse the record.
Generate Invoice Number - Generate the next sequential invoice number
Search Invoices - Search for invoices using filters via POST /v2/invoicing/search-invoices. All filter fields go in the request body (not query params except page, page_size, total_required). An empty body (no filters) returns all invoices.
Send Invoice Reminder - Send a reminder to the payer about an invoice. The invoice must have at least one recipient with an email address — invoices without primary_recipients will return 400.
Record Invoice Refund - Records a refund against a paid invoice via POST /v2/invoicing/invoices/{invoice_id}/refunds. If the total refunded amount equals all payments, the invoice status changes to REFUNDED; otherwise it changes to PARTIALLY_REFUNDED.
Delete External Payment - Delete an external payment from an invoice
List Products - List catalog products with pagination
Get Product - Retrieve details of a specific catalog product
Create Product - Create a new catalog product. Only name and type are required; never block on a missing optional value like home_url or image_url.
Update Product - Update a catalog product's description, category, image_url, or home_url fields using JSON Patch with "add" or "remove" operations. Returns 204 No Content on success.
List Subscription Plans - List subscription billing plans with pagination
Get Subscription Plan - Retrieve details of a specific subscription plan
Create Subscription Plan - Create a new subscription billing plan linked to a product, defining pricing, billing cycles, and payment preferences. For simple flat-rate plans use fixed_price, NOT VOLUME pricing. VOLUME and TIERED require 2+ tiers and quantity_supported=true.
Update Plan - Update a billing plan's name, description, payment preferences, or tax settings using JSON Patch. Returns 204 No Content on success.
Activate Plan - Activate a billing plan that was created with status CREATED. Returns 204 No Content on success.
Deactivate Plan - Deactivate an ACTIVE billing plan. No new subscriptions can be created against it. Returns 204 No Content on success.
Get Subscription - Retrieve the full details of a specific PayPal subscription including its status, billing info, subscriber details, and plan configuration
Create Subscription - Create a new PayPal subscription that enrolls a subscriber into a billing plan, returning HATEOAS approval links the subscriber must visit to activate billing
Update Subscription - Update an ACTIVE or SUSPENDED subscription using JSON Patch operations. Returns 204 No Content on success.
Revise Subscription Plan Or Quantity - Revise the plan, quantity, or shipping details of a subscription. Requires buyer re-approval via redirect.
Cancel Subscription - Cancel an active subscription
Suspend Subscription - Suspend an active subscription
Activate Subscription - Activate a suspended subscription
List Subscription Transactions - List transactions for a specific subscription
Create Batch Payout - Create a batch payout to send payments to multiple recipients (max 15,000 items). sender_batch_id must be unique per 30 days even on failed attempts. Default to PAYPAL wallet — VENMO is US-only and unsupported in sandbox.
Get Batch Payout - Retrieve details of a batch payout
Get Payout Item - Retrieve details of a specific payout item
Cancel Unclaimed Payout Item - ONLY works on UNCLAIMED payout items — PENDING items cannot be cancelled (returns 400). Always check transaction_status with get_payout_item first before calling this action.
List Disputes - List disputes with optional filtering by state, date range, or transaction ID. Supports page and page_size (1-50, default 10) for pagination. dispute_state accepts only ONE value per call.
Get Dispute - Retrieve details of a specific dispute
Accept Dispute Claim - Accept a dispute claim and refund the buyer
Send Dispute Message - Send a message about a dispute to the other party
Escalate Dispute To Claim - Escalate a dispute to a PayPal claim
List Transactions - Search for transactions within a date range
List Balances - List account balances by currency
List Webhooks - List all webhooks for the app
Get Webhook - Retrieve full details of a specific webhook by its ID
Create Webhook - Create a new webhook to receive event notifications. WARNING — PayPal sends a live HTTPS request to the URL at creation time and returns 400 if unreachable. Do NOT use example.com, localhost, or placeholder URLs.
Delete Webhook - Delete a webhook by ID
Update Webhook - Update a webhook's URL or event types using JSON Patch. Only the "replace" operation is supported.
List Webhook Event Types - List all available webhook event types
List Webhook Event Notifications - List webhook event notifications with optional filtering by date range, transaction ID, or event type. If filtering by date, start_time and end_time must both be in the past and within a 30-day window (use 29 days to be safe).
Get Webhook Event - Retrieve details of a specific webhook event notification by ID
PayPal Webhook Events
51 real-time PayPal events your AI agent can subscribe to.
51 Events
- Order Approved Fired when a payer approves a checkout order. The order is ready to be captured or authorized.
- Order Completed Fired when a checkout order is completed (all purchase units captured).
- Payment Approval Reversed Fired when a buyer-approved checkout payment approval is reversed.
- Payment Capture Completed Fired when a payment capture completes successfully.
- Payment Capture Denied Fired when a payment capture is denied.
- Payment Capture Pending Fired when a payment capture is pending review or clearing.
- Payment Capture Refunded Fired when a captured payment is refunded (fully or partially).
- Payment Capture Reversed Fired when a captured payment is reversed by PayPal.
- Payment Authorization Created Fired when a payment authorization is created (funds held).
- Payment Authorization Voided Fired when a payment authorization is voided and held funds are released.
- Sale Completed Fired when a sale (v1 payment) completes. Commonly fired for subscription recurring payments.
- Sale Denied Fired when a sale (v1 payment) is denied.
- Sale Pending Fired when a sale (v1 payment) is pending.
- Sale Refunded Fired when a sale (v1 payment) is refunded.
- Sale Reversed Fired when a sale (v1 payment) is reversed.
- Payout Batch Success Fired when a batch payout completes successfully.
- Payout Batch Denied Fired when a batch payout is denied.
- Payout Batch Processing Fired when a batch payout begins processing.
- Payout Item Succeeded Fired when an individual payout item succeeds.
- Payout Item Failed Fired when an individual payout item fails.
- Payout Item Blocked Fired when an individual payout item is blocked.
- Payout Item Canceled Fired when an individual payout item is canceled.
- Payout Item Held Fired when an individual payout item is held.
- Payout Item Refunded Fired when an individual payout item is refunded.
- Payout Item Returned Fired when an individual payout item is returned (unclaimed funds returned to sender).
- Payout Item Unclaimed Fired when an individual payout item becomes unclaimed and is cancellable.
- Invoice Created Fired when an invoice is created.
- Invoice Updated Fired when an invoice is updated.
- Invoice Cancelled Fired when an invoice is cancelled.
- Invoice Paid Fired when an invoice is fully paid.
- Invoice Refunded Fired when an invoice is refunded.
- Invoice Scheduled Fired when an invoice is scheduled for future sending.
- Billing Plan Created Fired when a billing plan is created.
- Billing Plan Updated Fired when a billing plan is updated.
- Billing Plan Activated Fired when a billing plan is activated.
- Billing Plan Deactivated Fired when a billing plan is deactivated.
- Billing Plan Pricing Change Activated Fired when a pricing change on a billing plan is activated.
- Subscription Created Fired when a subscription is created (APPROVAL_PENDING).
- Subscription Activated Fired when a subscription becomes active.
- Subscription Updated Fired when a subscription is updated.
- Subscription Cancelled Fired when a subscription is cancelled.
- Subscription Suspended Fired when a subscription is suspended.
- Subscription Expired Fired when a subscription expires.
- Subscription Re-Activated Fired when a suspended subscription is re-activated.
- Subscription Payment Failed Fired when a recurring subscription payment fails.
- Customer Dispute Created Fired when a customer opens a dispute.
- Customer Dispute Updated Fired when a customer dispute is updated.
- Customer Dispute Resolved Fired when a customer dispute is resolved.
- Risk Dispute Created Fired when a risk-based dispute is created.
- Generic PayPal Webhook Processes any PayPal webhook event not matched by a specific handler, emitting the native event_type.
- Webhook Active Check Answers PayPal connectivity/reachability checks with HTTP 200. Does not emit an event.
Do More, Build Less
Integration Infrastructure for PayPal AI Agents
"What impressed us most about StackOne is its ambition and clarity. They're creating infrastructure that modern software and the entire AI agent ecosystem can rely on. The depth of secure integrations, the pace of delivery, and the team's foresight into AI's future uniquely position StackOne to redefine this category."
Luna Schmid, Partner at GV
"We've been impressed by how quickly and deeply StackOne integrates with complex enterprise systems -- and now, with their focus on agent-to-agent interoperability, they're unlocking even more powerful use cases for customers. StackOne delivers all of the above in a universal layer -- without compromise."
Barbry McGann, SVP at Workday Ventures
Product Teams Love Building Agent Integrations With StackOne
Agentic Automation
A US medical research organisation
Connectors for workflow builders
Agentic Connectors
Scroll to explore
More Commerce Integrations Like PayPal
Klaviyo
172+ actions
Square
137+ actions
Stripe
133+ actions
Magento
128+ actions
BigCommerce
120+ actions
Eventbrite
90+ actions
Shopify
85+ actions
PayPal AI agent integration resources
Webhooks for AI agents: why agentic workflows need them purpose-built
AI agents can act the moment a system changes, using webhooks. But webhooks built for software hit three limits in agentic workflows. Here is how to fix each.
7 min read
Agentic Context Engineering: Why AI Agents Kill Their Own Context Windows
AI agents exceed their context windows without knowing it. Six failure patterns and seven survival architectures for agentic context engineering.
15 min
MCP Code Mode: Keeping Tool Responses Out of Agent Context
Anthropic's code_execution processes data already in context. Custom MCP code mode keeps raw tool responses in a sandbox. 14K tokens vs 500.
11 min
Comparing BM25, TF-IDF, and Hybrid Search for MCP Tool Discovery
Benchmarking BM25, TF-IDF, and hybrid search for MCP tool discovery across 916 tools. The 80/20 TF-IDF/BM25 hybrid hits 21% Top-1 accuracy in under 1ms.
10 min
PayPal integration FAQ
Do I need to create my own auth app to connect PayPal to StackOne?
Yes, you need an auth app inside the PayPal Developer Dashboard. PayPal calls this a "REST API app" (Merchant type). Once created, paste the Client ID and Secret into the StackOne dashboard auth config for the PayPal connector, with Sandbox or Live environment selected. See the PayPal auth docs.
Put your AI agents to work
All the tools you need to build and scale AI agent integrations, with best-in-class connectivity, execution, and security.