review_changed
The checkout review changed between the last read and the commit. Nothing was placed.
reason tells you the first thing that moved. changes lists every field that differs.
Recovery: read the new review (it’s in the error response), present it to the shopper, and call
complete_checkout with the new review_hash and total_minor.
review_mismatch
The review_hash you sent does not match the live review. Nothing was placed.
get_checkout, use the new review_hash and total_minor, and try again.
total_mismatch
The total_minor you sent does not match the live review. Nothing was placed.
review_mismatch. Call get_checkout and use the latest figures.
commit_unknown
The order was submitted to the merchant, but no confirmation came back. This is the most critical error.
- Call
get_orderwith the orderidfrom the session. - If the order exists and is confirmed, you’re done.
- If the status is
unknown, wait. AgentMall checks with the merchant and updates the status. - Never call
complete_checkoutagain for this session.
out_of_stock
Returned by create_checkout when an item was removed by the merchant.
update_cart, then call create_checkout again. If unavailable_items is missing, call get_cart to see what’s left.
cart_clear_failed
The cart clear stopped partway through. Some items were removed, some were not.
update_cart again. It will retry the clear.
checkout_not_ready
A temporary condition. The checkout page did not load in time.
sign_in_required
Returned by create_checkout when the merchant session is not signed in.
sign_in with encrypted credentials, then try create_checkout again. Or pass an address directly on update_checkout to check out as a guest.
totals_unstable
The checkout total could not be verified against the line breakdown.
General guidance
- Always use the latest
review_hash. After anyupdate_checkoutorget_checkout, the hash changes. - Show the review to the shopper before calling
complete_checkout. The review is the source of truth. - Never retry after
commit_unknown. This is the one error where retrying can cause real harm. - Check
get_cartafter ambiguous errors. When the error doesn’t tell you exactly what’s in the cart, read it.