# PayPal webhook events

Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/paypal/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill paypal-webhooks` ([details](https://hookdeck.com/webhooks/paypal/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [PayPal's official docs](https://developer.paypal.com/docs/api/webhooks/v1/).

[Overview](https://hookdeck.com/webhooks/paypal) · [Webhook events (96)](https://hookdeck.com/webhooks/paypal/events) · [MCP events](https://hookdeck.com/webhooks/paypal/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/paypal/verify) · [Production guide](https://hookdeck.com/webhooks/paypal/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/paypal/skill)

## checkout

### PAYMENTS.PAYMENT.CREATED

Confidence: verified · Schema: from a captured delivery

Buyer creates and approves a checkout payment

Identified by: event_type field in the body · Object: `checkout`

```json
{
  "id": "WH-6W4482673W002281V-61985753LP2332451",
  "event_type": "PAYMENTS.PAYMENT.CREATED",
  "resource_type": "payment",
  "summary": "Checkout payment is created and approved by buyer",
  "create_time": "2015-05-11T21:45:15Z",
  "resource": { … },
  "links": [ … ],
  "event_version": "1.0"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/payments-payment-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-6W4482673W002281V-61985753LP2332451` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payments-payment-created.json)

### CHECKOUT.CHECKOUT.BUYER-APPROVED

Confidence: verified · Schema: from a captured delivery

Buyer approves an Express Checkout payment

Identified by: event_type field in the body · Object: `checkout`

```json
{
  "id": "WH-6W4482673W002281V-61985753LP2332451",
  "create_time": "2018-19-12T22:20:32.000Z",
  "event_type": "CHECKOUT.CHECKOUT.BUYER-APPROVED",
  "event_version": "1.0",
  "resource_type": "payment",
  "summary": "Checkout Payment is created and approved by buyer.",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/checkout-checkout-buyer-approved.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-6W4482673W002281V-61985753LP2332451` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/checkout-checkout-buyer-approved.json)

### CHECKOUT.ORDER.APPROVED

Confidence: verified · Schema: from a captured delivery

Buyer approves an order, ready for you to capture

Identified by: event_type field in the body · Object: `checkout`

```json
{
  "id": "WH-COC11055RA711503B-4YM959094A144403T",
  "create_time": "2018-04-16T21:21:49.000Z",
  "event_type": "CHECKOUT.ORDER.APPROVED",
  "resource_type": "checkout-order",
  "resource_version": "2.0",
  "summary": "An order has been approved by buyer",
  "resource": { … },
  "links": [ … ],
  "event_version": "1.0"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/checkout-order-approved.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-COC11055RA711503B-4YM959094A144403T` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/checkout-order-approved.json)

### CHECKOUT.ORDER.COMPLETED

Confidence: verified · Schema: from a captured delivery

Order finishes processing, for marketplaces and platforms only

Identified by: event_type field in the body · Object: `checkout`

```json
{
  "id": "WH-COC11055RA711503B-4YM959094A144403T",
  "create_time": "2018-04-16T21:21:49.000Z",
  "event_type": "CHECKOUT.ORDER.COMPLETED",
  "resource_type": "checkout-order",
  "resource_version": "2.0",
  "summary": "Checkout Order Completed",
  "resource": { … },
  "links": [ … ],
  "zts": 1494957670
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/checkout-order-completed.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-COC11055RA711503B-4YM959094A144403T` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/checkout-order-completed.json)

### CHECKOUT.ORDER.PROCESSED

Confidence: documented · Schema: No payload yet

[Listed in PayPal docs](https://developer.paypal.com/api/rest/webhooks/event-names/#marketplaces-and-platforms)

Identified by: event_type field in the body · Object: `checkout`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/checkout-order-processed.json)

### CHECKOUT.ORDER.CREATED

Confidence: documented · Schema: No payload yet

New checkout order is created

Identified by: event_type field in the body · Object: `checkout`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/checkout-order-created.json)

### CHECKOUT.ORDER.DECLINED

Confidence: documented · Schema: from PayPal docs (example)

Payment processing declines an order

Identified by: event_type field in the body · Object: `checkout`

```json
{
  "id": "WH-1SW574877T049922Y-2X2706431J788111J",
  "event_version": "1.0",
  "create_time": "2022-04-05T10:37:05Z",
  "resource_type": "checkout-order",
  "resource_version": "2.0",
  "event_type": "CHECKOUT.ORDER.DECLINED",
  "summary": "An order has been declined",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/checkout-order-declined.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-1SW574877T049922Y-2X2706431J788111J` |

From PayPal docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/checkout-order-declined.json)

### CHECKOUT.PAYMENT-APPROVAL.REVERSED

Confidence: documented · Schema: from PayPal docs (example)

Approved payment falls through before you capture it

Identified by: event_type field in the body · Object: `checkout`

```json
{
  "id": "WH-COC11055RA711503B-4YM959094A144403T",
  "create_time": "2021-03-19T08:17:29.782Z",
  "event_type": "CHECKOUT.PAYMENT-APPROVAL.REVERSED",
  "summary": "A payment has been reversed after approval.",
  "resource": { … },
  "event_version": "1.0"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/checkout-payment-approval-reversed.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-COC11055RA711503B-4YM959094A144403T` |

From PayPal docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/checkout-payment-approval-reversed.json)

## dispute

### CUSTOMER.DISPUTE.CREATED

Confidence: verified · Schema: from a captured delivery

New dispute is opened

Identified by: event_type field in the body · Object: `dispute`

```json
{
  "id": "WH-4M0448861G563140B-9EX36365822141321",
  "event_version": "1.0",
  "create_time": "2018-06-21T13:36:33.000Z",
  "resource_type": "dispute",
  "event_type": "CUSTOMER.DISPUTE.CREATED",
  "summary": "A new dispute opened with Case # PP-000-042-663-135",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-dispute-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-4M0448861G563140B-9EX36365822141321` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-dispute-created.json)

### CUSTOMER.DISPUTE.RESOLVED

Confidence: documented · Schema: No payload yet

Dispute reaches a resolution

Identified by: event_type field in the body · Object: `dispute`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-dispute-resolved.json)

### CUSTOMER.DISPUTE.UPDATED

Confidence: documented · Schema: No payload yet

Dispute details change

Identified by: event_type field in the body · Object: `dispute`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-dispute-updated.json)

### RISK.DISPUTE.CREATED

Confidence: documented · Schema: No payload yet

Older dispute event, superseded by CUSTOMER.DISPUTE.CREATED

Identified by: event_type field in the body · Object: `dispute`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/risk-dispute-created.json)

## invoice

### INVOICING.INVOICE.CANCELLED

Confidence: documented · Schema: No payload yet

Invoice is cancelled by either party

Identified by: event_type field in the body · Object: `invoice`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/invoicing-invoice-cancelled.json)

### INVOICING.INVOICE.CREATED

Confidence: documented · Schema: No payload yet

New draft invoice is created

Identified by: event_type field in the body · Object: `invoice`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/invoicing-invoice-created.json)

### INVOICING.INVOICE.PAID

Confidence: documented · Schema: No payload yet

Invoice is paid in full or in part, or payment is pending

Identified by: event_type field in the body · Object: `invoice`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/invoicing-invoice-paid.json)

### INVOICING.INVOICE.REFUNDED

Confidence: documented · Schema: No payload yet

Invoice is fully or partly refunded

Identified by: event_type field in the body · Object: `invoice`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/invoicing-invoice-refunded.json)

### INVOICING.INVOICE.SCHEDULED

Confidence: documented · Schema: No payload yet

Invoice is set to send later

Identified by: event_type field in the body · Object: `invoice`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/invoicing-invoice-scheduled.json)

### INVOICING.INVOICE.SENT

Confidence: documented · Schema: No payload yet

Invoice goes out to its recipient

Identified by: event_type field in the body · Object: `invoice`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/invoicing-invoice-sent.json)

### INVOICING.INVOICE.UPDATED

Confidence: documented · Schema: No payload yet

Invoice details change

Identified by: event_type field in the body · Object: `invoice`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/invoicing-invoice-updated.json)

### INVOICING.INVOICE.UNPAID

Confidence: documented · Schema: No payload yet

[Listed in PayPal docs](https://developer.paypal.com/docs/api/webhooks/v1/)

Identified by: event_type field in the body · Object: `invoice`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/invoicing-invoice-unpaid.json)

### INVOICING.RECURRING-INVOICES.EXPIRED

Confidence: documented · Schema: No payload yet

[Listed in PayPal docs](https://developer.paypal.com/docs/api/webhooks/v1/)

Identified by: event_type field in the body · Object: `invoice`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/invoicing-recurring-invoices-expired.json)

## merchant_account

### CUSTOMER.ACCOUNT-LIMITATION.ADDED

Confidence: documented · Schema: No payload yet

Managed account gets a new limitation

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-account-limitation-added.json)

### CUSTOMER.ACCOUNT-LIMITATION.ESCALATED

Confidence: documented · Schema: No payload yet

Managed account's limitation is escalated

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-account-limitation-escalated.json)

### CUSTOMER.ACCOUNT-LIMITATION.LIFTED

Confidence: documented · Schema: No payload yet

Limitation comes off a managed account

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-account-limitation-lifted.json)

### CUSTOMER.ACCOUNT-LIMITATION.UPDATED

Confidence: documented · Schema: No payload yet

Managed account's limitation changes

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-account-limitation-updated.json)

### CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-CREATED

Confidence: documented · Schema: No payload yet

Partner's managed account is created

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-managed-account-account-created.json)

### CUSTOMER.MANAGED-ACCOUNT.CREATION-FAILED

Confidence: documented · Schema: No payload yet

Managed account can't be created

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-managed-account-creation-failed.json)

### CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-UPDATED

Confidence: documented · Schema: No payload yet

Managed account details change

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-managed-account-account-updated.json)

### CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGED

Confidence: documented · Schema: No payload yet

Managed account's capabilities or process status change

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-managed-account-account-status-changed.json)

### CUSTOMER.MANAGED-ACCOUNT.RISK-ASSESSED

Confidence: documented · Schema: No payload yet

Managed account gets a new or changed risk assessment

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-managed-account-risk-assessed.json)

### CUSTOMER.MANAGED-ACCOUNT.NEGATIVE-BALANCE-NOTIFIED

Confidence: documented · Schema: No payload yet

Managed account is told of a negative balance debit

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-managed-account-negative-balance-notified.json)

### CUSTOMER.MANAGED-ACCOUNT.NEGATIVE-BALANCE-DEBIT-INITIATED

Confidence: documented · Schema: No payload yet

Negative balance debit starts on a managed account

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-managed-account-negative-balance-debit-initiated.json)

### CUSTOMER.MERCHANT-INTEGRATION.CAPABILITY-UPDATED

Confidence: documented · Schema: No payload yet

Merchant capability changes, on a PPCP-enabled account

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-merchant-integration-capability-updated.json)

### CUSTOMER.MERCHANT-INTEGRATION.PRODUCT-SUBSCRIPTION-UPDATED

Confidence: documented · Schema: No payload yet

Merchant's available products change

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-merchant-integration-product-subscription-updated.json)

### CUSTOMER.MERCHANT-INTEGRATION.SELLER-ALREADY-INTEGRATED

Confidence: documented · Schema: No payload yet

Merchant goes through partner onboarding again

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-merchant-integration-seller-already-integrated.json)

### CUSTOMER.MERCHANT-INTEGRATION.SELLER-CONSENT-GRANTED

Confidence: documented · Schema: No payload yet

Merchant gives a partner consent

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-merchant-integration-seller-consent-granted.json)

### CUSTOMER.MERCHANT-INTEGRATION.SELLER-EMAIL-CONFIRMED

Confidence: documented · Schema: No payload yet

Merchant confirms email after granting consents

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-merchant-integration-seller-email-confirmed.json)

### CUSTOMER.MERCHANT-INTEGRATION.SELLER-ONBOARDING-INITIATED

Confidence: documented · Schema: No payload yet

Partner's onboarding link creates a merchant account

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/customer-merchant-integration-seller-onboarding-initiated.json)

### MERCHANT.ONBOARDING.COMPLETED

Confidence: verified · Schema: from a captured delivery

Merchant finishes onboarding setup

Identified by: event_type field in the body · Object: `merchant_account`

```json
{
  "id": "WH-2WR32451HC0233532-67976317FL4543714",
  "create_time": "2016-08-01T21:41:28Z",
  "resource_type": "merchant-onboarding",
  "event_type": "MERCHANT.ONBOARDING.COMPLETED",
  "resource": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/merchant-onboarding-completed.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-2WR32451HC0233532-67976317FL4543714` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/merchant-onboarding-completed.json)

### MERCHANT.PARTNER-CONSENT.REVOKED

Confidence: documented · Schema: No payload yet

Merchant consent is withdrawn or the account closes

Identified by: event_type field in the body · Object: `merchant_account`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/merchant-partner-consent-revoked.json)

## payment

### PAYMENT.AUTHORIZATION.CREATED

Confidence: documented · Schema: from PayPal docs (example)

Payment gets authorized, including future payment authorizations

Identified by: event_type field in the body · Object: `payment`

```json
{
  "id": "8PT597110X687430LKGECATA",
  "create_time": "2013-06-25T21:41:28Z",
  "resource_type": "authorization",
  "event_version": "1.0",
  "event_type": "PAYMENT.AUTHORIZATION.CREATED",
  "summary": "A payment authorization was created",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-authorization-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `8PT597110X687430LKGECATA` |

From PayPal docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-authorization-created.json)

### PAYMENT.AUTHORIZATION.VOIDED

Confidence: documented · Schema: No payload yet

Authorization is voided manually or expires after 30 days

Identified by: event_type field in the body · Object: `payment`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-authorization-voided.json)

### PAYMENT.CAPTURE.COMPLETED

Confidence: documented · Schema: from PayPal docs (example)

Capture finishes and the order can be fulfilled

Identified by: event_type field in the body · Object: `payment`

```json
{
  "id": "WH-3F562076HD293871E-75F399086E414290U",
  "event_version": "1.0",
  "create_time": "2024-05-16T05:19:19.355Z",
  "resource_type": "capture",
  "resource_version": "2.0",
  "event_type": "PAYMENT.CAPTURE.COMPLETED",
  "summary": "Payment completed for $ 500.0 USD",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-capture-completed.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-3F562076HD293871E-75F399086E414290U` |

From PayPal docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-capture-completed.json)

### PAYMENT.CAPTURE.DECLINED

Confidence: documented · Schema: No payload yet

Capture attempt gets declined

Identified by: event_type field in the body · Object: `payment`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-capture-declined.json)

### PAYMENT.CAPTURE.DENIED

Confidence: documented · Schema: from PayPal docs (example)

Capture gets denied, so stop fulfilment

Identified by: event_type field in the body · Object: `payment`

```json
{
  "id": "WH-2B342482FC0449155-12X09416XP387753C",
  "event_version": "1.0",
  "create_time": "2022-04-05T10:37:05Z",
  "resource_type": "capture",
  "resource_version": "2.0",
  "event_type": "PAYMENT.CAPTURE.DENIED",
  "summary": "Payment denied for EUR 1.00 EUR",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-capture-denied.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-2B342482FC0449155-12X09416XP387753C` |

From PayPal docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-capture-denied.json)

### PAYMENT.CAPTURE.PENDING

Confidence: documented · Schema: from PayPal docs (example)

Capture moves to pending, so don't fulfil yet

Identified by: event_type field in the body · Object: `payment`

```json
{
  "id": "WH-3XD97656HT346122M-81M194208A0322526",
  "event_version": "1.0",
  "create_time": "2021-06-16T22:52:21.351Z",
  "resource_type": "capture",
  "resource_version": "2.0",
  "event_type": "PAYMENT.CAPTURE.PENDING",
  "summary": "Payment pending for EUR 100.0 EUR",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-capture-pending.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-3XD97656HT346122M-81M194208A0322526` |

From PayPal docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-capture-pending.json)

### PAYMENT.CAPTURE.REFUNDED

Confidence: documented · Schema: No payload yet

Merchant refunds captured funds

Identified by: event_type field in the body · Object: `payment`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-capture-refunded.json)

### PAYMENT.CAPTURE.REVERSED

Confidence: documented · Schema: No payload yet

PayPal pulls back a completed capture

Identified by: event_type field in the body · Object: `payment`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-capture-reversed.json)

### PAYMENT.REFUND.PENDING

Confidence: documented · Schema: No payload yet

Refund is waiting to process, as with an eCheck

Identified by: event_type field in the body · Object: `payment`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-refund-pending.json)

### PAYMENT.REFUND.FAILED

Confidence: documented · Schema: No payload yet

Refund can't complete, such as a bank settlement failure

Identified by: event_type field in the body · Object: `payment`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-refund-failed.json)

## payment_token

### VAULT.PAYMENT-TOKEN.CREATED

Confidence: documented · Schema: from PayPal docs (example)

Payment method is saved as a vault token

Identified by: event_type field in the body · Object: `payment_token`

```json
{
  "id": "WH-1KN88282901968003-82E75604WM969463F",
  "event_version": "1.0",
  "create_time": "2022-08-15T14:13:48.978Z",
  "resource_type": "payment_token",
  "resource_version": "3.0",
  "event_type": "VAULT.PAYMENT-TOKEN.CREATED",
  "summary": "A payment token has been created.",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/vault-payment-token-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-1KN88282901968003-82E75604WM969463F` |

From PayPal docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/vault-payment-token-created.json)

### VAULT.PAYMENT-TOKEN.DELETED

Confidence: documented · Schema: No payload yet

Saved payment token is removed from the vault

Identified by: event_type field in the body · Object: `payment_token`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/vault-payment-token-deleted.json)

### VAULT.PAYMENT-TOKEN.DELETION-INITIATED

Confidence: documented · Schema: No payload yet

Request to delete a payment token is submitted

Identified by: event_type field in the body · Object: `payment_token`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/vault-payment-token-deletion-initiated.json)

### PAYMENT-TOKENIZATION.ENROLLMENT.CREATED

Confidence: documented · Schema: No payload yet

Tokenization enrollment is created

Identified by: event_type field in the body · Object: `payment_token`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-tokenization-enrollment-created.json)

### PAYMENT-TOKENIZATION.METADATA.CHANGED

Confidence: documented · Schema: No payload yet

Tokenization metadata changes

Identified by: event_type field in the body · Object: `payment_token`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-tokenization-metadata-changed.json)

### PAYMENT-TOKENIZATION.PAYMENT-CREDENTIAL.CREATED

Confidence: documented · Schema: No payload yet

Tokenized payment credential is created

Identified by: event_type field in the body · Object: `payment_token`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-tokenization-payment-credential-created.json)

### PAYMENT-TOKENIZATION.PAYMENT-CREDENTIAL.UPDATED

Confidence: documented · Schema: No payload yet

Tokenized payment credential changes

Identified by: event_type field in the body · Object: `payment_token`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-tokenization-payment-credential-updated.json)

### PAYMENT-TOKENIZATION.TOKEN-STATUS.CHANGED

Confidence: documented · Schema: No payload yet

Token's status changes

Identified by: event_type field in the body · Object: `payment_token`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-tokenization-token-status-changed.json)

### PAYMENT-TOKENIZATION.TRANSACTION.CREATED

Confidence: documented · Schema: No payload yet

Tokenization transaction is created

Identified by: event_type field in the body · Object: `payment_token`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-tokenization-transaction-created.json)

## payout

### PAYMENT.PAYOUTSBATCH.DENIED

Confidence: documented · Schema: No payload yet

Payout batch gets denied

Identified by: event_type field in the body · Object: `payout`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-payoutsbatch-denied.json)

### PAYMENT.PAYOUTSBATCH.PROCESSING

Confidence: documented · Schema: No payload yet

Payout batch starts processing

Identified by: event_type field in the body · Object: `payout`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-payoutsbatch-processing.json)

### PAYMENT.PAYOUTSBATCH.SUCCESS

Confidence: documented · Schema: No payload yet

Payout batch finishes successfully

Identified by: event_type field in the body · Object: `payout`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-payoutsbatch-success.json)

### PAYMENT.PAYOUTS-ITEM.BLOCKED

Confidence: documented · Schema: No payload yet

Single payout item gets blocked

Identified by: event_type field in the body · Object: `payout`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-payouts-item-blocked.json)

### PAYMENT.PAYOUTS-ITEM.CANCELED

Confidence: documented · Schema: No payload yet

Unclaimed payout item gets canceled

Identified by: event_type field in the body · Object: `payout`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-payouts-item-canceled.json)

### PAYMENT.PAYOUTS-ITEM.FAILED

Confidence: documented · Schema: No payload yet

Single payout item fails

Identified by: event_type field in the body · Object: `payout`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-payouts-item-failed.json)

### PAYMENT.PAYOUTS-ITEM.HELD

Confidence: documented · Schema: No payload yet

Single payout item is put on hold

Identified by: event_type field in the body · Object: `payout`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-payouts-item-held.json)

### PAYMENT.PAYOUTS-ITEM.REFUNDED

Confidence: documented · Schema: No payload yet

Single payout item gets refunded

Identified by: event_type field in the body · Object: `payout`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-payouts-item-refunded.json)

### PAYMENT.PAYOUTS-ITEM.RETURNED

Confidence: documented · Schema: No payload yet

Single payout item comes back as returned

Identified by: event_type field in the body · Object: `payout`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-payouts-item-returned.json)

### PAYMENT.PAYOUTS-ITEM.SUCCEEDED

Confidence: documented · Schema: No payload yet

Single payout item succeeds

Identified by: event_type field in the body · Object: `payout`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-payouts-item-succeeded.json)

### PAYMENT.PAYOUTS-ITEM.UNCLAIMED

Confidence: documented · Schema: No payload yet

Recipient hasn't claimed a payout item

Identified by: event_type field in the body · Object: `payout`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-payouts-item-unclaimed.json)

### PAYMENT.REFERENCED-PAYOUT-ITEM.COMPLETED

Confidence: documented · Schema: No payload yet

Seller and partner receive disbursed funds

Identified by: event_type field in the body · Object: `payout`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-referenced-payout-item-completed.json)

### PAYMENT.REFERENCED-PAYOUT-ITEM.FAILED

Confidence: documented · Schema: No payload yet

Disbursing funds to seller and partner fails

Identified by: event_type field in the body · Object: `payout`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-referenced-payout-item-failed.json)

## sale

### PAYMENT.SALE.COMPLETED

Confidence: verified · Schema: from a captured delivery

Sale completes, including each subscription payment

Identified by: event_type field in the body · Object: `sale`

```json
{
  "id": "WH-2WR32451HC0233532-67976317FL4543714",
  "event_version": "1.0",
  "create_time": "2014-10-23T17:23:52Z",
  "resource_type": "sale",
  "event_type": "PAYMENT.SALE.COMPLETED",
  "summary": "A successful sale payment was made for $ 0.48 USD",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-sale-completed.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-2WR32451HC0233532-67976317FL4543714` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-sig`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-sale-completed.json)

### PAYMENT.SALE.DENIED

Confidence: documented · Schema: No payload yet

Pending sale ends up denied

Identified by: event_type field in the body · Object: `sale`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-sale-denied.json)

### PAYMENT.SALE.PENDING

Confidence: documented · Schema: No payload yet

Sale moves to pending

Identified by: event_type field in the body · Object: `sale`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-sale-pending.json)

### PAYMENT.SALE.REFUNDED

Confidence: documented · Schema: No payload yet

Merchant issues a refund on a sale

Identified by: event_type field in the body · Object: `sale`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-sale-refunded.json)

### PAYMENT.SALE.REVERSED

Confidence: documented · Schema: No payload yet

PayPal pulls back a sale, including subscription payments

Identified by: event_type field in the body · Object: `sale`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-sale-reversed.json)

## subscription

### BILLING.PLAN.CREATED

Confidence: verified · Schema: from a captured delivery

Billing plan gets created

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "id": "WH-2N1678257S892762B-8MC99539P4557624Y",
  "event_version": "1.0",
  "create_time": "2016-04-28T11:21:44Z",
  "resource_type": "plan",
  "event_type": "BILLING.PLAN.CREATED",
  "summary": "A billing plan was created",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-plan-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-2N1678257S892762B-8MC99539P4557624Y` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-sig`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-plan-created.json)

### BILLING.PLAN.UPDATED

Confidence: verified · Schema: from a captured delivery

Billing plan gets changed

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "id": "WH-303507964T970970H-60Y688551M4794625",
  "event_version": "1.0",
  "create_time": "2016-04-28T11:23:52Z",
  "resource_type": "plan",
  "event_type": "BILLING.PLAN.UPDATED",
  "summary": "A billing plan was updated",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-plan-updated.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-303507964T970970H-60Y688551M4794625` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-sig`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-plan-updated.json)

### BILLING.PLAN.ACTIVATED

Confidence: verified · Schema: from a captured delivery

Billing plan is switched on

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "id": "WH-55TG7562XN2588878-8YH955435R661687G",
  "create_time": "2018-19-12T22:20:32.000Z",
  "event_type": "BILLING.PLAN.ACTIVATED",
  "event_version": "1.0",
  "resource_type": "plan",
  "resource_version": "2.0",
  "summary": "A billing plan was activated.",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-plan-activated.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-55TG7562XN2588878-8YH955435R661687G` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-sig`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-plan-activated.json)

### BILLING.PLAN.DEACTIVATED

Confidence: documented · Schema: No payload yet

Billing plan is switched off

Identified by: event_type field in the body · Object: `subscription`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-plan-deactivated.json)

### BILLING.PLAN.PRICING-CHANGE.ACTIVATED

Confidence: verified · Schema: from a captured delivery

New pricing on a plan takes effect

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "id": "WH-55TG7562XN2588878-8YH955435R771687G",
  "create_time": "2018-19-12T22:20:32.000Z",
  "event_type": "BILLING.PLAN.PRICING-CHANGE.ACTIVATED",
  "event_version": "1.0",
  "resource_type": "plan",
  "resource_version": "2.0",
  "summary": "A billing plan pricing change is activated.",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-plan-pricing-change-activated.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-55TG7562XN2588878-8YH955435R771687G` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-sig`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-plan-pricing-change-activated.json)

### BILLING.SUBSCRIPTION.CREATED

Confidence: verified · Schema: from a captured delivery

New subscription or billing agreement is set up

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "id": "WH-19973937YW279670F-02S63370HL636500Y",
  "event_version": "1.0",
  "create_time": "2016-04-28T11:29:31Z",
  "resource_type": "Agreement",
  "event_type": "BILLING.SUBSCRIPTION.CREATED",
  "summary": "A billing subscription was created",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-19973937YW279670F-02S63370HL636500Y` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-created.json)

### BILLING.SUBSCRIPTION.ACTIVATED

Confidence: verified · Schema: from a captured delivery

Subscription becomes active

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "id": "WH-77687562XN25889J8-8Y6T55435R66168T6",
  "create_time": "2018-19-12T22:20:32.000Z",
  "event_type": "BILLING.SUBSCRIPTION.ACTIVATED",
  "event_version": "1.0",
  "resource_type": "subscription",
  "resource_version": "2.0",
  "summary": "A billing agreement was activated.",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-activated.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-77687562XN25889J8-8Y6T55435R66168T6` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-activated.json)

### BILLING.SUBSCRIPTION.UPDATED

Confidence: verified · Schema: from a captured delivery

Subscription or billing agreement changes

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "id": "WH-7BW55401AV391063H-02P24463AR970092S",
  "event_version": "1.0",
  "create_time": "2016-04-28T11:43:08Z",
  "resource_type": "Agreement",
  "event_type": "BILLING.SUBSCRIPTION.UPDATED",
  "summary": "A billing subscription was updated",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-updated.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-7BW55401AV391063H-02P24463AR970092S` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-updated.json)

### BILLING.SUBSCRIPTION.EXPIRED

Confidence: verified · Schema: from a captured delivery

Subscription reaches its end and expires

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "id": "WH-UY687577TY25889J9-2R6T55435R66168Y6",
  "create_time": "2018-19-12T22:20:32.000Z",
  "event_type": "BILLING.SUBSCRIPTION.EXPIRED",
  "event_version": "1.0",
  "resource_type": "subscription",
  "resource_version": "2.0",
  "summary": "A billing agreement has expired.",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-expired.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-UY687577TY25889J9-2R6T55435R66168Y6` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-expired.json)

### BILLING.SUBSCRIPTION.CANCELLED

Confidence: verified · Schema: from a captured delivery

Subscription or billing agreement gets cancelled

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "id": "WH-6TD369808N914414D-1YJ376786E892292F",
  "event_version": "1.0",
  "create_time": "2016-04-28T11:53:10Z",
  "resource_type": "Agreement",
  "event_type": "BILLING.SUBSCRIPTION.CANCELLED",
  "summary": "A billing subscription was cancelled",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-cancelled.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-6TD369808N914414D-1YJ376786E892292F` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-cancelled.json)

### BILLING.SUBSCRIPTION.SUSPENDED

Confidence: verified · Schema: from a captured delivery

Subscription or billing agreement is paused

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "id": "WH-0RD44774E41721427-487281337V896051W",
  "event_version": "1.0",
  "create_time": "2016-04-28T11:37:14Z",
  "resource_type": "Agreement",
  "event_type": "BILLING.SUBSCRIPTION.SUSPENDED",
  "summary": "A billing subscription was suspended",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-suspended.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-0RD44774E41721427-487281337V896051W` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-suspended.json)

### BILLING.SUBSCRIPTION.RE-ACTIVATED

Confidence: verified · Schema: from a captured delivery

Suspended billing agreement is active again

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "id": "WH-8KT47529P7696805Y-3CS72897S14937140",
  "event_version": "1.0",
  "create_time": "2016-04-28T11:41:01Z",
  "resource_type": "Agreement",
  "event_type": "BILLING.SUBSCRIPTION.RE-ACTIVATED",
  "summary": "A billing subscription was reactivated",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-re-activated.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-8KT47529P7696805Y-3CS72897S14937140` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-re-activated.json)

### BILLING.SUBSCRIPTION.PAYMENT.FAILED

Confidence: verified · Schema: from a captured delivery

Subscription payment attempt fails

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "id": "WH-77687562XN25889J2-8Y6T55435R66168T4",
  "create_time": "2019-01-01T01:20:54.000Z",
  "event_type": "BILLING.SUBSCRIPTION.PAYMENT.FAILED",
  "event_version": "1.0",
  "resource_type": "subscription",
  "resource_version": "2.0",
  "summary": "Subscription payment failed",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-payment-failed.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-77687562XN25889J2-8Y6T55435R66168T4` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-payment-failed.json)

### BILLING.SUBSCRIPTION.PAYMENT.SUCCEEDED

Confidence: documented · Schema: No payload yet

Subscription payment goes through

Identified by: event_type field in the body · Object: `subscription`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/billing-subscription-payment-succeeded.json)

### CATALOG.PRODUCT.CREATED

Confidence: verified · Schema: from a captured delivery

Catalog product gets created

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "id": "WH-55TG7562XN2588878-8YH955435R661687G",
  "create_time": "2018-12-19T22:20:32.000Z",
  "event_type": "CATALOG.PRODUCT.CREATED",
  "event_version": "1.0",
  "resource_type": "product",
  "resource_version": "2.0",
  "summary": "Product created",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/catalog-product-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-55TG7562XN2588878-8YH955435R661687G` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-sig`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/catalog-product-created.json)

### CATALOG.PRODUCT.UPDATED

Confidence: verified · Schema: from a captured delivery

Catalog product gets changed

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "id": "WH-55TG7562XN2588878-8YH955435R661687G",
  "create_time": "2018-12-19T22:20:32.000Z",
  "event_type": "CATALOG.PRODUCT.UPDATED",
  "event_version": "1.0",
  "resource_type": "product",
  "resource_version": "2.0",
  "summary": "Product updated",
  "resource": { … },
  "links": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paypal/events/catalog-product-updated.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `WH-55TG7562XN2588878-8YH955435R661687G` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `cal_poolstack`, `client_pid`, `content-type`, `correlation-id`, `paypal-auth-algo`, `paypal-auth-version`, `paypal-cert-url`, `paypal-transmission-id`, `paypal-transmission-sig`, `paypal-transmission-time`, `x-b3-spanid`

[View as JSON](https://hookdeck.com/webhooks/paypal/events/catalog-product-updated.json)

## Other PayPal events

### IDENTITY.AUTHORIZATION-CONSENT.REVOKED

Confidence: documented · Schema: No payload yet

User's Log in with PayPal consent token is revoked

Identified by: event_type field in the body · Object: `IDENTITY`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/identity-authorization-consent-revoked.json)

### PAYMENT.ORDER.CREATED

Confidence: documented · Schema: No payload yet

Payment order gets created

Identified by: event_type field in the body · Object: `payment_order`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-order-created.json)

### PAYMENT.ORDER.CANCELLED

Confidence: documented · Schema: No payload yet

Payment order gets canceled

Identified by: event_type field in the body · Object: `payment_order`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/paypal/events/payment-order-cancelled.json)

---

Not affiliated with PayPal. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/paypal.json) · [Report a correction](https://hookdeck.com/contact)
