> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.com/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`.

**id** `string` *required*

The authorization id.

```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 '{}'
```

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

**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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.