# Seller notifications for AWS Marketplace events
You can receive notifications about important events related to your AWS Marketplace products, such as subscription changes, private offer acceptances, and professional services requests. Amazon EventBridge is the recommended approach for programmatic integration, while email notifications are also available. SNS topics remain available for existing integrations but are being replaced by Amazon EventBridge. This topic provides an overview of available notification and event options.
+ **EventBridge** – You can use EventBridge to receive an event for actions that happen in AWS Marketplace, for example, when an offer is created. The event contains information like the ID, expiration date, and product details. For more information, see [Amazon EventBridge events](notifications-eventbridge.md) and the [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html). For SaaS products specifically, see [Managing SaaS subscription events with Amazon EventBridge](saas-eventbridge-integration.md).
+ **Email notifications** – Within AWS Marketplace , sellers, buyers and independent software vendors (ISVs) can receive email notifications. AWS Marketplace uses your root account to send automated emails in real time to your AWS account's email, updating you on AWS Marketplace offers and agreements. You can also add custom email aliases for notifications and unsubscribe recipients from email notifications. For more information, see [Managing email notifications for AWS Marketplace events](email-notifications.md).
+ **Amazon SNS topics** – To receive notifications about changes to customer subscriptions for your products, you can subscribe to the Amazon SNS topics for AWS Marketplace provided to you during product creation. For example, you can know when customers accept a private offer. For information, see the Amazon SNS topic for your product type:
**Important**
SNS notifications for AWS Marketplace SaaS products are being replaced with Amazon EventBridge notifications. If you have existing SaaS products integrated with SNS, they will continue to function. New listings will eventually transition to using Amazon EventBridge instead of SNS. For more information, see [Managing SaaS subscription events with Amazon EventBridge](saas-eventbridge-integration.md).
+ [Software as a service (SaaS) products](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-notification.html)
+ [Amazon Machine Image (AMI) products](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-notification.html)
+ [Container products](https://docs.aws.amazon.com/marketplace/latest/userguide/container-notification.html)
The following topics provide more information about notifications and events in AWS Marketplace.
**Topics**
+ [Managing email notifications for AWS Marketplace events](email-notifications.md)
+ [Amazon EventBridge events](notifications-eventbridge.md)
# Managing email notifications for AWS Marketplace events
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](#event-types).
AWS Marketplace sends email notifications to the email address associated with the [root user](https://docs.aws.amazon.com/accounts/latest/reference/root-user.html) of your AWS account. To update the email address associated with your AWS account, refer to [Update the primary contact for your AWS account](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html). You can also [add custom email aliases](#adding-updating-email-addresses) for notifications and [unsubscribe recipients](#unsubscribe-notifications) from email notifications.
**Note**
If you are missing AWS Marketplace emails, check your spam folder or adjust email settings. Email notifications from AWS Marketplace are sent from `no-reply@marketplace.aws`. Providers such as Google and Yahoo may filter these. For instructions, refer to [Prevent valid emails from going to Spam (Google)](https://support.google.com/mail/answer/1366858?sjid=4026678185875351798-NA#unmark_spam) or [Block and unblock email addresses in Yahoo Mail](https://help.yahoo.com/kb/SLN28140.html).
**Topics**
+ [Supported email notifications](#event-types)
+ [Field descriptions](#email-notification-field-descriptions)
+ [Manage notifications](#manage-notifications)
## Supported email notifications
The following email notifications are supported for all products and pricing types, except for machine learning products.
**Topics**
+ [Offers and Offer Sets](#email-details-offers)
+ [Agreements](#email-details-agreements)
+ [Variable payments](#email-details-variable-payments)
+ [Disbursements](#email-details-disbursements)
+ [Adding bank account details](#add-bank-account-details)
+ [Cancellations and billing adjustments](#email-details-cancellations-adjustments)
### Offers and Offer Sets
The following table shows the events for offers and offer sets. An offer is a set of terms for a buyer's use of a product. For more information, refer to [Preparing a private offer for your AWS Marketplace product](private-offers-overview.md). Offer sets enable you to combine multiple private offers into a single-click purchase experience. For more information, refer to [Preparing your multi-product solution](multi-product-solutions.md).
**Note**
When an AWS Marketplace Channel Partner creates an offer set that includes an ISV's product(s), that ISV will not be notified.
| Email | Event | Recipient | Title | Fields |
| --- | --- | --- | --- | --- |
| Offer Published CP Notification CPPO | Publication of AWS Marketplace Channel Partner private offer. | Channel partner | AWS Marketplace Channel Partner private offer published | Customer AWS account ID, ISV name, ISV AWS Account ID, Product name, Product ID, Offer ID, Opportunity ID, Offer published date, Offer expiration date |
| Offer Published ISV Notification CPPO | Publication of AWS Marketplace Channel Partner private offer. | ISV | AWS Marketplace Channel Partner private offer published | Customer AWS account IDs, Channel partner, Channel partner AWS account ID, Product name, Product ID, Offer name, Offer ID, Opportunity ID, Offer published date, Offer expiration date, Wholesale price |
| OfferPubISVNotificationSCPO-1.0 | Seller publishes an AWS Marketplace Channel Partner private offer. | ISV or AWS Marketplace Channel Partner | Private offer published | Customer AWS Account IDs, Product Name, Product ID, Offer Name, Offer ID, Offer Published Date, Offer Expiration Date, Total Contract Value |
| Reseller Opportunity Expired | AWS Marketplace Channel Partner selling authorization expires. | AWS Marketplace Channel Partner | Offers: View expired selling authorization | ISV, Product Name, Product ID |
| Reseller Opportunity Revoked | ISV revokes AWS Marketplace Channel Partner selling authorization. | AWS Marketplace Channel Partner | Offers: View deactivated selling authorization | ISV, Product Name, Product ID |
| Reseller Opportunity Created | ISV creates a selling authorization or opportunity for the AWS Marketplace Channel Partner. | AWS Marketplace Channel Partner | Offers: Create private offer for new selling authorization | ISV, Product Name, Product ID, Selling authorization duration |
| Offer Set Published | Seller publishes an offer set. | ISV or AWS Marketplace Channel Partner | Offer Set Published | Offer set ID, Offer set name, Offer ID(s), Offer name(s) |
### Agreements
ISVs and AWS Marketplace Channel Partners receive email notification when a buyer accepts a public offer, private offer, or a AWS Marketplace Channel Partner private offer. An agreement is created when an offer is accepted. Email notifications are also sent for agreement lifecycle events. These include agreement commencements, cancellations, replacements, and failures after buyer acceptance. The following table shows the emails that are sent for agreement events. Email notifications are currently available for select product types. Your specific product type may not have this feature yet.
| Email | Event | Recipient | Title | Fields |
| --- | --- | --- | --- | --- |
| Offer Accepted – private or public offer | AWS Marketplace customer accepts a public or private offer. | ISV | Customer accepted an AWS Marketplace offer. | Customer company name, Customer AWS account ID, Product name, Product ID, Agreement ID, Agreement start date, Agreement end date, Agreement acceptance date, Purchase amount |
| Offer Accepted – AWS Marketplace Channel Partner private offer. | AWS Marketplace customer accepts an AWS Marketplace Channel Partner private offer. | ISV | Customer accepted an AWS Marketplace Channel Partner private offer. | Customer company name, Customer AWS account ID, Channel partner name, Channel partner AWS account ID, Product name, Product ID, Offer name, Offer ID, Agreement ID, Agreement start date, Agreement end date, Agreement acceptance date, Wholesale price |
| Offer Accepted – AWS Marketplace Channel Partner private offer. | AWS Marketplace customer accepts an AWS Marketplace Channel Partner private offer. | AWS Marketplace Channel Partner | Customer accepted an AWS Marketplace Channel Partner private offer. | Customer company name, Customer AWS account ID, ISV name, ISV AWS account ID, Product name, Product ID, Offer name, Offer ID, Agreement ID, Agreement start date, Agreement end date, Agreement acceptance date, Wholesale price, Margin, Purchase amount |
| Agreement Started – private offer | An AWS Marketplace agreement for the contract or subscription product has started from a private offer with a future start date. | ISV | An AWS Marketplace agreement has started | Customer AWS account ID, Product name, Product ID, Offer name, Offer ID, Agreement ID, Agreement start date, Agreement end date, Purchase amount |
| Agreement Started – AWS Marketplace Channel Partner private offer | An AWS Marketplace agreement for the contract or subscription product has started from an AWS Marketplace Channel Partner private offer. | ISV | An AWS Marketplace agreement has started. | Customer AWS account ID, Channel partner name, Channel partner AWS account ID, Product name, Product ID, Offer name, Offer ID, Agreement ID, Agreement start date, Agreement end date, Wholesale price |
| Agreement Started – Private offer | Acceptance of an AWS Marketplace Channel Partner private offer starts the agreement for a contract or subsciption product. | AWS Marketplace Channel Partner | An AWS Marketplace agreement has started. | Customer AWS account ID, ISV name, ISV AWS account ID, Product name, Product ID, Offer name, Offer ID, Agreement ID, Agreement start date, Agreement end date, Margin, Purchase amount |
| Agreement Canceled – private or public Offer | Cancellation of a private or public offer agreement. | ISV | An AWS Marketplace agreement was cancelled. | Customer AWS account ID, Product name, Product ID, Offer name, Offer ID, Agreement ID, Agreement start date, Agreement end date |
| Agreement Canceled – AWS Marketplace Channel Partner private offer | Cancellation of an AWS Marketplace Channel Partner private offer agreement. | ISV | An AWS Marketplace agreement was cancelled. | Customer AWS account ID, Channel partner, Channel partner AWS account ID, Product name, Product ID, Offer name, Offer ID, Agreement ID, Agreement start date, Agreement end date |
| Agreement Canceled – Channel Partner Private offer | Cancellation of an AWS Marketplace Channel Partner private offer agreement. | AWS Marketplace Channel Partner | An AWS Marketplace agreement was cancelled. | Customer AWS account ID, ISV, ISV AWS account ID, Product name, Product ID, Offer name, Offer ID, Agreement ID, Agreement start date, Agreement end date |
| Compliance Failure – Seller of Record | An AWS Marketplace agreement fails because of a customer payment failure. | ISV or AWS Marketplace Channel Partner that created the offer | Action required: AWS Marketplace Agreement Creation Failure | Subscribing AWS account ID, Product name, Product ID, Offer name, Offer ID, Agreement ID |
| Payment Failure – Seller of Record | An AWS Marketplace agreement fails because of a customer payment failure. | ISV or AWS Marketplace Channel Partner that created the offer | Payment failure for an AWS Marketplace agreement | Customer AWS account ID, Product name, Product ID, Offer name, Offer ID, Agreement ID |
| Agreement Replaced – Private offer | An AWS Marketplace agreement is replaced by another agreement. | ISV | An AWS Marketplace agreement has been replaced | Company name, Customer AWS account ID, Product name, Product ID, Offer name, Offer ID, New agreement ID, Agreement start date, Agreement end date, New purchase amount |
| Agreement Replaced – Channel Partner Private offer | An AWS Marketplace agreement is replaced by another agreement. | ISV | An AWS Marketplace agreement has been replaced | Company name, Customer AWS account ID, Channel partner, Channel partner AWS account ID, Product name, Product ID, Offer name, Offer ID, New agreement ID, Agreement start date, Agreement end date, Wholesale price |
| Agreement Replaced – Channel Partner Private offer | An AWS Marketplace agreement is replaced by another agreement. | AWS Marketplace Channel Partner | An AWS Marketplace agreement has been replaced | Company name, Customer AWS account ID, ISV name, ISV AWS account ID, Product name, Product ID, Offer name, Offer ID, New agreement ID, Agreement start date, Agreement end date, Wholesale price, Margin, New purchase amount |
### Variable payments
Sellers and buyers will receive email notifications related to their use of variable payments on professional services private offers. For more information about variable payments, see [Pricing professional service products in AWS Marketplace](proserv-variable-payments.md).
| Email | Event | Recipient | Title | Fields |
| --- | --- | --- | --- | --- |
| Payment Request - Approved | Payment approval | Seller | AWS Marketplace payment request was approved | Customer AWS Account ID, Payment Request Acceptance Date, Offer ID, Agreement ID, Payment request ID, Payment request amount, Payment request currency code |
| Payment Request - Declined | Payment rejection | Seller | AWS Marketplace payment request was declined | Customer AWS Account ID, Payment Request Rejection Date, Offer ID, Agreement ID, Payment request ID, Payment request amount, Payment request currency code |
| Payment request - Auto approval | Auto approval: Payment creation \$1 reminder (email sent 1, 3, 7, 9 days after payment request creation) | Buyer | You received an AWS Marketplace payment request | Auto Approval Date, Offer ID, Agreement ID, Payment request ID, Payment request created date, Payment request amount, Payment request currency code |
| Payment request - Manual approval | Manual approval: Payment creation \$1 reminder (email sent every 7 days until contract date) | Buyer | You received an AWS Marketplace payment request | Offer ID, Agreement ID, Payment request ID, Payment request created date, Payment request amount, Payment request currency code |
| Payment Request - Canceled | Payment Canceled | Buyer | Your AWS Marketplace payment request was canceled by the seller | Offer ID, Agreement ID, Payment request canceled date, Payment request ID, Payment request amount, Payment request currency code |
### Disbursements
ISVs and Channel Partners receive an email notification if their disbursement is paused due to invalid bank account details.
| Email | Event | Recipient | Title | Fields |
| --- | --- | --- | --- | --- |
| Disbursement Paused – Invalid Bank Account Information | AWS Marketplace pauses disbursements to seller due to invalid bank account details. | ISV and AWS Marketplace Channel Partner | Disbursement Paused | Resource ARN |
The `Resource ARN` field shows the invalid bank account Amazon Resource Number (ARN). You can fix this issue by [adding the bank account](#add-bank-account-details) in the AWS Marketplace Management Portal (AMMP).
### Adding bank account details
Add bank account details in the AWS Marketplace Management Portal (AMMP) to fix invalid bank account ARN errors in disbursements.
The `Resource ARN` field displays the ARN of the invalid bank account. To fix the issue, add the bank account in the AWS Marketplace Management Portal. The following steps explain how.
**To add bank account details**
1. Sign in to the [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/) with your AWS Marketplace seller account.
1. On the menu bar, choose **Settings**.
1. Choose the **Payments information** tab.
1. In the **Bank accounts** section, choose **Add bank account**.
1. Add the bank account details and review them for accuracy. For more information, see [Step 3: Provide bank account information](provide-bank-information.md) earlier in this guide.
1. To receive payments from buyers, under **Disbursement methods**, choose **Add disbursement method**.
1. If prompted to verify Know Your Customer (KYC) and bank account, follow the verification steps.
1. Save your changes.
### 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.
## Field descriptions
The following table shows descriptions of the fields referred to in the [Offers and Offer Sets](#email-details-offers) and [Agreements](#email-details-agreements) tables.
| Field | Description |
| --- | --- |
| Customer company name | Name of the subscriber's company. |
| Customer AWS account ID | ID of the AWS account subscribed to the product. |
| ISV name | Seller business name. |
| ISV AWS account ID | ID of the seller's AWS account. |
| Product name | Title of the product. |
| Product ID | Friendly, unique identifier for the software product. |
| Offer name | Title of the offer. |
| Offer ID | Identifier of the offer that the buyer signed. |
| Offer visibility | Whether the offer is a public, private, or an enterprise contract offer. |
| Agreement ID | A unique agreement data feed reference for the agreement signed between a proposer and an accepter to start using a product. |
| Agreement start date | The date that the customer's product subscription starts, in the format `MM-DD-YYYY`. This date can be different than acceptance date for future dated agreements. |
| Agreement acceptance date | The date when the customer subscribed to the product, in the format `MM-DD-YYYY`. |
| Agreement end date | The date when the contract expires, formatted in the format `MM-DD-YYYY`. For metered or pay-as-you-go subscriptions, this date is set to `JAN-1-9999`. |
| Agreement end date | The date when the contract expires, formatted in the format `MM-DD-YYYY`. For metered or pay-as-you-go subscriptions, this date is set to `JAN-1-9999`. |
| Purchase amount | The estimated cost of the agreement, otherwise known as total contract value. This applies to SaaS, professional services, and server product types and contract or annual pricing types. |
| Channel partner company name | Name of the account that purchased a product or service at wholesale cost from an ISV to resell to a customer. |
| Channel partner AWS account ID | ID of the AWS account of the AWS Marketplace Channel Partner that purchased a product or service from an ISV to resell to a customer. |
| Wholesale price | The wholesale cost from an ISV to resell a product to the AWS Marketplace Channel Partner. |
| Currency code | The offer pricing currency associated with the estimated cost of the agreement. |
| New agreement ID | Agreement ID of a renewed or upgraded agreement. |
| Offer published date | Date when the seller published the offer. |
| Offer expiration date | Date when the offer expires. |
| Opportunity ID | Unique identifier for a registered opportunity. |
| Selling authorization duration | The length of time resellers are authorized to create offers using discounts, as specified in the selling authorization. |
## Manage notifications
The following topics explain how to manage email notifications for events.
### Adding or updating email addresses
You can add up to 10 email addresses for custom email notifications using the AWS Marketplace Management Portal.
**To add or update email addresses**
1. Sign in to the [AWS Marketplace Management Portal.](https://aws.amazon.com/marketplace/management/)
1. From **Settings**, choose the **Notifications** tab.
1. Under **Email for custom notifications**, choose **Add email address**.
1. For **Recipient details,** enter a custom email address in the **Email address** field.
1. (Optional) Choose **Add new recipients** to add another email address (up to 10 total).
1. Choose **Submit**.
### Unsubscribing recipients from notifications
You can remove an email address so the recipient is unsubscribed from custom email notifications.
**To unsubscribe recipients from event notifications**
1. Sign in to the [AWS Marketplace Management Portal.](https://aws.amazon.com/marketplace/management/)
1. From **Settings** choose the **Notifications** tab.
1. Under **Email for custom notifications**, choose **Update email address**.
1. For **Recipient details**, choose **Remove** to remove the email address.
1. Choose **Submit**.
**Note**
You can also unsubscribe using the link in the email.
# Amazon EventBridge events
As a seller, you can use Amazon EventBridge to receive notifications for events in AWS Marketplace. For example, you can receive an *event* from AWS Marketplace when an offer is created. The *event* contains details like the ID, expiration date, and product details. EventBridge is an event bus service that you can use to connect your applications with data from a variety of sources. For more information, see the [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html). The following sections provide detailed information about events under the Marketplace Catalog service in the EventBridge console.
**Topics**
+ [Events for new offers](#events-offerreleased)
+ [Events for change sets](#events-changesets)
+ [Events for security summary report](#events-security-report)
+ [Events for disbursements](#events-for-disbursements)
+ [Events for agreements](#events-for-agreements)
+ [Events for licenses](#events-for-licenses)
+ [Events for cancellations](#events-for-cancellations)
+ [Events for billing adjustments](#events-for-billing-adjustments)
This topic
| Action by seller | Event received | Related topic |
| --- | --- | --- |
| Independent software vendor (ISV) creates an offer and makes it available for purchase | Offer Released | [Events for new offers](#events-offerreleased) |
| ISV's product is used by a channel partner to create an offer | Offer Released | [Events for new offers](#events-offerreleased) |
| Channel partner creates an offer | Offer Released | [Events for new offers](#events-offerreleased) |
| ISV creates a new offer set | OfferSet Released | [Events for new offers](#events-offerreleased) |
| Channel partner creates a new offer set | OfferSet Released | [Events for new offers](#events-offerreleased) |
| Change set succeeds | Change Set Succeeded | [Events for change sets](#events-changesets) |
| Change set fails | Change Set Failed | [Events for change sets](#events-changesets) |
| Change set is cancelled | Change Set Cancelled | [Events for change sets](#events-changesets) |
| Security vulnerabilities were detected on the ISV's product | Products Security Report Created | [Events for security summary report](#events-security-report) |
| Customer subscribes to SaaS product | Purchase Agreement Created | [Events for agreements](#events-for-agreements) |
| Customer's SaaS agreement is amended | Purchase Agreement Amended | [Events for agreements](#events-for-agreements) |
| Customer cancels SaaS subscription | Purchase Agreement Ended | [Events for agreements](#events-for-agreements) |
| Customer's SaaS entitlements change | License Updated | [Events for licenses](#events-for-licenses) |
| Customer's SaaS entitlements are revoked | License Deprovisioned | [Events for licenses](#events-for-licenses) |
| Seller submits a cancellation request | Agreement Cancellation Request Pending Approval - Proposer | [Events for cancellations](#events-for-cancellations) |
| Cancellation request is approved or auto-approved | Agreement Cancellation Request Approved - Proposer | [Events for cancellations](#events-for-cancellations) |
| Cancellation request is denied by buyer | Agreement Cancellation Request Rejected - Proposer | [Events for cancellations](#events-for-cancellations) |
| Seller withdraws a cancellation request | Agreement Cancellation Request Cancelled - Proposer | [Events for cancellations](#events-for-cancellations) |
| Cancellation request fails validation | Agreement Cancellation Request Validation Failed - Proposer | [Events for cancellations](#events-for-cancellations) |
| Billing adjustment is processed | Purchase Agreement Billing Adjustment Completed - Proposer | [Events for billing adjustments](#events-for-billing-adjustments) |
| Billing adjustment fails validation | Purchase Agreement Billing Adjustment Failed - Proposer | [Events for billing adjustments](#events-for-billing-adjustments) |
## Events for new offers
When sellers create an offer and make it available for purchase, they can receive an event with the following detail type: `Offer Released`.
**Note**
For information on creating EventBridge rules, see [Amazon EventBridge rules](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) in the *Amazon EventBridge User Guide*.
The following is an example event body for a new offer created by an ISV.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Offer Released",
"source": "aws.marketplacecatalog",
"account": "123456789012",
"time": "2023-08-26T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/offer-1234567890123"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"offer": {
"id": "offer-1234567890123",
"arn": "arn:aws:catalog:us-east-1:123456789012:Offer/offer-1234567890123",
"name": "Offer Name",
"expirationDate": "2025-08-26T00:00:00Z"
},
"product": {
"id": "bbbbaaaa-abcd-1111-abcd-666666666666",
"arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666",
"title": "Product Title"
},
"manufacturer": {
"accountId": "123456789012",
"name": "Manufacturer Account Name"
},
"sellerOfRecord": {
"accountId": "123456789012",
"name": "Seller Account Name"
},
"targetedBuyerAccountIds": [
"999988887777",
"111122223333"
]
}
}
```
The following is an example event body for when an ISV's product is used by a channel partner to create an offer.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Offer Released",
"source": "aws.marketplacecatalog",
"account": "123456789012",
"time": "2023-08-26T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/Offer/offer-1234567890123"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"offer": {
"id": "offer-1234567890123",
"arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123",
"name": "Offer Name",
"expirationDate": "2025-08-26T00:00:00Z"
},
"product": {
"id": "bbbbaaaa-abcd-1111-abcd-666666666666",
"arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666",
"title": "Product Title"
},
"manufacturer": {
"accountId": "123456789012",
"name": "Manufacturer Account Name"
},
"sellerOfRecord": {
"accountId": "987654321098",
"name": "Seller Account Name"
},
"targetedBuyerAccountIds": ["999988887777", "111122223333"],
}
}
}
```
The following is an example event body for when a channel partner creates an offer.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Offer Released",
"source": "aws.marketplacecatalog",
"account": "987654321098",
"time": "2023-08-26T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/Offer/offer-1234567890123"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"offer": {
"id": "offer-1234567890123",
"arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123",
"name": "Offer Name",
"expirationDate": "2025-08-26T00:00:00Z"
},
"product": {
"id": "bbbbaaaa-abcd-1111-abcd-666666666666",
"arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666",
"title": "Product Title"
},
"manufacturer": {
"accountId": "123456789012",
"name": "Manufacturer Account Name"
},
"sellerOfRecord": {
"accountId": "987654321098",
"name": "Seller Account Name"
},
"targetedBuyerAccountIds": ["999988887777", "111122223333"],
}
}
}
```
The following is an example event body for a new offer set published by a partners (ISV or Channel partner).
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "OfferSet Released",
"source": "aws.marketplacecatalog",
"account": "123456789012",
"time": "2023-08-26T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/OfferSet/offerset-1234567890123"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"offerSet": {
"id": "offerset-1234567890123",
"arn": "arn:aws:catalog:us-east-1:987654321098:OfferSet/offerset-1234567890123",
"name": "Offer Set Name",
},
"associatedOffers": [
{
"offer": {
"id": "offer-1234567890123",
"arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123",
"name": "Offer Name",
}
},
...
]
}
}
```
## Events for change sets
When a change set completes, sellers, channel partners, and private marketplace administrators can receive an event. The AWS Marketplace Catalog API sends an event when a change set completes with a status of succeeded, failed, or cancelled. The source for these events is `aws.marketplacecatalog`, and the possible detail type values are `Change Set Succeeded`, `Change Set Failed`, and `Change Set Cancelled`.
**Note**
For information on change sets, see [Working with change sets](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#working-with-change-sets) in the *AWS Marketplace Catalog API Reference*.
Each event contains change request details, such as the change set ID, change set name, event detail type, failure code (for failed requests), and start and end times of the request. This enables you to monitor your change sets without continuously querying the `DescribeChangeSet` action or checking the AWS Marketplace Management Portal for the status of your change requests.
**Note**
For information on creating EventBridge rules, see [Amazon EventBridge rules](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) in the *Amazon EventBridge User Guide*.
The following is an example event body for the `Change Set Succeeded` detail type.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Change Set Succeeded",
"source": "aws.marketplacecatalog",
"account": "123456789012",
"time": "2022-11-01T13:12:22Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg"
],
"detail": {
"requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"Catalog": "AWSMarketplace",
"ChangeSetId": "76yesvf8y165pa4f98td2crtg",
"ChangeSetName": "Create my product",
"StartTime": "2018-02-27T13:45:22Z",
"EndTime": "2018-02-27T14:55:22Z"
}
}
```
The following is an example event body for the `Change Set Failed` detail type.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Change Set Failed",
"source": "aws.marketplacecatalog",
"account": "123456789012",
"time": "2022-11-01T13:12:22Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg"
],
"detail": {
"requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"Catalog": "AWSMarketplace",
"ChangeSetId": "76yesvf8y165pa4f98td2crtg",
"ChangeSetName": "Create my product",
"StartTime": "2018-02-27T13:45:22Z",
"EndTime": "2018-02-27T14:55:22Z",
"FailureCode": "CLIENT_ERROR"
}
}
```
The following is an example event body for the `Change Set Cancelled` detail type.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Change Set Cancelled",
"source": "aws.marketplacecatalog",
"account": "123456789012",
"time": "2022-11-01T13:12:22Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg"
],
"detail": {
"requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"Catalog": "AWSMarketplace",
"ChangeSetId": "76yesvf8y165pa4f98td2crtg",
"ChangeSetName": "Create my product",
"StartTime": "2018-02-27T13:45:22Z",
"EndTime": "2018-02-27T14:55:22Z"
}
}
```
## Events for security summary report
When security vulnerabilities are detected on a seller's products, they can receive a summary report event and periodic reminders for outstanding product issues. The source for these events is `aws.marketplacecatalog`, and the detail type is `Products Security Report Created`.
Each event includes a summary of the count of products and versions with detected issues, a count of how many latest versions are affected, and the date when resolution is required to prevent a temporary restriction of these products or versions.
**Note**
For information on creating EventBridge rules, see [Amazon EventBridge rules](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) in the *Amazon EventBridge User Guide*.
For details on managing security events, see the [How to improve the security of your product catalog in AWS Marketplace](https://aws.amazon.com/blogs/awsmarketplace/how-to-improve-security-your-product-catalog-aws-marketplace/) blog post on the *AWS Blog*.
The following is an example event body for the `Products Security Report Created` detail type.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Products Security Report Created",
"source": "aws.marketplacecatalog",
"account": "123456789012",
"time": "2023-10-31T00:00:00Z",
"region": "us-east-1",
"resources": [],
"detail": {
"numberOfProductsWithIssues": 1,
"numberOfVersionsWithIssues": 1,
"numberOfLatestVersionsWithIssues": 1,
"newIssuesFound": true,
"upcomingResolutionDueDate": "2023-12-01T00:00:00Z",
"requestId": "533fa17d-3e97-5051-bcaf-1fae45fb3f8b"
}
}
```
## Events for disbursements
When a disbursement to seller bank account fails due to invalid bank account details, AWS Marketplace ISVs and channel partners may receive an event.
In the following JSON event code, the `source` value for these events is `aws.marketplace`, and the `detail-type` value is `Disbursement Paused`. The `resources` value shows the invalid bank account Amazon Resource Number (ARN).
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Disbursement Paused",
"source": "aws.marketplace",
"account":"",
"time": "2022-11-01T13:12:22Z",
"region": "us-east-1",
"resources": ["arn:aws:payments:us-east-1:1234567890:paymentinstrument:123"],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace"
}
}
```
To resolve the invalid bank account details issue, add your bank account details in the AWS Marketplace Management Portal. For instructions, see [To add bank account details](email-notifications.md#resolve-invalid-bank-account-details).
For more information about creating Amazon EventBridge rules, see [Rules in Amazon EventBridge](https://docs.aws.amazon.com//eventbridge/latest/userguide/eb-rules.html) in the *Amazon EventBridge User Guide*.
## Events for agreements
When agreement events occur, sellers can receive notifications for purchase agreement lifecycle changes.
For information on creating EventBridge rules, see [Amazon EventBridge rules](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) in the *Amazon EventBridge User Guide*.
The following is an example event body for **Purchase Agreement Created - Proposer**.
**Note**
Resale Authorization Id in case of Channel Partner Private Offer (CPPO) will be populated, and in case of Marketplace direct offer (MPPO), this value would be null.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "Purchase Agreement Created - Proposer",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-4mwg1nevbokzw95eca5797ixs",
"intent": "NEW",
"status": "ACTIVE",
"acceptanceTime": "2024-06-26T21:36:03Z",
"startTime": "2024-08-30T21:36:03Z",
"endTime": "2025-05-30T21:36:03Z"
},
"resaleAuthorization": {
"id": "resaleauthz-yaxjqxiskysxa"
},
"acceptor": {
"accountId": "845735284135"
},
"proposer": {
"accountId": "123456512334"
},
"offer": {
"id": "offer-1234567890123"
}
}
}
```
The following is an example event body for **Purchase Agreement Created - Manufacturer**.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "Purchase Agreement Created - Manufacturer",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-4mwg1nevbokzw95eca5797ixs",
"intent": "NEW",
"status": "ACTIVE",
"acceptanceTime": "2024-06-26T21:36:03Z",
"startTime": "2024-08-30T21:36:03Z",
"endTime": "2025-05-30T21:36:03Z"
},
"resaleAuthorization": {
"id": "resaleauthz-yaxjqxiskysxa"
},
"acceptor": {
"accountId": "845735284135"
},
"proposer": {
"accountId": "123456512334"
},
"offer": {
"id": "offer-1234567890123"
}
}
}
```
The following is an example event body for **Purchase Agreement Amended - Proposer**.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "Purchase Agreement Amended - Proposer",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-4mwg1nevbokzw95eca5797ixs",
"intent": "AMEND",
"status": "ACTIVE",
"acceptanceTime": "2024-06-26T21:36:03Z",
"startTime": "2024-08-30T21:36:03Z",
"endTime": "2025-05-30T21:36:03Z"
},
"resaleAuthorization": {
"id": "resaleauthz-yaxjqxiskysxa"
},
"acceptor": {
"accountId": "845735284135"
},
"proposer": {
"accountId": "123456512334"
},
"offer": {
"id": "offer-1234567890123"
}
}
}
```
The following is an example event body for **Purchase Agreement Amended - Manufacturer**.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "Purchase Agreement Amended - Manufacturer",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-4mwg1nevbokzw95eca5797ixs",
"intent": "AMEND",
"status": "ACTIVE",
"acceptanceTime": "2024-06-26T21:36:03Z",
"startTime": "2024-08-30T21:36:03Z",
"endTime": "2025-05-30T21:36:03Z"
},
"resaleAuthorization": {
"id": "resaleauthz-yaxjqxiskysxa"
},
"acceptor": {
"accountId": "845735284135"
},
"proposer": {
"accountId": "123456512334"
},
"offer": {
"id": "offer-1234567890123"
}
}
}
```
The following is an example event body for **Purchase Agreement Ended - Proposer**.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "Purchase Agreement Ended - Proposer",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-4mwg1nevbokzw95eca5797ixs",
"status": "CANCELLED"
},
"resaleAuthorization": {
"id": "resaleauthz-yaxjqxiskysxa"
},
"acceptor": {
"accountId": "845735284135"
},
"proposer": {
"accountId": "123456512334"
},
"offer": {
"id": "offer-1234567890123"
}
}
}
```
The following is an example event body for **Purchase Agreement Ended - Manufacturer**.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "Purchase Agreement Ended - Manufacturer",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-4mwg1nevbokzw95eca5797ixs",
"status": "CANCELLED"
},
"resaleAuthorization": {
"id": "resaleauthz-yaxjqxiskysxa"
},
"acceptor": {
"accountId": "845735284135"
},
"proposer": {
"accountId": "123456512334"
},
"offer": {
"id": "offer-1234567890123"
}
}
}
```
## Events for licenses
When license events occur, sellers can receive notifications for customer entitlement changes.
For information on creating EventBridge rules, see [Amazon EventBridge rules](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) in the *Amazon EventBridge User Guide*.
The following is an example event body for **License Updated - Manufacturer**.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "License Updated - Manufacturer",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-4mwg1nevbokzw95eca5797ixs"
},
"product": {
"code": "aw4fgf5tyo5w2ap6fEXAMPLE",
"id": "prod-qtwveEXAMPLE"
},
"license": {
"arn": "aws:license-manager:us-east-1:123456789012:l-e52ca6f38bf84d0fafb8802ca15ac11x"
},
"acceptor": {
"accountId": "845735284135"
},
"proposer": {
"accountId": "123456512334"
},
"offer": {
"id": "8kkr91jo647j3qxlcjhlqce7y"
}
}
}
```
The following is an example event body for **License Deprovisioned - Manufacturer**.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "License Deprovisioned - Manufacturer",
"source": "aws.agreement-marketplace",
"account": "",
"time": "2024-08-30T21:36:03Z",
"region": "us-east-1",
"resources": [
"arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-4mwg1nevbokzw95eca5797ixs"
},
"product": {
"code": "aw4fgf5tyo5w2ap6fEXAMPLE",
"id": "prod-qtwveEXAMPLE"
},
"license": {
"arn": "aws:license-manager:us-east-1:123456789012:l-e52ca6f38bf84d0fafb8802ca15ac11x"
},
"acceptor": {
"accountId": "845735284135"
},
"proposer": {
"accountId": "123456512334"
},
"offer": {
"id": "8kkr91jo647j3qxlcjhlqce7y"
}
}
}
```
## Events for cancellations
When a cancellation request status changes, sellers, buyers, and ISVs (for CPPO) receive events. Each event is sent to the relevant party with a role-specific detail type (Proposer for sellers, Acceptor for buyers, Manufacturer for ISVs). The source for these events is `aws.agreement-marketplace`.
For information on creating EventBridge rules, see [Amazon EventBridge rules](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) in the *Amazon EventBridge User Guide*.
The following is an example event body for **Agreement Cancellation Request Pending Approval - Proposer**. This event is sent when you submit a cancellation request and it is awaiting buyer approval.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Agreement Cancellation Request Pending Approval - Proposer",
"source": "aws.agreement-marketplace",
"account": "123456789012",
"time": "2025-01-01T13:12:22Z",
"region": "us-east-1",
"resources": [],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-abcdexampleid",
"acceptorId": "123465789012",
"productId": "prod-exampleid",
"offerId": "offer-exampleid"
},
"agreementCancellationRequest": {
"id": "acr-abcdexampleid",
"reasonCode": "INCORRECT_TERMS_ACCEPTED",
"reasonMessage": "",
"statusCode": "PENDING_APPROVAL",
"statusMessage": "",
"createdAt": "2025-01-01T13:12:22Z",
"updatedAt": "2025-01-01T13:12:22Z"
}
}
}
```
The following is an example event body for **Agreement Cancellation Request Approved - Proposer**. This event is sent when the buyer approves your cancellation request or when it is auto-approved after 7 days.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Agreement Cancellation Request Approved - Proposer",
"source": "aws.agreement-marketplace",
"account": "123456789012",
"time": "2025-01-01T13:16:07Z",
"region": "us-east-1",
"resources": [],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-abcdexampleid",
"acceptorId": "123465789012",
"productId": "prod-exampleid",
"offerId": "offer-exampleid"
},
"agreementCancellationRequest": {
"id": "acr-abcdexampleid",
"reasonCode": "INCORRECT_TERMS_ACCEPTED",
"reasonMessage": "The terms accepted in agreement had wrong rate",
"statusCode": "APPROVED",
"statusMessage": "",
"createdAt": "2025-01-03T16:16:22Z",
"updatedAt": "2025-01-03T16:20:08Z"
}
}
}
```
The following is an example event body for **Agreement Cancellation Request Rejected - Proposer**. This event is sent when the buyer denies your cancellation request.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Agreement Cancellation Request Rejected - Proposer",
"source": "aws.agreement-marketplace",
"account": "123456789012",
"time": "2025-01-02T10:30:00Z",
"region": "us-east-1",
"resources": [],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-abcdexampleid",
"acceptorId": "123465789012",
"productId": "prod-exampleid",
"offerId": "offer-exampleid"
},
"agreementCancellationRequest": {
"id": "acr-abcdexampleid",
"reasonCode": "INCORRECT_TERMS_ACCEPTED",
"reasonMessage": "",
"statusCode": "REJECTED",
"statusMessage": "We still need this product",
"createdAt": "2025-01-01T13:12:22Z",
"updatedAt": "2025-01-02T10:30:00Z"
}
}
}
```
The following is an example event body for **Agreement Cancellation Request Cancelled - Proposer**. This event is sent when you withdraw a cancellation request.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Agreement Cancellation Request Cancelled - Proposer",
"source": "aws.agreement-marketplace",
"account": "123456789012",
"time": "2025-01-02T08:00:00Z",
"region": "us-east-1",
"resources": [],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-abcdexampleid",
"acceptorId": "123465789012",
"productId": "prod-exampleid",
"offerId": "offer-exampleid"
},
"agreementCancellationRequest": {
"id": "acr-abcdexampleid",
"reasonCode": "INCORRECT_TERMS_ACCEPTED",
"reasonMessage": "",
"statusCode": "CANCELLED",
"statusMessage": "Seller withdrew the request",
"createdAt": "2025-01-01T13:12:22Z",
"updatedAt": "2025-01-02T08:00:00Z"
}
}
}
```
The following is an example event body for **Agreement Cancellation Request Validation Failed - Proposer**. This event is sent only to the seller when an async validation fails after submission.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Agreement Cancellation Request Validation Failed - Proposer",
"source": "aws.agreement-marketplace",
"account": "123456789012",
"time": "2025-01-01T13:15:00Z",
"region": "us-east-1",
"resources": [],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-abcdexampleid",
"acceptorId": "123465789012",
"productId": "prod-exampleid",
"offerId": "offer-exampleid"
},
"agreementCancellationRequest": {
"id": "acr-abcdexampleid",
"reasonCode": "INCORRECT_TERMS_ACCEPTED",
"reasonMessage": "The terms accepted in agreement had wrong rate",
"statusCode": "VALIDATION_FAILED",
"statusMessage": "Agreement has a renewal agreement that must be canceled first",
"createdAt": "2025-01-01T13:12:22Z",
"updatedAt": "2025-01-01T13:15:00Z"
}
}
}
```
## Events for billing adjustments
When a billing adjustment status changes, sellers, buyers, and ISVs (for CPPO) receive events. Each event is sent to the relevant party with a role-specific detail type (Proposer for sellers, Acceptor for buyers, Manufacturer for ISVs). The source for these events is `aws.agreement-marketplace`.
The following is an example event body for **Purchase Agreement Billing Adjustment Completed - Proposer**.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Purchase Agreement Billing Adjustment Completed - Proposer",
"source": "aws.agreement-marketplace",
"account": "123456789012",
"time": "2025-01-01T13:12:22Z",
"region": "us-east-1",
"resources": [],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-abcdexampleid"
},
"billingAdjustmentRequest": {
"id": "ba-abcdexampleid",
"adjustmentAmount": "-100.00",
"currencyCode": "USD",
"adjustmentReasonCode": "INCORRECT_TERMS_ACCEPTED"
},
"invoice": {
"originalInvoiceId": "2028746221"
}
}
}
```
The following is an example event body for **Purchase Agreement Billing Adjustment Failed - Proposer**. This event is sent only to the seller when a billing adjustment fails async validation.
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Purchase Agreement Billing Adjustment Failed - Proposer",
"source": "aws.agreement-marketplace",
"account": "123456789012",
"time": "2025-01-01T13:15:00Z",
"region": "us-east-1",
"resources": [],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace",
"agreement": {
"id": "agmt-abcdexampleid"
},
"billingAdjustmentRequest": {
"id": "ba-abcdexampleid",
"adjustmentAmount": "-1000.00",
"currencyCode": "USD",
"adjustmentReasonCode": "INCORRECT_TERMS_ACCEPTED"
},
"invoice": {
"originalInvoiceId": "2028746221"
}
}
}
```