Errors
ORDER_ALREADY_PLACED
ORDER_ALREADY_PLACED
A duplicate place request was received for an order that has already been accepted by the merchant. This is the conflict signal returned when an idempotency key matches a prior successful submission with a non-matching body, or when the underlying cart is already attached to a placed order.
Reserved error code — not currently emitted by any endpoint. Partners may begin handling it defensively; backend will start emitting once wired in.
Summary
| Field | Value |
|---|---|
| HTTP status | 409 |
errorCategory | conflict |
retryable | false |
When This Fires
POST /v1/marketplace/orders/place— the suppliedIdempotency-Keywas previously used for a different request body, or the cart referenced has already been turned into a placed order.
A clean retry with the same idempotency key and the same body returns the original successful response, not this error. This error indicates the bodies diverged.
Recommended Action
Do not retry. Treat the user's order as already placed:
- Read the prior order via
GET /v1/marketplace/orders/{orderId}(the originalplaceresponse held theorderId). - Surface the existing order's status to the user — confirmation page, tracking link, etc.
- If the user genuinely wants a second order, start a fresh cart (new
Idempotency-Key).
A blind retry with the same key will continue to return 409.
Example
Code