> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel a checkout authorization

> Abandon a paused merchant request before the user's device has started sending the card.

Call it when your agent gives up on a checkout while the authorization is still `awaiting_approval`. The authorization becomes `declined` with reason `merchant_request_aborted` and the user's approval link stops working. Idempotent: cancelling a cancelled authorization answers `200`.

<ParamField path="id" type="string" required>The authorization id.</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.agentcard.sh/api/v2/checkout/authorizations/cauth_2q9d1x8f3k2m4t7w/cancel \
    -H "Authorization: Bearer $ORG_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "cauth_2q9d1x8f3k2m4t7w",
    "status": "declined",
    "reason": "merchant_request_aborted",
    "cancelled": true,
    "processor_request_started": false
  }
  ```
</ResponseExample>

**Errors.** `409 outcome_unknown`: the user's device already started sending the card, so the authorization can no longer be cancelled. Resolve its existing outcome (read it, confirm with the merchant) before another attempt. `404 not_found`: unknown id, or an authorization created by another client.