Passer au contenu principal
POST
curl
L’endpoint de Didit pour révoquer une connexion bancaire arrête l’accès à la banque, et les récupérations de données bancaires s’arrêtent dès que vous en faites la demande. La révocation ne supprime rien : utilisez supprimer pour cela. Le statut du consentement affiche revocation_pending, puis revoked lorsque la banque confirme la révocation.

Autorisations

x-api-key
string
header
requis

La clé API de votre application, disponible dans Developers -> API keys de la Business Console. La clé principale a un accès complet. Une clé nommée peut être limitée : aucun accès, lecture ou écriture par ressource, restreinte à certains workflows ou à certaines 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 à cette action, ou que la requête provient d'une adresse hors de sa liste d'adresses IP ; 404 sur une route de session signifie que la session se trouve hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL des images, vidéos et 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.

En-têtes

Idempotency-Key
string

Clé facultative de sécurisation des nouvelles tentatives, que vous choisissez pour une opération, d'au plus 255 caractères (un UUID convient). Une requête répétée avec la même clé, le même endpoint, les mêmes paramètres de requête et le même corps reçoit la première réponse, avec le même statut et le même corps, et n'est ni exécutée ni facturée une seconde fois. La même clé avec un autre endpoint, d'autres paramètres de requête ou un autre corps renvoie 409 idempotency_key_reused. Tant que la première requête est encore en cours, elle renvoie 409 idempotency_key_in_progress avec Retry-After. Une requête échouée (tout 4xx ou 5xx) n'est pas enregistrée, vous pouvez donc la renvoyer avec la même clé. Les clés sont propres à votre application, que vous appeliez avec une clé API ou un jeton d'accès. Voir Nouvelles tentatives et idempotence.

Required string length: 1 - 255

Paramètres de chemin

id
string<uuid>
requis

L'identifiant de la connexion.

Réponse

La connexion avec le statut de révocation.

L'autorisation accordée par la personne à votre application pour lire une banque. Un renouvellement conserve l'identifiant de connexion et tous les identifiants de compte. Une connexion supprimée ne renvoie que id, status, status_reason, created_at et erasure : tous les autres champs sont absents, et aucune donnée de banque, de personne ou de compte n'y subsiste.

id
string<uuid>
requis

Identifiant de la connexion.

status
enum<string>
requis

pending : première synchronisation en cours. active : consentement valide. renewal_required : le consentement a pris fin ou la banque demande à la personne de se reconnecter ; les données restent lisibles telles que synchronisées en dernier et rien n'est facturé. paused : solde insuffisant pour le mois. revoked : accès interrompu par la personne, la banque ou vous. deleted : seuls id, status, status_reason, created_at et erasure subsistent. failed : la première synchronisation n'a jamais réussi.

Options disponibles:
pending,
active,
renewal_required,
paused,
revoked,
deleted,
failed
status_reason
enum<string> | null
requis

Pourquoi la connexion se trouve dans ce statut. paused_by_customer est réservé. Pour une connexion deleted : deleted_by_customer, consent_lapsed, retention_elapsed ou application_deleted.

Options disponibles:
collection_complete,
consent_expired,
consent_lapsed,
bank_requires_sign_in,
revoked_by_end_user,
revoked_by_bank,
revoked_by_customer,
insufficient_balance,
paused_by_customer,
first_sync_failed,
deleted_by_customer,
retention_elapsed,
application_deleted,
null
erasure
object | null
requis

Défini après delete_connection ; sinon null.

created_at
string<date-time>
requis
environment
enum<string>
Options disponibles:
live,
sandbox
access
enum<string>
Options disponibles:
one_time,
ongoing
institution
object

La banque à laquelle se rattache une connexion ou un lien.

segment
enum<string> | null
Options disponibles:
personal,
business,
null
data
enum<string>[]

Les scopes acceptés par la personne.

Options disponibles:
accounts,
balances,
transactions

Le consentement de la personne pour cette connexion.

sync
object

État de synchronisation d'une connexion.

accounts
object[]

Récapitulatif de chaque compte de la connexion. Lisez le compte complet avec get_account.

ownership
object

La comparaison facultative du titulaire du compte avec une personne ou une entreprise.

end_user
object
manage_url
string<uri> | null

La page d'accès propre à la personne. null tant que la page d'accès n'est pas disponible.

billing
object

Ce que coûte cette connexion. Le sandbox n'est jamais facturé.

possible_duplicate_of
string<uuid> | null

Défini lorsque cette connexion peut en dupliquer une autre active, mais qu’aucun end_user.reference n’a permis d’établir une correspondance certaine.

vendor_data
string | null
updated_at
string<date-time>
Dernière modification le 22 novembre 2026