Troubleshoot Refund Errors

📘

Buy with Prime API is now available for early access

Sign up for early access to the Buy with Prime API using the 'Sign Up' button below. The API may change as Amazon receives feedback and iterates on it.

This topic explains possible errors that you can encounter when you update an order's refund information by using the updateOrder mutation.

Errors updating refunds

When you update a refund by using the updateOrder mutation, you provide information in the refunds field. You might encounter the following errors associated with this field.

Error TypeError CodeDescriptionSuggested Action
ValidationErrorDuplicateRefundIdYou provided the same refund ID multiple times in the RefundInput.Update a given refund only once in a single API call.
ValidationErrorInvalidRefundIdThe provided Buy with Prime refund ID doesn't match any refund IDs for the specified order.Provide a valid Buy with Prime refund ID. To find the refund IDs associated with an order, call the order query. For details, see Query a Buy with Prime Order.
ValidationErrorInvalidRefundStateTransitionThe existing refund state can't transition to the state that you provided in the refunds.details.state field of the updateOrder mutation.Provide a valid refund state. For details about how to process refunds, see Steps to Process Refunds .
ValidationErrorMissingRefundIdNo Buy with Prime refund ID is present in the RefundInput.Provide a valid Buy with Prime refund ID.

Related topics