Troubleshoot Return 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 describes errors that you can encounter when you Process Returns.
Errors getting reversal offers
The following errors can occur when you call the reversalOffers query.
| Error Type | Error Code | Description | Suggested Action |
|---|---|---|---|
AccessDeniedError | N/A | You don't have sufficient access to perform this action. | Ensure that your access token has permission to access this information, and retry the call. For details, see Authenticate to the Buy with Prime API. |
InternalServerError | N/A | Unexpected error during request processing. | None. This is a server-side error. |
ThrottlingError | N/A | User made too many requests to the Buy with Prime API. | Send the request again using exponential backoff. |
ValidationError | ItemDoesNotExist | The requested item doesn't exist in your Buy with Prime catalog. | Ensure that the requested item is in your catalog. |
Errors adding and updating external returns
The following errors can occur when you call the updateOrder to add or update an external return in an order.
| Error Type | Error Code | Description | Suggested Action |
|---|---|---|---|
AccessDeniedError | N/A | You don't have sufficient access to perform this action. | Ensure that your access token has permission to access this information, and retry the call. For details, see Authenticate to the Buy with Prime API. |
InternalServerError | InternalServerError | Unable to determine return eligibility. | None. This is a server-side error. |
InternalServerError | InternalServerError | Unable to determine return policy. | None. This is a server-side error. |
InternalServerError | InternalServerError | Unable to determine return reasons. | None. This is a server-side error. |
InternalServerError | InternalServerError | Unexpected error during request processing. | None. This is a server-side error. |
ThrottlingError | N/A | User made too many requests to the Buy with Prime API. | Send the request again using exponential backoff. |
ValidationError | AliasLimitExceeded | You provided more than two aliases for a return. | Ensure that you provide at most two aliases for a return. |
ValidationError | AliasValueAlreadyExists | You provided an aliasId that is already associated with another return for the same order. | Ensure that the aliasId that you provide for a return isn't already associated with other returns present in the order. |
ValidationError | DuplicateAliasId | You attempted to add or update multiple returns within the same request, and one or more returns have the same aliasId. | Ensure that the aliasId that you provide for a return is unique. |
ValidationError | InvalidInput | Unable to determine return eligibility. | The input for return eligibility is not valid. Submit the request again with a valid return eligibility value. |
ValidationError | InvalidInput | Unable to determine return policy. | The input for return policy is not valid. Submit the request again with a valid return policy value. |
ValidationError | InvalidInput | Unable to determine return reasons. | The input for return reasons is not valid. Submit the request again with a valid return reasons value. |
ValidationError | InvalidReturnId | Not a valid return ID or alias. | Make sure that the return ID or alias that you provide is valid and that you provide either a return ID or an alias, not both. |
ValidationError | InvalidReturnInput | The total item quantity for the product is not returnable or is greater than the quantity purchased. | The input for item quantity is not valid. Submit the request again with a valid item quantity value. |
ValidationError | ProductIsNotReturnable | Selected units are non-returnable or have already been returned. | The product is not returnable (such as hazardous goods) or the product is not in a returnable state. Please remove the product and submit the request again. |
Related topics
Updated 1 day ago