| charge.created | A new charge was created (authorization only, not yet captured) |
| charge.succeeded | A charge succeeded — sent for every payment path (API, payment links, invoices, checkout, WooCommerce, wallets, subscriptions) |
| charge.failed | A charge was declined or failed — includes failure_code and failure_message. A disputed charge sends dispute.opened instead |
| refund.created | A refund was initiated |
| customer.created | A new customer was created |
| customer.updated | Customer details were updated |
| invoice.created | An invoice was generated (manual creation or billing cycle) |
| invoice.paid | An invoice was fully paid |
| invoice.sent | An invoice was emailed to the customer (DRAFT → SENT transition) |
| invoice.updated | An invoice was updated (status change not matching a more specific event) |
| invoice.voided | An invoice was voided or canceled |
| invoice.deleted | An invoice was deleted |
| invoice.overdue | An invoice passed its due date without payment |
| invoice.payment_failed | An invoice payment attempt failed (emitted alongside billing_cycle events) |
| subscription.created | A new subscription started (API or checkout) |
| subscription.updated | A subscription was updated (metadata, items, plan change) |
| subscription.canceled | A subscription was canceled |
| subscription.paused | A subscription was paused |
| subscription.resumed | A paused subscription was resumed |
| subscription.past_due | A subscription payment failed and the subscription is now past due |
| billing_cycle.paid | A recurring billing cycle was successfully charged |
| billing_cycle.failed | A recurring billing cycle failed after all retries |
| billing_cycle.retry_scheduled | A billing cycle payment failed and a retry is scheduled |
| payment_method.created | A payment instrument was tokenized and stored |
| payment_method.saved | A payment method was saved or updated for a customer (checkout, portal, or API) |
| payment_method.expired | A saved payment method has expired or is about to expire |
| product.created | A new product was created |
| checkout.session.completed | A checkout session was successfully paid |
| checkout.session.expired | A checkout session expired before payment |
| dispute.opened | A chargeback was received from the processor — includes the disputed charge, reason and respond_by |
| dispute.won | A dispute was resolved in your favor |
| dispute.lost | A dispute was lost (resolved against you, accepted or conceded) |
| payout.created | A payout was initiated |
| settlement.completed | A settlement batch completed successfully |
| settlement.failed | A settlement batch failed |
| billing.alert.triggered | A customer crossed a usage-threshold alert |
| portal.session.created | A customer portal session was created |
| portal.payment_method.removed | A payment method was removed via the portal |
| portal.subscription.canceled | A subscription was canceled via the portal |
| portal.subscription.payment_method_updated | A subscription payment method was changed via the portal |
| arrangement.created | A payment arrangement was created |
| arrangement.updated | An arrangement's plan (amount, frequency, payment method) was modified |
| arrangement.upfront_paid | The upfront payment for an arrangement was collected |
| arrangement.installment_paid | An installment charge succeeded |
| arrangement.installment_failed | An installment charge failed (includes failure reason and retry schedule) |
| arrangement.installment_deferred | A failed installment was deferred to the end of the schedule |
| arrangement.completed | All installments were collected — the plan is done |
| arrangement.paused | An active arrangement was paused |
| arrangement.resumed | A paused arrangement was resumed |
| arrangement.canceled | An arrangement was canceled |
| arrangement.defaulted | An arrangement defaulted after too many failed installments |
| arrangement.payment_method_updated | The card on file for an arrangement was updated |
