Clear an authorisation (post the purchase)

POST/authorizations/{id}/clear

Path parameters

idstringRequired

Headers

Idempotency-KeystringOptional

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

amountintegerRequired

Returns

200 OK

The Authorization object.

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503

Request

curl -X POST 'https://api.dev.bank.corgi.com/authorizations/{id}/clear' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 10000
  }'

Response200

{
  "amount": 10000,
  "authorized_positive": false,
  "card_id": "card_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "cleared_amount": 10000,
  "draw_id": "string",
  "expires_at": "2026-09-17T14:30:00Z",
  "id": "auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "journal_id": "jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "kind": "string",
  "merchant_id": "string",
  "network": "string",
  "original_network_ref": "string",
  "overdraft_decision_id": "string",
  "reason": "string",
  "requested_amount": 10000,
  "response_code": "string",
  "status": "string"
}