📘

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.

Sign Up

When you process a Buy with Prime refund request, you call the updateOrder mutation and include as much information as possible about the refund. This topic provides best practices for processing refunds.

For troubleshooting information, see Troubleshoot Refund Errors and Troubleshoot Order Errors.

Processing refunds

Sign up to receive Buy with Prime events. When you receive a REFUND_REQUESTED event, process the event by using Steps to Process Refunds.

Providing refund IDs

When you provide refund details to updateOrder, you provide refund IDs in RefundDetailsInput. Heed the following best practices to avoid errors providing refund IDs.

• To avoid a MissingRefundId error, you must provide a refund ID to updateOrder.
• To avoid an InvalidRefundId error, the refund ID that you provide to updateOrder must be the exact id from the refunds.details field returned from a REFUND_REQUESTED event or the order query.
• To avoid a DuplicateRefundId error, the refund ID that you provide to updateOrder must be unique across elements in the refunds.details list for a single call to updateOrder.

Related topics

• Refund Interface
• Troubleshoot Refund Errors
• Troubleshoot Order Errors