Stripe events

Events that update agent instances and token balances.

Handlers map Stripe objects to database records: agent instances, subscription status, and token balance credits. Failed processing should be visible in application logs with correlation IDs.

  • checkout.session.completed — subscription or one-time token top-up
  • customer.subscription.updated / deleted — subscription lifecycle
  • invoice.paid — recurring billing confirmation where applicable

Exact event list may evolve; treat the webhook handler implementation as the source of truth during development.