Billing and Payments – Event Map — Architecture Catalog

7

Domain Events

5

Software Subsystems

7

Publish Links

12

Consume Links

Event Flow Diagram

Events Summary

Event	Status	Format	Publishers	Consumers
Invoice Generated Emitted when a new invoice is created for a billing cycle, triggering payment collection workflows.	active	CloudEvents/JSON	Billing Worker	Analytics Pipeline
Payment Failed Emitted when a payment attempt is declined or fails processing, initiating dunning and retry workflows.	active	CloudEvents/JSON	Billing Worker	CRM API Gateway
Payment Method Updated Emitted when a tenant updates their default payment method, allowing dunning recovery workflows to retry previously failed charges.	active	CloudEvents/JSON	Billing Worker	Tenant Admin PortalAudit Ingest API
Payment Refunded Emitted when a refund has been successfully processed and the funds have been returned to the customer's payment method.	active	CloudEvents/JSON	Billing Worker	Tenant Admin PortalAnalytics Pipeline
Plan Upgraded Emitted when a tenant upgrades their subscription to a higher tier plan, triggering quota increases and proration adjustments.	active	CloudEvents/JSON	Billing Worker	CRM API GatewayAnalytics Pipeline
Subscription Cancelled Emitted when a subscription is cancelled by the customer or automatically after failed dunning cycles, marking the end of the billing relationship.	active	CloudEvents/JSON	Billing Worker	CRM API GatewayTenant Admin PortalAnalytics Pipeline
Subscription Renewed Emitted when a subscription billing cycle completes successfully and the subscription is renewed.	active	CloudEvents/JSON	Billing Worker	Analytics Pipeline