object is the object that was created, updated, deleted, etc.
Checkout session events
checkout.session.completed where
object is the checkout session object
Occurs whenever a Checkout Session is completed — the customer has authorized (and, for automatic capture, paid for) the session.
checkout.session.expired where
object is the checkout session object
Occurs whenever a Checkout Session expires before it is completed.
checkout.session.refunded where
object is the checkout session object
Occurs whenever a Checkout Session is refunded.
Payment intent events
payment_intent.created where
object is the payment intent object
Occurs whenever a new PaymentIntent is created.
payment_intent.succeeded where
object is the payment intent object
Occurs whenever a PaymentIntent has succeeded.
payment_intent.payment_failed where
object is the payment intent object
Occurs whenever a PaymentIntent fails.
payment_intent.processing where
object is the payment intent object
Occurs whenever a PaymentIntent enters the processing state.
payment_intent.requires_capture where
object is the payment intent object
Occurs whenever a PaymentIntent is authorized and awaiting capture (manual capture).
payment_intent.requires_action where
object is the payment intent object
Occurs whenever a PaymentIntent requires additional customer action (e.g., 3-D Secure authentication).
payment_intent.amount_capturable_updated where
object is the payment intent object
Occurs whenever the amount that can be captured on a PaymentIntent changes.
payment_intent.canceled where
object is the payment intent object
Occurs whenever a PaymentIntent is canceled.
Charge events
charge.succeeded where
object is the charge object
Occurs whenever a charge is successful.
charge.pending where
object is the charge object
Occurs when a charge is created in a pending state (payment not yet settled).
charge.failed where
object is the charge object
Occurs whenever a charge attempt fails.
charge.captured where
object is the charge object
Occurs whenever a previously authorized charge is captured.
charge.expired where
object is the charge object
Occurs whenever an uncaptured charge expires.
charge.updated where
object is the charge object
Occurs whenever a charge is updated.
Refund events
charge.refunded where
object is the charge object
Occurs whenever a charge is refunded. Note that object here is the charge, not the refund.
charge.refund.updated where
object is the refund object
Occurs whenever a refund is updated. Deprecated — sent only for refunds that have an associated charge; listen to refund.updated for updates on all refunds.
refund.created where
object is the refund object
Occurs whenever a refund is created.
refund.updated where
object is the refund object
Occurs whenever a refund is updated.
refund.failed where
object is the refund object
Occurs whenever a refund fails.
Charge dispute events
charge.dispute.closed where
object is the dispute object
Occurs when a dispute is closed and the dispute status changes to won or lost.
charge.dispute.created where
object is the dispute object
Occurs whenever a customer disputes a charge with their bank (chargeback).
charge.dispute.funds_reinstated where
object is the dispute object
Occurs when funds are reinstated to your account after a dispute is closed. This includes partially refunded payments.
charge.dispute.funds_withdrawn where
object is the dispute object
Occurs when funds are removed from your account due to a dispute.
charge.dispute.updated where
object is the dispute object
Occurs when the dispute is updated (usually with evidence).
Payment method events
payment_method.attached where
object is the payment method object
Occurs whenever a payment method is attached to a customer.
payment_method.detached where
object is the payment method object
Occurs whenever a payment method is detached from a customer.
payment_method.updated where
object is the payment method object
Occurs whenever a payment method is updated.
payment_method.automatically_updated where
object is the payment method object
Occurs whenever a payment method is automatically updated by the card network (e.g., a new card number or expiration date).
Customer events
customer.created where
object is the customer object
Occurs whenever a new customer is created.
Subscription events
customer.subscription.created where
object is the subscription object
Occurs whenever a customer is signed up for a new plan.
customer.subscription.updated where
object is the subscription object
Occurs whenever an existing subscription changes (e.g., plan changes, payment failure, cancellation, status transitions like active → past_due). Not fired at subscription creation, and not reliably fired on trialing → active transitions. To detect new subscriptions, listen to customer.subscription.created (gated on status in (trialing, active)) or invoice.payment_succeeded.
customer.subscription.deleted where
object is the subscription object
Occurs whenever a customer’s subscription ends.
Invoice events
invoice.created where
object is the invoice object
Occurs whenever a new invoice is created.
invoice.updated where
object is the invoice object
Occurs whenever an invoice changes (e.g., line items, status, or amounts).
invoice.finalized where
object is the invoice object
Occurs whenever an invoice transitions from draft to open and is ready for payment.
invoice.paid where
object is the invoice object
Occurs whenever an invoice is paid in full. Fires alongside invoice.payment_succeeded for paid invoices.
invoice.payment_failed where
object is the invoice object
Occurs whenever an invoice payment attempt fails (e.g., declined card, insufficient funds). For subscriptions, this is typically followed by a customer.subscription.updated event transitioning the subscription to past_due.
invoice.payment_succeeded where
object is the invoice object
Occurs whenever an invoice payment attempt succeeds. For subscriptions, this is the most reliable signal that a customer has paid — recommended for provisioning or extending entitlements.
Product events
product.created where
object is the product object
Occurs whenever a new product is created.
product.updated where
object is the product object
Occurs whenever a product is updated.
Fraud events
radar.early_fraud_warning.created where
object is the early fraud warning object
Occurs whenever an early fraud warning is created for a charge.
radar.early_fraud_warning.updated where
object is the early fraud warning object
Occurs whenever an early fraud warning is updated.
Review events
review.opened where
object is the review object
Occurs whenever a payment is placed under review for potential fraud.
review.closed where
object is the review object
Occurs whenever a fraud review is closed and the payment’s review status is resolved.