
# Cancelar la transacción de inicio de sesión actual

`POST /fapi/v1/transactions/current:cancel` · llamado desde el host de inicio de sesión del entorno

Cancela la transacción actual. La transacción pasa al estado `failed` y se elimina la cookie de transacción.

## Solicitud

Encabezados:

| Encabezado | Obligatorio | Descripción |
| --- | --- | --- |
| `Idp-Client` | sí | Identificador del SDK. |
| `Origin` | sí | Debe ser exactamente `https://<sign-in host>`. |
| `Idp-Csrf-Token` | sí | El `csrf_token` del objeto de transacción. |

Sin cuerpo.

## Respuesta

`200 OK` con la transacción cancelada.

## Transacciones sin interfaz vinculadas a DPoP

Para una transacción iniciada con un encabezado `DPoP`, envíe una nueva prueba con la misma clave (`htm` `POST`, `htu` esta URL)
en lugar de `Idp-Csrf-Token`.

## Errores

| Estado | Código | Cuándo |
| --- | --- | --- |
| 403 | `origin_not_allowed` | `Origin` o `Idp-Csrf-Token` faltan o son incorrectos. |
| 409 | `transaction_state_conflict` | La transacción ya no se puede cancelar. |
| 410 | `transaction_expired` | La transacción ha finalizado. |
| 401 | `invalid_dpop_proof` | La prueba `DPoP` no es válida o se ha reutilizado. |

## Ejemplo

```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
```
