Saltar al contenido principal
POST
curl
Cuando anulas un paso con defer_until_flow_finishes: true mientras la persona sigue en el flujo, la anulación queda en espera y se aplica cuando el flujo termina. Cancélala aquí si ya no quieres que se aplique. La comprobación conserva su estado actual. La cancelación queda registrada en la actividad de la sesión como FEATURE_OVERRIDE_CANCELLED y no se envía ningún webhook. La respuesta es la anulación con state: cancelled y cancel_reason: cancelled_by_reviewer.

Buscar el ID de la anulación

Usa el id del objeto override que devuelve Actualizar el estado de una función, o lista las anulaciones de la sesión con Listar anulaciones de funciones y elige una cuyo state sea pending_until_flow_finishes.

Cuando la cancelación falla

Una anulación que ya se aplicó o que ya se canceló devuelve 409 con el código feature_override_not_pending. Para cambiar una comprobación después de que se haya aplicado su anulación, envía en su lugar una nueva solicitud de Actualizar el estado de una función.

Relacionado

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

sessionId
string<uuid>
requerido

UUID de la sesión de verificación. Acepta ID de sesión tanto de usuario (KYC) como de empresa (KYB).

Ejemplo:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

overrideId
string<uuid>
requerido

El id de la anulación que se va a cancelar.

Ejemplo:

"9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3"

Respuesta

La anulación se cancela y nunca se aplicará.

Una modificación manual del estado de una comprobación (función) realizada con PATCH /v3/session/{sessionId}/features/{nodeId}/update-status/: qué cambia, si se aplicó o sigue a la espera de que la persona termine el flujo, quién la solicitó y por qué.

id
string<uuid>
requerido

Identificador de la anulación. Pásalo al endpoint de cancelación.

Ejemplo:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

node_id
string
requerido

El nodo del flujo que indicó la solicitud (default para un paso sin nodo).

Ejemplo:

"feature_ocr_1"

feature_type
string
requerido

El feature_type que se pasó en la solicitud, o una cadena vacía si no se pasó ninguno.

Ejemplo:

""

feature_model
string
requerido

El tipo de comprobación que se anuló, por ejemplo KYC, Face, AML o GeolocationCheck.

Ejemplo:

"KYC"

previous_status
enum<string>
requerido

El estado de la comprobación cuando se solicitó la anulación manual.

Opciones disponibles:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
Ejemplo:

"In Review"

new_status
enum<string>
requerido

El estado que establece la anulación.

Opciones disponibles:
Approved,
Declined,
In Review
Ejemplo:

"Approved"

state
enum<string>
requerido

applied: la comprobación tiene el nuevo estado. pending_until_flow_finishes: la anulación queda en espera y se aplica cuando la persona termina el flujo. cancelled: quedó en espera y nunca se aplicó (consulta cancel_reason).

Opciones disponibles:
applied,
pending_until_flow_finishes,
cancelled
Ejemplo:

"applied"

forced
boolean
requerido

true cuando la anulación se aplicó de inmediato mientras la persona seguía en el flujo.

Ejemplo:

false

reason
string | null
requerido

El comment enviado con la solicitud, o null.

Ejemplo:

"Document manually verified by compliance."

requested_by
object | null
requerido

Quién solicitó la anulación, o null cuando no se conoce.

requested_at
string<date-time>
requerido

Fecha y hora en que se solicitó la anulación.

Ejemplo:

"2026-10-13T09:15:00Z"

applied_at
string<date-time> | null
requerido

Cuándo la comprobación adoptó el nuevo estado, o null mientras espera o una vez cancelada.

Ejemplo:

"2026-10-13T09:15:00Z"

cancelled_at
string<date-time> | null
requerido

Cuándo se canceló una anulación en espera, o null.

Ejemplo:

null

cancel_reason
enum<string> | null
requerido

Por qué nunca se aplicó una anulación en espera, o null. cancelled_by_reviewer: se canceló con el endpoint de cancelación. replaced: una anulación más reciente sobre la misma comprobación la reemplazó. check_changed: la persona volvió a hacer la comprobación antes de terminar el flujo. session_closed: la sesión salió del flujo antes de que la persona lo terminara (abandonada, expirada o decidida a mitad del flujo).

Opciones disponibles:
cancelled_by_reviewer,
replaced,
check_changed,
session_closed,
null
Ejemplo:

null

Última modificación el 1 de noviembre de 2026