Solicit feedback for an order

Learn how to use the the Solicitations API to solicit a product review and seller feedback for an order. You first verify that an order is available for solicitation, then create the solicitation request.

Prerequisites

To complete this tutorial, you need:

• An order available for solicitation.
• Authorization from the selling partner for whom you are making calls. For more information, refer to Authorizing Selling Partner API applications.
• The Buyer Solicitation role or Product Listing role assigned to your developer profile.
• The Buyer Solicitation role or Product Listing role selected in the app registration page for your application.

Step 1. Verify that an order is available for solicitation

Call the getSolicitationActionsForOrder operation.

Step 2. Create a product review solicitation

If the productReviewAndSellerFeedback action is listed in the response, call the createProductReviewAndSellerFeedbackSolicitation operation.

Best practices

When you solicit reviews, ensure that you:

• Seek reviews for orders that have been delivered.
• Prompt for feedback within the allowed time frame.

Note that you cannot:

• Selectively seek positive reviews.
• Request alterations to existing reviews.
• Offer rewards or incentives for reviews.

For more information on how to ethically navigate solicitations, review the Anti-Manipulation Policy for Customer Reviews.

Turn negative feedback into opportunities

When you receive negative reviews, your effort to resolve the buyer's issue can change the narrative. Once you have resolved the buyer's problem, call the createNegativeFeedbackRemoval operation from the Messaging API. Sellers can use this operation to ask the buyer to remove the unfavorable feedback. This offers sellers a second chance and underscores their commitment to customer satisfaction.