AWS marketplace: Add SaaS free trial conversion event and isFreeTrialTermPresent field
Summary
Documents a new 'Purchase Agreement Free Trial Converted - Manufacturer' EventBridge event, clarifies that the agreement-expired/canceled/terminated and License Deprovisioned events are not sent for auto-converting free trials (only on buyer cancel), and notes that License Updated/Deprovisioned events now include an isFreeTrialTermPresent field. Also clarifies manufacturer vs proposer event routing for the new event.
Security assessment
The change is purely about subscription/entitlement lifecycle semantics for SaaS free trials in AWS Marketplace EventBridge events; it documents new event metadata (isFreeTrialTermPresent) and event-routing behavior but addresses no vulnerability, credential, authorization, or exposure concern.
Evidence
+License Updated - Manufacturer | The buyer's entitlement to a product has changed. | Customer entitlements are checked using the `GetEntitlements` API and services are provisioned accordingly. The event includes `isFreeTrialTermPresent`, the string `"true"`, when the agreement has a free trial term. The field is absent when it doesn't. | Manufacturer only
Diff
diff --git a/marketplace/latest/userguide/saas-eventbridge-integration.md b/marketplace/latest/userguide/saas-eventbridge-integration.md index 7f428f4..11916a6 100644 --- a//marketplace/latest/userguide/saas-eventbridge-integration.md +++ b//marketplace/latest/userguide/saas-eventbridge-integration.md @@ -47 +47,2 @@ Event name | Initiated by | Response | Recipient -| An agreement has expired, is canceled, is terminated. | Purchase agreement closure is recorded and post agreement cancelation actions happen. ISV begins revoking customer entitlements. | Manufacturer and proposer +| An agreement has expired, is canceled, is terminated. For a SaaS free trial that converts automatically, AWS Marketplace doesn't send this event when the free trial ends. It sends the event only if the buyer cancels. | Purchase agreement closure is recorded and post agreement cancelation actions happen. ISV begins revoking customer entitlements. | Manufacturer and proposer +Purchase Agreement Free Trial Converted - Manufacturer | A buyer's SaaS free trial converts to a paid subscription on the conversion date. | The seller sends any remaining metering records for usage during the free trial, and updates the buyer's status. The subscription continues. | Manufacturer only @@ -50,2 +51,2 @@ Purchase Agreement Advisory Resolved - Manufacturer | AWS has resolved the issue -License Updated - Manufacturer | The buyer's entitlement to a product has changed. | Customer entitlements are checked using the `GetEntitlements` API and services are provisioned accordingly. | Manufacturer only -License Deprovisioned - Manufacturer | The buyer's entitlement to a product has ended. | For usage-based products, this event marks the start of a 1-hour final reporting window. Sellers should collect and report any unreported usage using the `BatchMeterUsage` API. After this window closes, customer entitlements are fully revoked and usage reporting is no longer accepted. | Manufacturer only +License Updated - Manufacturer | The buyer's entitlement to a product has changed. | Customer entitlements are checked using the `GetEntitlements` API and services are provisioned accordingly. The event includes `isFreeTrialTermPresent`, the string `"true"`, when the agreement has a free trial term. The field is absent when it doesn't. | Manufacturer only +License Deprovisioned - Manufacturer | The buyer's entitlement to a product has ended. For a SaaS free trial that converts automatically, AWS Marketplace sends this event only if the buyer cancels. | For usage-based products, this event marks the start of a 1-hour final reporting window. Sellers should collect and report any unreported usage using the `BatchMeterUsage` API. After this window closes, customer entitlements are fully revoked and usage reporting is no longer accepted. The event includes `isFreeTrialTermPresent`, the string `"true"`, when the agreement has a free trial term. The field is absent when it doesn't. | Manufacturer only @@ -60 +61 @@ The Spend Threshold Reached, Spend Threshold Vet Succeeded, and Spend Threshold -Purchase agreement event types for manufacturer and proposer are nearly identical, except for the presence of a resaleAuthorization ID. To avoid redundant messages, only the proposer purchase agreement event is sent when you are both the manufacturer and proposer. +Purchase agreement event types for manufacturer and proposer are nearly identical, except for the presence of a resaleAuthorization ID. To avoid redundant messages, only the proposer purchase agreement event is sent when you are both the manufacturer and proposer. This doesn't apply to the `Purchase Agreement Free Trial Converted - Manufacturer` event, which AWS Marketplace sends only to the manufacturer.