# Annulla la transazione di accesso corrente

`POST /fapi/v1/transactions/current:cancel` · chiamato dall'host di accesso dell'ambiente

Annulla la transazione corrente. La transazione passa allo stato `failed` e il cookie della transazione viene rimosso.

## Richiesta

Header:

| Header | Obbligatorio | Descrizione |
| --- | --- | --- |
| `Idp-Client` | sì | Identificatore dell'SDK. |
| `Origin` | sì | Deve essere esattamente `https://<sign-in host>`. |
| `Idp-Csrf-Token` | sì | Il `csrf_token` dell'oggetto transazione. |

Nessun body.

## Risposta

`200 OK` con la transazione annullata.

## Transazioni headless vincolate a DPoP

Per una transazione avviata con un header `DPoP`, invia una nuova prova dalla stessa chiave (`htm` `POST`, `htu` questo URL)
al posto di `Idp-Csrf-Token`.

## Errori

| Stato | Codice | Quando |
| --- | --- | --- |
| 403 | `origin_not_allowed` | `Origin` o `Idp-Csrf-Token` manca o è errato. |
| 409 | `transaction_state_conflict` | La transazione non può più essere annullata. |
| 410 | `transaction_expired` | La transazione è terminata. |
| 401 | `invalid_dpop_proof` | La prova `DPoP` non è valida o è stata riutilizzata. |

## Esempio

```bash
curl -X POST https://example.keenauth.app/fapi/v1/transactions/current:cancel \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -H "Idp-Csrf-Token: $CSRF_TOKEN" \
  -b cookies.txt
```