Making idempotency keys more resiliant

📘

Executive Summary

Our Create Order endpoint may return the 425 Too Early status code when using an idempotency key (a feature designed to prevent duplicate orders). Your system should handle this status code in an appropriate way.

Changes

We recently discovered a case where duplicate orders could be made even when using Idempotency Keys.

After investigation, our engineers have resolved this issue. As a result, calls to our Create Order endpoint may return the 425 Too Early status code if a follow-up request is made before the original request has been processed.

If your system sends idempotency keys and receives this status code, it indicates to either wait for the initial request to return or that the request should be retried as-is a short while later. When retrying the request a short while later, your system should receive the correct response.

If you have any questions, please reach out to [email protected].