Subscriptions webhooks

DOCSCurrent

Last updated: Sept 24th, 5:31pm

A webhook is an HTTP callback that receives notification messages for events. See configure webhooks for more details.

PayPal APIs use webhooks for event notification. Most subscription-related actions trigger webhook events:

Webhook Trigger Related method
CATALOG.PRODUCT.CREATED A product is created. Create product
CATALOG.PRODUCT.UPDATED A product is updated. Update product
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
BILLING.PLAN.UPDATED A billing plan is updated. Update plan
BILLING.PLAN.ACTIVATED A billing plan is activated. Activate plan
BILLING.PLAN.PRICING-CHANGE.ACTIVATED A price change for the plan is activated. Update pricing
BILLING.PLAN.DEACTIVATED A billing plan is deactivated. Deactivate plan
BILLING.SUBSCRIPTION.CREATED A subscription is created. Create subscription
BILLING.SUBSCRIPTION.ACTIVATED A subscription is activated. Activate subscription
BILLING.SUBSCRIPTION.UPDATED A subscription is updated. Update subscription
BILLING.SUBSCRIPTION.EXPIRED A subscription expires. Show subscription details
BILLING.SUBSCRIPTION.CANCELLED A subscription is cancelled. Cancel subscription
BILLING.SUBSCRIPTION.SUSPENDED A subscription is suspended. Suspend subscription
BILLING.SUBSCRIPTION.PAYMENT.FAILED Payment failed on subscription. Subscription failed payment details

If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more