Events

5.1 Envelope & transport

Domain events are published to AWS EventBridge. Each event carries a type, a constant source of subscription-service, and a data payload identifying the subscription, instance, order, and customer involved.

  • Bus: configured by the EVENT_BUS_NAME environment variable (default eq-9-sandbox1-eventbus).
  • Gating (important): EventBridge publishing is disabled in the test, dev, and local stages — publishers still run but the transport does not emit. Every publish is best-effort (failures are swallowed and logged).

5.2 Published event types

Event type Triggered by
subscriptionCreated Create subscription
subscriptionCreationFailed Create subscription failure
subscriptionUpdated Update subscription
subscriptionCancelled Cancel subscription
subscriptionPaused Pause subscription
subscriptionResumed Resume subscription
pauseExtended Extend pause
processSummaryCreated Create process summary
subscriptionItemUpdated Update item
subscriptionItemSkipChanged Item skip flag change
subscriptionItemsBulkSkipChanged Bulk item skip change
subscriptionSkipNextOrderChanged Subscription-level skip change
subscriptionItemIntervalUpdated Item interval update
instanceCreated / instanceCreationFailed Instance (tenant) create
instanceUpdated / instancePropertiesUpdated Instance update / props update
instanceCompleted / instanceFailed Renewal processing outcome
instanceRetried / instanceSkipped Instance retry / skip
instanceTransactionCreated Instance transaction created
subscriptionsBulkCreated Bulk create
giftPurchased / giftPurchaseFailed Gift purchase outcome
giftRedeemed / giftRedemptionFailed Gift redemption outcome
giftNotificationResent Gift resend
productSwapped / productSwapFailed Product swap outcome
prepaidSubscriptionCreated / prepaidSubscriptionFailed Prepaid create outcome
prepaidSubscriptionRenewed / prepaidRenewalFailed Prepaid renewal outcome
prepaidConvertedToRecurring / prepaidConversionFailed Prepaid convert-to-recurring outcome
prepaidSubscriptionCancelled / prepaidCancellationFailed Prepaid cancel/refund outcome
userPreferenceCreated / userPreferenceUpdated / userPreferenceDeleted / userPreferenceProcessNowUpdated User-preference changes

In total the domain publishes 40+ distinct event types across subscriptions, instances, items, gifts, swaps, prepaid, and user preferences.

5.3 Consumed events

The service’s Lambda entrypoint handles EventBridge and SQS invocations, but only routes marketplace events (source marketplace-service, app.* detail-types) to the marketplace handler. Any other event is logged as “Unhandled event type”. Flag: the service does not currently consume its own domain events; only marketplace app-lifecycle events are handled.

Revision History
2026-08-05 | JP – Created the page and added the content.