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.

PayPal's MCP docs ↗

How to subscribe

  1. Connect your agent to Hookdeck's MCP server, the MCP Events bridge.
  2. Point your PayPal webhook at a Hookdeck source.
  3. Your agent lists the available events and subscribes to the ones it needs.

What are MCP events? →

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.

Not affiliated with PayPal. Facts are compiled from public sources and linked inline.