404 tant que l’accès en production n’a pas été annoncé.
Accès ponctuel et accès continu
L’accès continu n’est disponible auprès d’une banque que si celle-ci l’autorise.
Interrogez le endpoint des institutions ou consultez la page de couverture.
Lorsqu’une banque ne peut pas maintenir l’accès ouvert, la personne est informée que cette banque n’autorise pas l’accès continu et doit choisir une autre banque.
Définissez
allow_one_time_fallback: true pour permettre à la personne de poursuivre avec une lecture ponctuelle après avoir confirmé, sur son propre écran, l’accès réduit : la connexion est alors one_time.
Statuts
status_reason prend l’une des valeurs suivantes : 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 (réservée, aucun endpoint ne la définit actuellement) et first_sync_failed.
Consentement
La banque fixe la fin du consentement, dans la limite du nombre de jours que vous avez demandé dansconsent_days.
Chaque connexion affiche ses dates réelles dans consent :
expires_atetrenew_by: la fin du consentement. Renouvelez-le avant cette date pour éviter toute rupture.renewable_until: la dernière date à laquelle la même connexion peut être réactivée après la fin du consentement.renewed_count,version,scopes_grantedetaccounts_granted: ce qui a été accordé, et le nombre de fois où le consentement a été renouvelé.
Renouvellement
Un renouvellement conserve l’identifiant de la connexion et chaque identifiant de compte, et l’historique se poursuit sans doublons.- Didit envoie
bank.connection.consent_expiring14, 7 et 1 jour avant la fin. - Appelez
POST /v3/bank/connections/{id}/renew/. Il répond409 renewal_not_neededtant qu’il reste plus de 30 jours, et409 renewal_window_expiredaprèsconsent.renewable_until. Sinon, il répond201avec un lien de renouvellement.
renewal_required : les données restent consultables telles que synchronisées pour la dernière fois, et rien n’est facturé.
Après consent.renewable_until, elle passe à revoked avec status_reason: consent_lapsed, et la personne doit se reconnecter.
Pour le parcours complet, consultez Renouveler un consentement bancaire.
Arrêter l’accès
Arrêter l’accès ne revient pas à supprimer.
Consultez Données, consentement et suppression pour savoir exactement ce que la suppression efface.
Connexion supprimée
Une connexion supprimée ne renvoie queid, status (deleted), status_reason, created_at et erasure.
status_reason vaut deleted_by_customer, consent_lapsed, retention_elapsed ou application_deleted.
Tous les autres champs sont absents.
Doublons
Un nouveau lien qui correspond exactement aux comptes que vous partagez déjà avec le mêmeend_user.reference auprès de la même banque est renouvelé (reused: true) et n’entraîne aucune double facturation.
Tout autre chevauchement fait passer le lien au statut failed avec duplicate_conflict et conflicts_with, avant que quoi que ce soit ne soit enregistré ou facturé.
Renouvelez la connexion existante, ou recréez le lien avec "duplicates": "allow" pour obtenir une seconde connexion indépendante.
Gérer les connexions de vos clients
- Lister avec des filtres :
GET /v3/bank/connections/acceptestatus,access,institution_id,country,vendor_data,end_user_reference,consent_expires_beforeetcreated_after. - Consultez le coût d’une connexion grâce à son objet
billing: l’unité, le prix et le mois déjà réglé.