AWS marketplace documentation change
Summary
Minor wording changes and grammatical improvements throughout the document, including replacing 'API operation' with 'API', adjusting capitalization of 'operations team', and rephrasing sentences for clarity.
Security assessment
The changes are editorial improvements without introducing or modifying security-related content. No references to vulnerabilities, security controls, or incident response are present in the diff.
Diff
diff --git a/marketplace/latest/userguide/saas-integrate-contract.md b/marketplace/latest/userguide/saas-integrate-contract.md index c2acb9cc8..a8b014f7e 100644 --- a//marketplace/latest/userguide/saas-integrate-contract.md +++ b//marketplace/latest/userguide/saas-integrate-contract.md @@ -32 +32 @@ When a customer subscribes to your product, they are redirected to your registra - 1. Exchange the token for a `CustomerIdentifier`, `CustomerAWSAccountId`, and `ProductCode` by calling the `[ ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)` API operation in the AWS Marketplace Metering Service __. + 1. Exchange the token for a `CustomerIdentifier`, `CustomerAWSAccountId`, and `ProductCode` by calling the `[ ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)` API in the AWS Marketplace Metering Service __. @@ -51 +51 @@ When a customer makes a request to your service, you must respond to the followi - * They do have a customer ID, but the `GetEntitlements` API operation returns no entitlement, or not enough quantity to fulfill the request. In this scenario, you must determine how to handle access and manage their experience. + * They have a customer ID, but the `GetEntitlements` API operation returns no entitlement, or not enough quantity to fulfill the request. In this scenario, you must determine how to handle access and manage their experience. @@ -58 +58 @@ When a customer makes a request to your service, you must respond to the followi -Set up an Amazon Simple Queue Service (Amazon SQS) queue, and subscribe to your product's Amazon SNS topic. Your SNS topic information was included in the email message that you received from the AWS Marketplace Operations Team when you created your product. For more information, see [Creating a SaaS product in AWS Marketplace](./saas-create-product.html). By subscribing to your SNS topic, you receive notifications about changes to customer entitlements, including providing or revoking access for specific customers. +Set up an Amazon Simple Queue Service (Amazon SQS) queue, and subscribe to your product's Amazon SNS topic. Your SNS topic information was included in the email message that you received from the AWS Marketplace operations team when you created your product. For more information, see [Creating a SaaS product in AWS Marketplace](./saas-create-product.html). By subscribing to your SNS topic, you receive notifications about changes to customer entitlements, including providing or revoking access for specific customers. @@ -66 +66 @@ The only notification that you must respond to is: - * `entitlement-updated` – The customer entitlement has changed, and you must call the `GetEntitlements` API operation to see the new status. Update your customer store, and, if applicable (for example, the customer's contract has lapsed), follow your practices for shutting down customer resources, adhering to your retention policies. + * `entitlement-updated` – The customer entitlement has changed, and you must call the `GetEntitlements` API to see the new status. Update your customer store, and, if applicable (for example, the customer's contract has lapsed), follow your practices for shutting down customer resources, adhering to your retention policies. @@ -81 +81 @@ After you've integrated your SaaS contract product with AWS Marketplace, you mus -Use your own accounts to subscribe to your product and test that the integration is successful. Prices can be temporarily reduced so that you can test the purchase flow without incurring high charges in those accounts. For more information about temporarily reducing the prices or allowing additional test accounts to access your product, [contact us](https://aws.amazon.com/marketplace/management/contact-us/). +Use your own accounts to subscribe to your product and test the integration. You can temporarily reduce prices in order to test the purchase flow without incurring high charges in those accounts. For more information about temporarily reducing the prices or allowing additional test accounts to access your product, [contact us](https://aws.amazon.com/marketplace/management/contact-us/). @@ -83 +83 @@ Use your own accounts to subscribe to your product and test that the integration -After your product is launched, the service must continue to respond to these scenarios for new customers. +After you launch your product, the service must continue to respond to these scenarios for new customers. @@ -91 +91 @@ After your product is launched, the service must continue to respond to these sc - 4. If no entitlement is returned from the `GetEntitlements` API operation, either during onboarding or in your ongoing verification passes, your application must correctly manage access and the experience for users who are not entitled. This tests Scenario: Your service handles customer requests. + 4. If the `GetEntitlements` API doesn't return an entitlement, either during onboarding or in your ongoing verification passes, your application must correctly manage access and the experience for users who are not entitled. This tests Scenario: Your service handles customer requests. @@ -95 +95 @@ After your product is launched, the service must continue to respond to these sc - 6. After you have completed all the integration requirements and tested the solution, notify the AWS Marketplace Operations team. They will then test the solution by verifying that you have successfully called the `GetEntitlements` API operation and sufficiently onboarded new customers. + 6. After you complete all the integration requirements and test the solution, notify the AWS Marketplace operations team. They will then test the solution by verifying that you have successfully called the `GetEntitlements` API operation and sufficiently onboarded new customers. @@ -100 +100 @@ After your product is launched, the service must continue to respond to these sc -After your integration and testing is complete, you can perform a final review and list your product on the public AWS Marketplace. For more information, see [Creating a SaaS product in AWS Marketplace](./saas-create-product.html). You can also cancel your test subscription by completing a Refund Request Form. For more information on cancelling a subscription, see the [Requesting a product refund](./refunds.html#refund-process). +After you complete integration and testing, you can perform a final review and list your product on the public AWS Marketplace. For more information, see [Creating a SaaS product in AWS Marketplace](./saas-create-product.html). You can also cancel your test subscription by completing a Refund Request Form. For more information on cancelling a subscription, see the [Requesting a product refund](./refunds.html#refund-process).