AWS marketplace documentation change
Summary
Renamed 'Event types' to 'Supported email notifications' throughout the document and added a new section detailing email notifications for cancellations and billing adjustments, including specific email templates and recipient information.
Security assessment
The changes are purely documentation updates for clarity and completeness. The addition of cancellation and billing adjustment notification details is a feature enhancement, not a response to a security vulnerability. The note about protecting channel partner margin information by excluding refund amounts from ISV notifications is a business confidentiality measure, not a security fix.
Diff
diff --git a/marketplace/latest/userguide/email-notifications.md b/marketplace/latest/userguide/email-notifications.md index c54a8153e..aac7e7da7 100644 --- a//marketplace/latest/userguide/email-notifications.md +++ b//marketplace/latest/userguide/email-notifications.md @@ -5 +5 @@ -Event typesField descriptionsManage notifications +Supported email notificationsField descriptionsManage notifications @@ -9 +9 @@ Event typesField descriptionsManage notifications -AWS Marketplace sends email notifications of updates to offers, agreements, subscriptions, products, security, billing and payments, and Private Marketplace. Independent software vendors (ISVs), AWS Marketplace Channel Partners, and customers can receive email notifications. For examples and details of email notifications sent for offer and agreement updates, refer to Event types. +AWS Marketplace sends email notifications of updates to offers, agreements, subscriptions, products, security, billing and payments, and Private Marketplace. Independent software vendors (ISVs), AWS Marketplace Channel Partners, and customers can receive email notifications. For examples and details of email notifications sent for offer and agreement updates, refer to Supported email notifications. @@ -19 +19 @@ If you are missing AWS Marketplace emails, check your spam folder or adjust emai - * Event types + * Supported email notifications @@ -28 +28 @@ If you are missing AWS Marketplace emails, check your spam folder or adjust emai -## Event types +## Supported email notifications @@ -30 +30 @@ If you are missing AWS Marketplace emails, check your spam folder or adjust emai -The following event types are supported by email notifications for all products and pricing types, except for machine learning products. +The following email notifications are supported for all products and pricing types, except for machine learning products. @@ -43,0 +44,2 @@ The following event types are supported by email notifications for all products + * Cancellations and billing adjustments + @@ -134,0 +137,25 @@ The `Resource ARN` field displays the ARN of the invalid bank account. To fix th +### Cancellations and billing adjustments + +Sellers, buyers, and ISVs (for CPPO) receive email notifications for agreement cancellation and billing adjustment events. The following tables show the emails that are sent for cancellation and billing adjustment events. + +**Cancellation request emails** + +Event | Recipient | Title | Fields +---|---|---|--- +Cancellation request submitted | Seller, Buyer, Manufacturer (CPPO) | You submitted an agreement cancellation request | Buyer account ID, Agreement ID, Product ID, Offer ID, Request ID, Request date, Request expiry date, Cancellation reason, Additional details, Response form URL +Cancellation request approved (by buyer or auto-approved) | Seller, Buyer, Manufacturer (CPPO) | Agreement cancellation request approved | Agreement ID, Product ID, Offer ID, Request ID, Request date, Cancellation reason, Canceled date +Cancellation request denied | Seller, Buyer, Manufacturer (CPPO) | Agreement cancellation request denied | Agreement ID, Product ID, Offer ID, Request ID, Request date, Cancellation reason, Denial reason, Denial date +Cancellation request withdrawn | Seller, Buyer, Manufacturer (CPPO) | Agreement cancellation request withdrawn | Agreement ID, Product ID, Offer ID, Request ID, Request date, Withdrawal reason +Cancellation request validation failed | Seller only | Agreement cancellation request failed | Agreement ID, Product ID, Request ID, Request date, Cancellation reason + +**Billing adjustment emails** + +Event | Recipient | Title | Fields +---|---|---|--- +Billing adjustment processed | Seller, Buyer, Manufacturer (CPPO) | Billing adjustment processed | Agreement ID, Product ID, Offer ID, Request ID, Invoice ID(s), Refund amount with currency code, Request date, Billing adjustment reason +Billing adjustment failed | Seller only | Billing adjustment request failed | Agreement ID, Product ID, Request ID, Invoice ID(s), Request date, Billing adjustment reason + +###### Note + +For CPPO agreements, the ISV (manufacturer) receives notifications when the channel partner submits or completes cancellation and billing adjustment requests. However, the refund amount and message to buyer are **not** included in ISV notifications to protect channel partner margin information. +