Passer au contenu principal
POST
curl
Lorsque vous appliquez une dérogation à une étape avec defer_until_flow_finishes: true alors que la personne est encore dans le parcours, la dérogation attend et s’applique à la fin du parcours. Annulez-la ici si vous ne souhaitez plus qu’elle s’applique. La vérification conserve son statut actuel. L’annulation est enregistrée dans l’activité de la session sous la forme FEATURE_OVERRIDE_CANCELLED, et aucun webhook n’est envoyé. La réponse est la dérogation avec state: cancelled et cancel_reason: cancelled_by_reviewer.

Trouver l’identifiant de la dérogation

Utilisez le id de l’objet override renvoyé par Mettre à jour le statut de la fonctionnalité, ou listez les dérogations de la session avec Lister les dérogations de fonctionnalité et choisissez-en une dont le state est pending_until_flow_finishes.

En cas d’échec de l’annulation

Une dérogation déjà appliquée ou annulée renvoie 409 avec le code feature_override_not_pending. Pour modifier une vérification après l’application de sa dérogation, envoyez plutôt une nouvelle requête Mettre à jour le statut de la fonctionnalité.

Voir aussi

Autorisations

x-api-key
string
header
requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Paramètres de chemin

sessionId
string<uuid>
requis

UUID de la session de vérification. Accepte les identifiants de session d'utilisateur (KYC) et d'entreprise (KYB).

Exemple:

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

overrideId
string<uuid>
requis

L'id de la dérogation à annuler.

Exemple:

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

Réponse

La dérogation est annulée et ne s'appliquera jamais.

Une modification manuelle (override) du statut d'une vérification (fonctionnalité) effectuée avec PATCH /v3/session/{sessionId}/features/{nodeId}/update-status/ : ce qu'elle modifie, si elle a été appliquée ou si elle attend toujours que la personne termine le parcours, qui l'a demandée et pourquoi.

id
string<uuid>
requis

Identifiant de la dérogation. Transmettez-le à l'endpoint d'annulation.

Exemple:

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

node_id
string
requis

Le nœud de workflow spécifié dans la requête (default pour une étape sans nœud).

Exemple:

"feature_ocr_1"

feature_type
string
requis

Le feature_type transmis par la requête, ou une chaîne vide si aucun n'a été transmis.

Exemple:

""

feature_model
string
requis

Le type de vérification qui a été remplacé, par exemple KYC, Face, AML ou GeolocationCheck.

Exemple:

"KYC"

previous_status
enum<string>
requis

Le statut de la vérification au moment où la dérogation a été demandée.

Options disponibles:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
Exemple:

"In Review"

new_status
enum<string>
requis

Le statut défini par la dérogation.

Options disponibles:
Approved,
Declined,
In Review
Exemple:

"Approved"

state
enum<string>
requis

applied : le contrôle a le nouveau statut. pending_until_flow_finishes : la dérogation attend et s'applique lorsque la personne termine le flux. cancelled : elle a attendu et ne s'est jamais appliquée (voir cancel_reason).

Options disponibles:
applied,
pending_until_flow_finishes,
cancelled
Exemple:

"applied"

forced
boolean
requis

true lorsque la dérogation s'est appliquée immédiatement alors que la personne était encore dans le flux.

Exemple:

false

reason
string | null
requis

Le comment envoyé avec la requête, ou null.

Exemple:

"Document manually verified by compliance."

requested_by
object | null
requis

Qui a demandé la dérogation, ou null lorsque cela n'est pas connu.

requested_at
string<date-time>
requis

Moment où la dérogation a été demandée.

Exemple:

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

applied_at
string<date-time> | null
requis

Date et heure auxquelles la vérification a pris le nouveau statut, ou null pendant qu'elle est en attente ou une fois qu'elle est annulée.

Exemple:

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

cancelled_at
string<date-time> | null
requis

Moment où une dérogation en attente a été annulée, ou null.

Exemple:

null

cancel_reason
enum<string> | null
requis

Raison pour laquelle un remplacement en attente n'a jamais été appliqué, ou null. cancelled_by_reviewer : annulé avec l'endpoint d'annulation. replaced : un remplacement plus récent sur la même vérification l'a remplacé. check_changed : la personne a refait la vérification avant de terminer le flux. session_closed : la session a quitté le flux avant que la personne ne le termine (abandonnée, expirée ou décidée en cours de flux).

Options disponibles:
cancelled_by_reviewer,
replaced,
check_changed,
session_closed,
null
Exemple:

null

Dernière modification le 7 novembre 2026