# Webhook event names (/api/rest/webhooks/event-names)



PayPal supports these webhook events:

* [Payments](#payments)
* [Batch payouts](#batch-payouts)
* [Billing plans and agreements](#billing-plans-and-agreements)
* [Log in with PayPal](#log-in-with-paypal)
* [Checkout buyer approval](#checkout-buyer-approval)
* [Disputes](#disputes)
* [Invoicing](#invoicing)
* [Marketplaces and Platforms](#marketplaces-and-platforms)
* [Merchant onboarding](#merchant-onboarding)
* [Orders](#orders)
* [Payment orders](#payment-orders)
* [Referenced payouts](#referenced-payouts)
* [Sales](#sales)
* [Subscriptions](#subscriptions)
* [Payment Method Tokens](/api/rest/webhooks/event-names/#payment-method-tokens)
* [Payment Tokenization](#payment-tokenization)

## Payments [#payments]

The webhooks for authorizing and capturing payments correspond to both supported versions of the Payments API:

* [Payments V2](#payments-v2)
* [Payments V1](#payments-v1)

> **Info:** **Note:**
>
>  PayPal supports only PayPal authorizations.

### Payments v2 [#payments-v2]

| Event                           | Trigger                                                                                                                                                                       | Related method                                                                                                       |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `PAYMENT.AUTHORIZATION.CREATED` | A payment authorization is created, approved, executed, or a future payment authorization is created.                                                                         | [Capture authorized payment](/api/payments/v2/authorizations-capture/)                                               |
| `PAYMENT.AUTHORIZATION.VOIDED`  | A payment authorization is voided either due to authorization reaching its 30 day validity period or authorization was manually voided using the Void Authorized Payment API. | [Show details for authorized payment](/api/payments/v2/authorizations-get/) with response `status` of `voided`.      |
| `PAYMENT.CAPTURE.DECLINED`      | A payment capture is declined.                                                                                                                                                | [Capture authorized payment](/api/payments/v2/authorizations-capture/) with `status` of `declined`.                  |
| `PAYMENT.CAPTURE.COMPLETED`     | A payment capture completes.                                                                                                                                                  | [Capture authorized payment](/api/payments/v2/authorizations-capture/) with response `status` of `completed`.        |
| `PAYMENT.CAPTURE.PENDING`       | The state of a payment capture changes to pending.                                                                                                                            | [Show details for authorized payment](/api/payments/v2/authorizations-capture/) with response `status` of `pending`. |
| `PAYMENT.CAPTURE.REFUNDED`      | A merchant refunds a payment capture.                                                                                                                                         | [Capture authorized payment](/api/payments/v2/authorizations-capture/) with response `status` of `refunded`.         |
| `PAYMENT.CAPTURE.REVERSED`      | PayPal reverses a payment capture.                                                                                                                                            | [Refund captured payment](/api/payments/v2/captures-refund/)                                                         |
| `PAYMENT.REFUND.PENDING`        | Refund status changes to pending. For example, this occurs when an `eCheck`-based refund takes a couple of days to process the refund from the merchant's bank account.       | [Refund captured payment](/api/payments/v2/captures-refund/)                                                         |
| `PAYMENT.REFUND.FAILED`         | This event is triggered when a refund is failed. For example, bank settlement process fails to issue the refund.                                                              | [Refund captured payment](/api/payments/v2/captures-refund/)                                                         |

### Payments v1 [#payments-v1]

| Event                           | Trigger                                                                                                                                                                 | Related method                                                                                 |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `PAYMENT.AUTHORIZATION.CREATED` | A payment authorization is created, approved, executed, or a future payment authorization is created.                                                                   | [Create payment](/api/deprecated/payments/v1/payment-create/) with `intent` set to `authorize` |
| `PAYMENT.AUTHORIZATION.VOIDED`  | A payment authorization is voided.                                                                                                                                      | [Void authorization](/api/deprecated/payments/v1/authorization-void/)                          |
| `PAYMENT.CAPTURE.COMPLETED`     | A payment capture completes.                                                                                                                                            | [Show captured payment details](/api/deprecated/payments/v1/capture-get/)                      |
| `PAYMENT.CAPTURE.DENIED`        | A payment capture is denied.                                                                                                                                            | [Show captured payment details](/api/deprecated/payments/v1/capture-get/)                      |
| `PAYMENT.CAPTURE.PENDING`       | The state of a payment capture changes to pending.                                                                                                                      | [Show captured payment details](/api/deprecated/payments/v1/capture-get/)                      |
| `PAYMENT.CAPTURE.REFUNDED`      | A merchant refunds a payment capture.                                                                                                                                   | [Refund captured payment](/api/deprecated/payments/v1/capture-refund/)                         |
| `PAYMENT.CAPTURE.REVERSED`      | PayPal reverses a payment capture.                                                                                                                                      | [Refund captured payment](/api/deprecated/payments/v1/capture-refund/)                         |
| `PAYMENT.REFUND.PENDING`        | Refund status changes to pending. For example, this occurs when an `eCheck`-based refund takes a couple of days to process the refund from the merchant's bank account. | [Refund captured payment](/api/deprecated/payments/v1/capture-refund/)                         |
| `PAYMENT.REFUND.FAILED`         | This event is triggered when a refund is failed. For example, bank settlement process fails to issue the refund.                                                        | [Refund captured payment](/api/deprecated/payments/v1/capture-refund/)                         |

## Batch payouts [#batch-payouts]

> **Info:** **Note:** The `PAYOUTSBATCH` webhooks do not contain item-related information.
>
> To get item-related information, use the [HATEOAS links](/api/rest/responses/#hateoas-links) from the webhooks response.

| Event                             | Trigger                                                    | Related method                                                                      |
| --------------------------------- | ---------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `PAYMENT.PAYOUTSBATCH.DENIED`     | A batch payout payment is denied.                          | [Show payout details](/api/payments.payouts-batch/v1/payouts-get/)                  |
| `PAYMENT.PAYOUTSBATCH.PROCESSING` | The state of a batch payout payment changes to processing. | [Show payout details](/api/payments.payouts-batch/v1/payouts-get/)                  |
| `PAYMENT.PAYOUTSBATCH.SUCCESS`    | A batch payout payment completes successfully.             | [Show payout details](/api/payments.payouts-batch/v1/payouts-get/)                  |
| `PAYMENT.PAYOUTS-ITEM.BLOCKED`    | A payouts item is blocked.                                 | [Show payout item details](/api/payments.payouts-batch/v1/payouts-item-get/)        |
| `PAYMENT.PAYOUTS-ITEM.CANCELED`   | A payouts item is canceled.                                | [Cancel unclaimed payout item](/api/payments.payouts-batch/v1/payouts-item-cancel/) |
| `PAYMENT.PAYOUTS-ITEM.FAILED`     | A payouts item fails.                                      | [Show payout item details](/api/payments.payouts-batch/v1/payouts-item-get/)        |
| `PAYMENT.PAYOUTS-ITEM.HELD`       | A payouts item is held.                                    | [Show payout item details](/api/payments.payouts-batch/v1/payouts-item-get/)        |
| `PAYMENT.PAYOUTS-ITEM.REFUNDED`   | A payouts item is refunded.                                | [Show payout item details](/api/payments.payouts-batch/v1/payouts-item-get/)        |
| `PAYMENT.PAYOUTS-ITEM.RETURNED`   | A payouts item is returned.                                | [Show payout item details](/api/payments.payouts-batch/v1/payouts-item-get/)        |
| `PAYMENT.PAYOUTS-ITEM.SUCCEEDED`  | A payouts item succeeds.                                   | [Show payout item details](/api/payments.payouts-batch/v1/payouts-item-get/)        |
| `PAYMENT.PAYOUTS-ITEM.UNCLAIMED`  | A payouts item is unclaimed.                               | [Show payout item details](/api/payments.payouts-batch/v1/payouts-item-get/)        |

## Billing plans and agreements [#billing-plans-and-agreements]

> **Warning:** **Deprecation notice**: The billing plans and agreements webhooks are
> deprecated along with the [Billing Agreements REST
> API](/api/deprecated/payments/v1).

| Event                               | Trigger                              | Related method                                       |
| ----------------------------------- | ------------------------------------ | ---------------------------------------------------- |
| `BILLING.PLAN.CREATED`              | A billing plan is created.           | [Create billing plan](/api/deprecated/payments/v1)   |
| `BILLING.PLAN.UPDATED`              | A billing plan is updated.           | [Update billing plan](/api/deprecated/payments/v1)   |
| `BILLING.SUBSCRIPTION.CANCELLED`    | A billing agreement is canceled.     | [Cancel agreement](/api/deprecated/payments/v1)      |
| `BILLING.SUBSCRIPTION.CREATED`      | A billing agreement is created.      | [Create agreement](/api/deprecated/payments/v1)      |
| `BILLING.SUBSCRIPTION.RE-ACTIVATED` | A billing agreement is re-activated. | [Re-activate agreement](/api/deprecated/payments/v1) |
| `BILLING.SUBSCRIPTION.SUSPENDED`    | A billing agreement is suspended.    | [Suspend agreement](/api/deprecated/payments/v1)     |
| `BILLING.SUBSCRIPTION.UPDATED`      | A billing agreement is updated.      | [Update agreement](/api/deprecated/payments/v1)      |

## Log in with PayPal [#log-in-with-paypal]

| Event                                    | Trigger                            | Related method |
| ---------------------------------------- | ---------------------------------- | -------------- |
| `IDENTITY.AUTHORIZATION-CONSENT.REVOKED` | A user's consent token is revoked. | Not applicable |

## Checkout buyer approval [#checkout-buyer-approval]

Event

Triggered when

Related method

PAYMENTS.PAYMENT.CREATED

Checkout payment is created and approved by buyer.

Payment details

CHECKOUT.ORDER.APPROVED

A buyer approved a checkout order

Orders

CHECKOUT.CHECKOUT.BUYER-APPROVED

Express checkout payment is created and approved by buyer.

Express Checkout

## Disputes [#disputes]

| Event                       | Trigger                    | Related method                                                                       |
| --------------------------- | -------------------------- | ------------------------------------------------------------------------------------ |
| `CUSTOMER.DISPUTE.CREATED`  | A dispute is created.      | N/A                                                                                  |
| `CUSTOMER.DISPUTE.RESOLVED` | A dispute is resolved.     | [Settle dispute](/api/customer-disputes/v1/disputes-adjudicate/)                     |
| `CUSTOMER.DISPUTE.UPDATED`  | A dispute is updated.      | [Partially update dispute](/api/customer-disputes/v1/disputes-patch/)                |
| `RISK.DISPUTE.CREATED`      | A risk dispute is created. | The `CUSTOMER.DISPUTE.CREATED` event type supersedes and deprecates this event type. |

## Invoicing [#invoicing]

| Event                         | Trigger                                                                | Related method                                                                  |
| ----------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `INVOICING.INVOICE.CANCELLED` | A merchant or customer cancels an invoice.                             | [Cancel invoice](/api/deprecated/invoicing/v1/invoice-get/)                     |
| `INVOICING.INVOICE.CREATED`   | An invoice is created.                                                 | [Create draft invoice](/api/deprecated/invoicing/v1/invoice-create/)            |
| `INVOICING.INVOICE.PAID`      | An invoice is paid, partially paid, or payment is made and is pending. | [Mark invoice as paid](/api/deprecated/invoicing/v1/invoice-record-payment/)    |
| `INVOICING.INVOICE.REFUNDED`  | An invoice is refunded or partially refunded.                          | [Mark invoice as refunded](/api/deprecated/invoicing/v1/invoice-record-refund/) |
| `INVOICING.INVOICE.SCHEDULED` | An invoice is scheduled.                                               | [Schedule invoice](/api/deprecated/invoicing/v1/invoice-schedule/)              |
| `INVOICING.INVOICE.UPDATED`   | An invoice is updated.                                                 | [Update invoice](/api/deprecated/invoicing/v1/invoice-update/)                  |

## Marketplaces and Platforms [#marketplaces-and-platforms]

| Event                                                        | Triggered When                                                                 | Related method                                                                        |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- |
| `CHECKOUT.ORDER.COMPLETED`                                   | See [`CHECKOUT.ORDER.COMPLETED`](#v2-1).                                       |                                                                                       |
| `CHECKOUT.ORDER.APPROVED`                                    | See [`CHECKOUT.ORDER.APPROVED`](#v2-1).                                        |                                                                                       |
| `CHECKOUT.ORDER.PROCESSED`                                   | See [`CHECKOUT.ORDER.PROCESSED`](#v1-1).                                       |                                                                                       |
| `CUSTOMER.ACCOUNT-LIMITATION.ADDED`                          | A limitation is added for a partner's managed account.                         | [Update managed account](/api/limited-release/managed-accounts/v3)                    |
| `CUSTOMER.ACCOUNT-LIMITATION.ESCALATED`                      | A limitation is escalated for a partner's managed account.                     | [Update managed account](/api/limited-release/managed-accounts/v3)                    |
| `CUSTOMER.ACCOUNT-LIMITATION.LIFTED`                         | A limitation is lifted for a partner's managed account.                        | [Update managed account](/api/limited-release/managed-accounts/v3)                    |
| `CUSTOMER.ACCOUNT-LIMITATION.UPDATED`                        | A limitation is updated for a partner's managed account.                       | [Update managed account](/api/limited-release/managed-accounts/v3)                    |
| `CUSTOMER.MERCHANT-INTEGRATION.CAPABILITY-UPDATED`           | PayPal must enable the merchant's account as `PPCP` for this webhook to work.  | [Create partner referral](/api/partner-referrals/v2/partner-referrals-create/)        |
| `CUSTOMER.MERCHANT-INTEGRATION.PRODUCT-SUBSCRIPTION-UPDATED` | The products available to the merchant have changed.                           | [Create partner referral](/api/partner-referrals/v2/partner-referrals-create/)        |
| `CUSTOMER.MERCHANT-INTEGRATION.SELLER-ALREADY-INTEGRATED`    | Merchant onboards again to a partner.                                          | [Create partner referral](/api/partner-referrals/v2/partner-referrals-create/)        |
| `CUSTOMER.MERCHANT-INTEGRATION.SELLER-ONBOARDING-INITIATED`  | PayPal creates a merchant account from the partner's onboarding link.          | [Create partner referral](/api/partner-referrals/v2/partner-referrals-create/)        |
| `CUSTOMER.MERCHANT-INTEGRATION.SELLER-CONSENT-GRANTED`       | Merchant grants consents to a partner.                                         | [Create partner referral](/api/partner-referrals/v2/partner-referrals-create/)        |
| `CUSTOMER.MERCHANT-INTEGRATION.SELLER-EMAIL-CONFIRMED`       | Merchant confirms the email and consents are granted.                          | [Create partner referral](/api/partner-referrals/v2/partner-referrals-create/)        |
| `MERCHANT.ONBOARDING.COMPLETED`                              | Merchant completes setup.                                                      | See `MERCHANT.ONBOARDING.COMPLETED` in [Merchant onboarding](#merchant-onboarding)    |
| `MERCHANT.PARTNER-CONSENT.REVOKED`                           | The consents for a merchant account setup are revoked or an account is closed. | See `MERCHANT.PARTNER-CONSENT.REVOKED` in [Merchant onboarding](#merchant-onboarding) |
| `PAYMENT.CAPTURE.COMPLETED`                                  | A payment capture completes.                                                   | See `PAYMENT.CAPTURE.COMPLETED` in [Payments](#payments)                              |
| `PAYMENT.CAPTURE.DENIED`                                     | A payment capture is denied.                                                   | See `PAYMENT.CAPTURE.DENIED` in [Payments](#payments)                                 |
| `PAYMENT.CAPTURE.REFUNDED`                                   | A merchant refunds a payment capture.                                          | See `PAYMENT.CAPTURE.REFUNDED` in [Payments](#payments)                               |
| `PAYMENT.REFERENCED-PAYOUT-ITEM.COMPLETED`                   | Funds are disbursed to the seller and partner.                                 | See `PAYMENT.REFERENCED-PAYOUT-ITEM.COMPLETE` in [Payments](#payments)                |
| `PAYMENT.REFERENCED-PAYOUT-ITEM.FAILED`                      | Attempt to disburse funds fails.                                               | See `PAYMENT.REFERENCED-PAYOUT-ITEM.FAILED` in [Payments](#payments)                  |

## Merchant onboarding [#merchant-onboarding]

| Event                                                       | Trigger                                                                         | Related method                                                                                           |
| ----------------------------------------------------------- | ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| `MERCHANT.ONBOARDING.COMPLETED`                             | A merchant completes setup.                                                     | [Seller Onboarding](/platforms/seller-onboarding/)                                                       |
| `MERCHANT.PARTNER-CONSENT.REVOKED`                          | The consents for a merchant account setup are revoked or an account is closed.  | [Seller Onboarding](/platforms/seller-onboarding/)                                                       |
| `CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-CREATED`                  | Managed account has been created.                                               | [Managed Path Onboarding](/limited-release/commerce-platform/onboard-merchants/create-merchant-accounts) |
| `CUSTOMER.MANAGED-ACCOUNT.CREATION-FAILED`                  | Managed account creation failed.                                                | [Managed Path Onboarding](/limited-release/commerce-platform/onboard-merchants/create-merchant-accounts) |
| `CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-UPDATED`                  | Managed account has been updated.                                               | [Managed Path Onboarding](/limited-release/commerce-platform/onboard-merchants/create-merchant-accounts) |
| `CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGED`           | Capabilities and/or process status has been changed on a managed account.       | [Managed Path Onboarding](/limited-release/commerce-platform/onboard-merchants/create-merchant-accounts) |
| `CUSTOMER.MANAGED-ACCOUNT.RISK-ASSESSED`                    | Managed account has been risk assessed or the risk assessment has been changed. | [Managed Path Onboarding](/limited-release/commerce-platform/onboard-merchants/create-merchant-accounts) |
| `CUSTOMER.MANAGED-ACCOUNT.NEGATIVE-BALANCE-NOTIFIED`        | Negative balance debit has been notified on a managed account.                  | [Update managed account](/api/limited-release/managed-accounts/v3)                                       |
| `CUSTOMER.MANAGED-ACCOUNT.NEGATIVE-BALANCE-DEBIT-INITIATED` | Negative balance debit has been initiated on a managed account.                 | [Update managed account](/api/limited-release/managed-accounts/v3)                                       |
| `CUSTOMER.ACCOUNT-LIMITATION.ADDED`                         | A limitation was added for given merchant account.                              | [Update managed account](/api/limited-release/managed-accounts/v3)                                       |
| `CUSTOMER.ACCOUNT-LIMITATION.LIFTED`                        | A limitation was lifted for given merchant account.                             | [Update managed account](/api/limited-release/managed-accounts/v3)                                       |
| `CUSTOMER.ACCOUNT-LIMITATION.UPDATED`                       | A limitation was updated for given merchant account.                            | [Update managed account](/api/limited-release/managed-accounts/v3)                                       |
| `CUSTOMER.ACCOUNT-LIMITATION.ESCALATED`                     | A limitation was escalated for given merchant account.                          | [Update managed account](/api/limited-release/managed-accounts/v3)                                       |

## Orders [#orders]

The webhooks for orders correspond to both supported versions of the Orders API:

* [Orders V2](#orders-v2)
* [Orders V1](#orders)

### Orders V2 [#orders-v2]

| Event                                | Trigger                                                                                                                                                                                                   | Related method                |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| `CHECKOUT.ORDER.COMPLETED`           | A checkout order is processed. &#x2A;*Note:** For use by marketplaces and platforms only.                                                                                                                 | [Orders API](/api/orders/v2/) |
| `CHECKOUT.ORDER.APPROVED`            | A buyer approved a checkout order                                                                                                                                                                         | [Orders API](/api/orders/v2/) |
| `CHECKOUT.PAYMENT-APPROVAL.REVERSED` | A problem occurred after the buyer approved the order but before you captured the payment. Refer to [Handle uncaptured payments](/v5/checkout/uncaptured-payments) for what to do when this event occurs. | [Orders API](/api/orders/v2/) |

## Payment orders [#payment-orders]

| Event                     | Trigger                      | Related method                                             |
| ------------------------- | ---------------------------- | ---------------------------------------------------------- |
| `PAYMENT.ORDER.CANCELLED` | A payment order is canceled. | [Void order](/api/deprecated/payments/v1/orders-void/)     |
| `PAYMENT.ORDER.CREATED`   | A payment order is created.  | [Create payment](/api/payments/v2/authorizations-capture/) |

## Referenced payouts [#referenced-payouts]

| Event                                      | Trigger                                        | Related method                                         |
| ------------------------------------------ | ---------------------------------------------- | ------------------------------------------------------ |
| `PAYMENT.REFERENCED-PAYOUT-ITEM.COMPLETED` | Funds are disbursed to the seller and partner. | [Create referenced payout item](/api/payouts/standard) |
| `PAYMENT.REFERENCED-PAYOUT-ITEM.FAILED`    | Attempt to disburse funds fails.               | [Create referenced payout item](/api/payouts/standard) |

## Sales [#sales]

| Event                    | Trigger                                             | Related method                                             |
| ------------------------ | --------------------------------------------------- | ---------------------------------------------------------- |
| `PAYMENT.SALE.COMPLETED` | A sale completes.                                   | [Show sale details](/api/deprecated/payments/v1/sale-get/) |
| `PAYMENT.SALE.DENIED`    | The state of a sale changes from pending to denied. | [Show sale details](/api/deprecated/payments/v1/sale-get/) |
| `PAYMENT.SALE.PENDING`   | The state of a sale changes to pending.             | [Show sale details](/api/deprecated/payments/v1/sale-get/) |
| `PAYMENT.SALE.REFUNDED`  | A merchant refunds a sale.                          | [Refund sale](/api/deprecated/payments/v1/sale-refund/)    |
| `PAYMENT.SALE.REVERSED`  | PayPal reverses a sale.                             | [Refund sale](/api/deprecated/payments/v1/sale-refund/)    |

## Subscriptions [#subscriptions]

| Webhook                                 | Trigger                                   | Related method                                                                  |
| :-------------------------------------- | :---------------------------------------- | :------------------------------------------------------------------------------ |
| `CATALOG.PRODUCT.CREATED`               | A product is created.                     | [Create product](/api/catalog-products/v1/products-create/)                     |
| `CATALOG.PRODUCT.UPDATED`               | A product is updated.                     | [Update product](/api/catalog-products/v1/products-patch/)                      |
| `PAYMENT.SALE.COMPLETED`                | A payment is made on a subscription.      |                                                                                 |
| `PAYMENT.SALE.REFUNDED`                 | A merchant refunds a sale.                |                                                                                 |
| `PAYMENT.SALE.REVERSED`                 | A payment is reversed on a subscription.  |                                                                                 |
| `BILLING.PLAN.CREATED`                  | A billing plan is created.                | [Create plan](/api/subscriptions/v1/plans-create/)                              |
| `BILLING.PLAN.UPDATED`                  | A billing plan is updated.                | [Update plan](/api/subscriptions/v1/plans-patch/)                               |
| `BILLING.PLAN.ACTIVATED`                | A billing plan is activated.              | [Activate plan](/api/subscriptions/v1/plans-activate/)                          |
| `BILLING.PLAN.PRICING-CHANGE.ACTIVATED` | A price change for the plan is activated. | [Update pricing](/api/subscriptions/v1/plans-update-pricing-schemes/)           |
| `BILLING.PLAN.DEACTIVATED`              | A billing plan is deactivated.            | [Deactivate plan](/api/subscriptions/v1/plans-deactivate/)                      |
| `BILLING.SUBSCRIPTION.CREATED`          | A subscription is created.                | [Create subscription](/api/subscriptions/v1/subscriptions-create/)              |
| `BILLING.SUBSCRIPTION.ACTIVATED`        | A subscription is activated.              | [Activate subscription](/api/subscriptions/v1/subscriptions-activate/)          |
| `BILLING.SUBSCRIPTION.UPDATED`          | A subscription is updated.                | [Update subscription](/api/subscriptions/v1/subscriptions-patch/)               |
| `BILLING.SUBSCRIPTION.EXPIRED`          | A subscription expires.                   | [Show subscription details](/api/subscriptions/v1/subscriptions-get/)           |
| `BILLING.SUBSCRIPTION.CANCELLED`        | A subscription is cancelled.              | [Cancel subscription](/api/subscriptions/v1/subscriptions-cancel/)              |
| `BILLING.SUBSCRIPTION.SUSPENDED`        | A subscription is suspended.              | [Suspend subscription](/api/subscriptions/v1/subscriptions-suspend/)            |
| `BILLING.SUBSCRIPTION.PAYMENT.FAILED`   | Payment failed on subscription.           | [Subscription failed payment details](/api/subscriptions/v1/subscriptions-get/) |

## Payment Method Tokens [#payment-method-tokens]

The [Payment Method Tokens API](/api/payment-tokens/v3/) saves payment methods to a digital vault so payers don't have to enter details for future transactions. Payers can check out faster or pay without being present after they agree to save a payment method.

| Event                                  | Trigger                                                                                                                                   | Payment methods  |
| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
| VAULT.PAYMENT-TOKEN.CREATED            | A payment token is created to save a payment method.                                                                                      | Cards and PayPal |
| VAULT.PAYMENT-TOKEN.DELETED            | A payment token is deleted. The payer's payment method is no longer saved to the PayPal vault.                                            | Cards and PayPal |
| VAULT.PAYMENT-TOKEN.DELETION-INITIATED | A request to delete a payment token has been submitted to the [Payment Method Tokens API](/api/payment-tokens/v3/payment-tokens-delete/). | PayPal           |

## Payment Tokenization [#payment-tokenization]

| Event                                             | Trigger                                                 | Related method |
| ------------------------------------------------- | ------------------------------------------------------- | -------------- |
| `PAYMENT-TOKENIZATION.ENROLLMENT.CREATED`         | An enrollment is created.                               | N/A            |
| `PAYMENT-TOKENIZATION.METADATA.CHANGED`           | The Payment tokenization metadata is changed.           | N/A            |
| `PAYMENT-TOKENIZATION.PAYMENT-CREDENTIAL.CREATED` | The Payment tokenization payment credential is created. | N/A            |
| `PAYMENT-TOKENIZATION.PAYMENT-CREDENTIAL.UPDATED` | The Payment tokenization payment credential is updated. | N/A            |
| `PAYMENT-TOKENIZATION.TOKEN-STATUS.CHANGED`       | The Payment tokenization token status is changed.       | N/A            |
| `PAYMENT-TOKENIZATION.TRANSACTION.CREATED`        | The Payment tokenization transaction is created.        | N/A            |

## See also [#see-also]

* [Webhooks overview](/api/rest/webhooks/)
* [Integrate webhooks](/api/rest/webhooks/rest/)
* [Webhooks API reference](/api/webhooks/v1/) [Webhooks API reference](/api/webhooks/v1/)
