abandon_request

Fix code indicating the request cannot succeed and should be abandoned entirely.

What this means

The Commerce API has determined that your requested operation is fundamentally impossible given the current system state or immutable business rules, and no amount of retrying, parameter modification, or waiting will make it succeed. This fix code appears when you're attempting something that violates core constraints of the platform—for example, trying to cancel an order when that order has already been completed and reached a terminal state, or attempting to modify a payment that has already been captured and is now immutable for compliance and auditing reasons. Unlike change_request_parameters where correcting values enables success, or satisfy_precondition where completing prerequisites allows progress, abandon_request signals that the operation you're attempting is categorically impossible.

When you encounter this fix code, examine your application logic to understand why you're attempting an invalid operation—you may have incorrect assumptions about object states, or you might need to redesign your workflow to account for the constraints the Commerce API enforces. The appropriate response is to stop retrying this specific request and either accept that the operation cannot be performed or find an alternative approach to achieve your business objective.

Example error response

{
  "error": {
    "type": "invalid_request_parameter",
    "cause": "precondition_unmet",
    "code": "1812",
    "message": "operation not allowed",
    "detail": "Cannot cancel order `or_abc123` because it has already been completed. Orders in terminal states cannot be modified.",
    "fix_code": "abandon_request",
    "url": "https://commerce.zebo.dev/e/1812"
  }
}

Related errors

• unknown_error - May result in abandon fix code