PayPal MCP events
PayPal's webhook events are available to agents as MCP events through Hookdeck Event Gateway.
PayPal's MCP server
PayPal's MCP server (mcp.paypal.com, or @paypal/mcp if you run it locally) lets merchants complete PayPal tasks, such as creating invoices, in natural language from an MCP client. Those tools call PayPal; they don't deliver PayPal's events. To get PayPal's events into an agent, subscribe it through Hookdeck Event Gateway, as described below.
How to subscribe
- Connect your agent to Hookdeck's MCP server, the MCP Events bridge.
- Point your PayPal webhook at a Hookdeck source.
- Your agent lists the available events and subscribes to the ones it needs.
Events
| Webhook event | MCP event |
|---|---|
PAYMENT.AUTHORIZATION.CREATED | paypal.PAYMENT.AUTHORIZATION.CREATED |
PAYMENT.AUTHORIZATION.VOIDED | paypal.PAYMENT.AUTHORIZATION.VOIDED |
PAYMENT.CAPTURE.COMPLETED | paypal.PAYMENT.CAPTURE.COMPLETED |
PAYMENT.CAPTURE.DECLINED | paypal.PAYMENT.CAPTURE.DECLINED |
PAYMENT.CAPTURE.DENIED | paypal.PAYMENT.CAPTURE.DENIED |
PAYMENT.CAPTURE.PENDING | paypal.PAYMENT.CAPTURE.PENDING |
PAYMENT.CAPTURE.REFUNDED | paypal.PAYMENT.CAPTURE.REFUNDED |
PAYMENT.CAPTURE.REVERSED | paypal.PAYMENT.CAPTURE.REVERSED |
PAYMENT.REFUND.PENDING | paypal.PAYMENT.REFUND.PENDING |
PAYMENT.REFUND.FAILED | paypal.PAYMENT.REFUND.FAILED |
PAYMENT.PAYOUTSBATCH.DENIED | paypal.PAYMENT.PAYOUTSBATCH.DENIED |
PAYMENT.PAYOUTSBATCH.PROCESSING | paypal.PAYMENT.PAYOUTSBATCH.PROCESSING |
PAYMENT.PAYOUTSBATCH.SUCCESS | paypal.PAYMENT.PAYOUTSBATCH.SUCCESS |
PAYMENT.PAYOUTS-ITEM.BLOCKED | paypal.PAYMENT.PAYOUTS-ITEM.BLOCKED |
PAYMENT.PAYOUTS-ITEM.CANCELED | paypal.PAYMENT.PAYOUTS-ITEM.CANCELED |
PAYMENT.PAYOUTS-ITEM.FAILED | paypal.PAYMENT.PAYOUTS-ITEM.FAILED |
PAYMENT.PAYOUTS-ITEM.HELD | paypal.PAYMENT.PAYOUTS-ITEM.HELD |
PAYMENT.PAYOUTS-ITEM.REFUNDED | paypal.PAYMENT.PAYOUTS-ITEM.REFUNDED |
PAYMENT.PAYOUTS-ITEM.RETURNED | paypal.PAYMENT.PAYOUTS-ITEM.RETURNED |
PAYMENT.PAYOUTS-ITEM.SUCCEEDED | paypal.PAYMENT.PAYOUTS-ITEM.SUCCEEDED |
PAYMENT.PAYOUTS-ITEM.UNCLAIMED | paypal.PAYMENT.PAYOUTS-ITEM.UNCLAIMED |
PAYMENT.REFERENCED-PAYOUT-ITEM.COMPLETED | paypal.PAYMENT.REFERENCED-PAYOUT-ITEM.COMPLETED |
PAYMENT.REFERENCED-PAYOUT-ITEM.FAILED | paypal.PAYMENT.REFERENCED-PAYOUT-ITEM.FAILED |
PAYMENT.SALE.COMPLETED | paypal.PAYMENT.SALE.COMPLETED |
PAYMENT.SALE.DENIED | paypal.PAYMENT.SALE.DENIED |
PAYMENT.SALE.PENDING | paypal.PAYMENT.SALE.PENDING |
PAYMENT.SALE.REFUNDED | paypal.PAYMENT.SALE.REFUNDED |
PAYMENT.SALE.REVERSED | paypal.PAYMENT.SALE.REVERSED |
PAYMENT.ORDER.CREATED | paypal.PAYMENT.ORDER.CREATED |
PAYMENT.ORDER.CANCELLED | paypal.PAYMENT.ORDER.CANCELLED |
PAYMENTS.PAYMENT.CREATED | paypal.PAYMENTS.PAYMENT.CREATED |
CHECKOUT.CHECKOUT.BUYER-APPROVED | paypal.CHECKOUT.CHECKOUT.BUYER-APPROVED |
CHECKOUT.ORDER.APPROVED | paypal.CHECKOUT.ORDER.APPROVED |
CHECKOUT.ORDER.COMPLETED | paypal.CHECKOUT.ORDER.COMPLETED |
CHECKOUT.ORDER.PROCESSED | paypal.CHECKOUT.ORDER.PROCESSED |
CHECKOUT.ORDER.CREATED | paypal.CHECKOUT.ORDER.CREATED |
CHECKOUT.ORDER.DECLINED | paypal.CHECKOUT.ORDER.DECLINED |
CHECKOUT.PAYMENT-APPROVAL.REVERSED | paypal.CHECKOUT.PAYMENT-APPROVAL.REVERSED |
BILLING.PLAN.CREATED | paypal.BILLING.PLAN.CREATED |
BILLING.PLAN.UPDATED | paypal.BILLING.PLAN.UPDATED |
BILLING.PLAN.ACTIVATED | paypal.BILLING.PLAN.ACTIVATED |
BILLING.PLAN.DEACTIVATED | paypal.BILLING.PLAN.DEACTIVATED |
BILLING.PLAN.PRICING-CHANGE.ACTIVATED | paypal.BILLING.PLAN.PRICING-CHANGE.ACTIVATED |
BILLING.SUBSCRIPTION.CREATED | paypal.BILLING.SUBSCRIPTION.CREATED |
BILLING.SUBSCRIPTION.ACTIVATED | paypal.BILLING.SUBSCRIPTION.ACTIVATED |
BILLING.SUBSCRIPTION.UPDATED | paypal.BILLING.SUBSCRIPTION.UPDATED |
BILLING.SUBSCRIPTION.EXPIRED | paypal.BILLING.SUBSCRIPTION.EXPIRED |
BILLING.SUBSCRIPTION.CANCELLED | paypal.BILLING.SUBSCRIPTION.CANCELLED |
BILLING.SUBSCRIPTION.SUSPENDED | paypal.BILLING.SUBSCRIPTION.SUSPENDED |
BILLING.SUBSCRIPTION.RE-ACTIVATED | paypal.BILLING.SUBSCRIPTION.RE-ACTIVATED |
BILLING.SUBSCRIPTION.PAYMENT.FAILED | paypal.BILLING.SUBSCRIPTION.PAYMENT.FAILED |
BILLING.SUBSCRIPTION.PAYMENT.SUCCEEDED | paypal.BILLING.SUBSCRIPTION.PAYMENT.SUCCEEDED |
CATALOG.PRODUCT.CREATED | paypal.CATALOG.PRODUCT.CREATED |
CATALOG.PRODUCT.UPDATED | paypal.CATALOG.PRODUCT.UPDATED |
CUSTOMER.DISPUTE.CREATED | paypal.CUSTOMER.DISPUTE.CREATED |
CUSTOMER.DISPUTE.RESOLVED | paypal.CUSTOMER.DISPUTE.RESOLVED |
CUSTOMER.DISPUTE.UPDATED | paypal.CUSTOMER.DISPUTE.UPDATED |
RISK.DISPUTE.CREATED | paypal.RISK.DISPUTE.CREATED |
INVOICING.INVOICE.CANCELLED | paypal.INVOICING.INVOICE.CANCELLED |
INVOICING.INVOICE.CREATED | paypal.INVOICING.INVOICE.CREATED |
INVOICING.INVOICE.PAID | paypal.INVOICING.INVOICE.PAID |
INVOICING.INVOICE.REFUNDED | paypal.INVOICING.INVOICE.REFUNDED |
INVOICING.INVOICE.SCHEDULED | paypal.INVOICING.INVOICE.SCHEDULED |
INVOICING.INVOICE.SENT | paypal.INVOICING.INVOICE.SENT |
INVOICING.INVOICE.UPDATED | paypal.INVOICING.INVOICE.UPDATED |
INVOICING.INVOICE.UNPAID | paypal.INVOICING.INVOICE.UNPAID |
INVOICING.RECURRING-INVOICES.EXPIRED | paypal.INVOICING.RECURRING-INVOICES.EXPIRED |
CUSTOMER.ACCOUNT-LIMITATION.ADDED | paypal.CUSTOMER.ACCOUNT-LIMITATION.ADDED |
CUSTOMER.ACCOUNT-LIMITATION.ESCALATED | paypal.CUSTOMER.ACCOUNT-LIMITATION.ESCALATED |
CUSTOMER.ACCOUNT-LIMITATION.LIFTED | paypal.CUSTOMER.ACCOUNT-LIMITATION.LIFTED |
CUSTOMER.ACCOUNT-LIMITATION.UPDATED | paypal.CUSTOMER.ACCOUNT-LIMITATION.UPDATED |
CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-CREATED | paypal.CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-CREATED |
CUSTOMER.MANAGED-ACCOUNT.CREATION-FAILED | paypal.CUSTOMER.MANAGED-ACCOUNT.CREATION-FAILED |
CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-UPDATED | paypal.CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-UPDATED |
CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGED | paypal.CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGED |
CUSTOMER.MANAGED-ACCOUNT.RISK-ASSESSED | paypal.CUSTOMER.MANAGED-ACCOUNT.RISK-ASSESSED |
CUSTOMER.MANAGED-ACCOUNT.NEGATIVE-BALANCE-NOTIFIED | paypal.CUSTOMER.MANAGED-ACCOUNT.NEGATIVE-BALANCE-NOTIFIED |
CUSTOMER.MANAGED-ACCOUNT.NEGATIVE-BALANCE-DEBIT-INITIATED | paypal.CUSTOMER.MANAGED-ACCOUNT.NEGATIVE-BALANCE-DEBIT-INITIATED |
CUSTOMER.MERCHANT-INTEGRATION.CAPABILITY-UPDATED | paypal.CUSTOMER.MERCHANT-INTEGRATION.CAPABILITY-UPDATED |
CUSTOMER.MERCHANT-INTEGRATION.PRODUCT-SUBSCRIPTION-UPDATED | paypal.CUSTOMER.MERCHANT-INTEGRATION.PRODUCT-SUBSCRIPTION-UPDATED |
CUSTOMER.MERCHANT-INTEGRATION.SELLER-ALREADY-INTEGRATED | paypal.CUSTOMER.MERCHANT-INTEGRATION.SELLER-ALREADY-INTEGRATED |
CUSTOMER.MERCHANT-INTEGRATION.SELLER-CONSENT-GRANTED | paypal.CUSTOMER.MERCHANT-INTEGRATION.SELLER-CONSENT-GRANTED |
CUSTOMER.MERCHANT-INTEGRATION.SELLER-EMAIL-CONFIRMED | paypal.CUSTOMER.MERCHANT-INTEGRATION.SELLER-EMAIL-CONFIRMED |
CUSTOMER.MERCHANT-INTEGRATION.SELLER-ONBOARDING-INITIATED | paypal.CUSTOMER.MERCHANT-INTEGRATION.SELLER-ONBOARDING-INITIATED |
MERCHANT.ONBOARDING.COMPLETED | paypal.MERCHANT.ONBOARDING.COMPLETED |
MERCHANT.PARTNER-CONSENT.REVOKED | paypal.MERCHANT.PARTNER-CONSENT.REVOKED |
IDENTITY.AUTHORIZATION-CONSENT.REVOKED | paypal.IDENTITY.AUTHORIZATION-CONSENT.REVOKED |
VAULT.PAYMENT-TOKEN.CREATED | paypal.VAULT.PAYMENT-TOKEN.CREATED |
VAULT.PAYMENT-TOKEN.DELETED | paypal.VAULT.PAYMENT-TOKEN.DELETED |
VAULT.PAYMENT-TOKEN.DELETION-INITIATED | paypal.VAULT.PAYMENT-TOKEN.DELETION-INITIATED |
PAYMENT-TOKENIZATION.ENROLLMENT.CREATED | paypal.PAYMENT-TOKENIZATION.ENROLLMENT.CREATED |
PAYMENT-TOKENIZATION.METADATA.CHANGED | paypal.PAYMENT-TOKENIZATION.METADATA.CHANGED |
PAYMENT-TOKENIZATION.PAYMENT-CREDENTIAL.CREATED | paypal.PAYMENT-TOKENIZATION.PAYMENT-CREDENTIAL.CREATED |
PAYMENT-TOKENIZATION.PAYMENT-CREDENTIAL.UPDATED | paypal.PAYMENT-TOKENIZATION.PAYMENT-CREDENTIAL.UPDATED |
PAYMENT-TOKENIZATION.TOKEN-STATUS.CHANGED | paypal.PAYMENT-TOKENIZATION.TOKEN-STATUS.CHANGED |
PAYMENT-TOKENIZATION.TRANSACTION.CREATED | paypal.PAYMENT-TOKENIZATION.TRANSACTION.CREATED |
Subscribe your agent to PayPal events.
Point your PayPal webhook at Event Gateway and run the MCP Events bridge. Event Gateway delivers each event to the agents whose subscription filters it matches, and retries failures.