Skip to main content
Every error has a stable code, an HTTP status, and a message. Codes are never renamed. Both MCP and REST return the same codes. MCP errors are in the error field of the tool result. REST errors are in the JSON body:

Auth

A key that was sent but is wrong is always invalid_key, never unauthorized.

Rate and cap

The 429 response includes a Retry-After header. The body includes retry_after_seconds. daily_limit_reached also includes used_today and daily_cap (MCP) or usedToday and dailyCap (REST).

Session

Catalog

Cart

Sign-in

challenge_required is returned as a successful result with status: "challenge_required". It means sign-in started but needs a second factor.

Checkout

Commit

These codes come from complete_checkout. They determine whether the order was placed.
commit_unknown means the order submission may have reached the merchant. Do not call complete_checkout again. Call get_order to check the outcome.

Order


Codes are stable. New codes may be added, but existing codes are never renamed or removed.