Passer au contenu principal
Bank Verification ne laisse jamais une personne bloquée. Tant que l’étape attend son action, elle peut toujours choisir Continuer sans votre banque, et l’étape l’affiche dès qu’aucune méthode ne fonctionne pour son pays ou sa banque. La session applique alors la décision que vous avez choisie pour ce cas de figure, un examen manuel par défaut. Lorsqu’une tentative infructueuse épuise la dernière tentative de toutes les options qui lui sont encore proposées, y compris le téléversement d’un relevé bancaire, l’étape n’attend pas : elle se termine d’elle-même et applique bank_attempts_exhausted_action, un refus par défaut, à moins qu’une tentative antérieure n’ait déjà abouti à un verdict, comme une non-concordance de nom. Ce verdict est alors maintenu. Cette page présente les autres méthodes de vérification proposées par chaque pays, le moment où la personne voit Continuer sans votre banque, la manière dont chaque cas est tranché et comment lire ce résultat.

Les méthodes de vérification

La personne commence par la connexion bancaire ou la vérification de compte, dans l’ordre que vous avez défini pour son pays : voir Choisir les méthodes par pays. Le téléversement de relevé et les micro-dépôts interviennent en solution de repli après ces deux méthodes. Continuer sans votre banque arrive en dernier. Une méthode qu’un pays ne peut pas utiliser n’est jamais proposée à la personne qui s’y trouve. Dans la console, Pays et méthodes l’affiche comme Non disponible pour ce pays.

Un pays qu’aucune route bancaire ne dessert

Un pays où ni la connexion bancaire ni la vérification de compte ne disposent d’une route reste dans l’étape. Ses utilisateurs téléversent un relevé bancaire, lorsque l’étape en propose un, ou continuent sans banque. Un enregistrement conserve un tel pays lorsqu’il omet methods ou lui attribue la valeur null. Son champ methods ne peut pas lister de méthode, car aucune route n’en dessert à cet endroit : cela est refusé lors de l’enregistrement, par exemple avec Account check is not available in VNM. Une liste vide est également refusée, comme dans chaque pays activé, avec Choose a method: bank sign-in, account check, or both. Si votre contrat fixe ses propres prix et n’inclut pas le téléversement de relevé, un enregistrement qui en propose un sans aucune tentative bancaire préalable refuse également un tel pays.
Ici, le Vietnam représente un pays qu’aucune route bancaire ne dessert. Il ne définit aucun paramètre methods, l’enregistrement le conserve donc, et ses utilisateurs voient le téléversement de relevé ainsi que Continuer sans votre banque.

Le téléversement de relevé

Le téléversement de relevé demande un relevé bancaire datant de moins de 3 mois indiquant le nom de la personne, sa banque et le numéro de compte. Didit le lit, vérifie s’il a été modifié et compare le nom du titulaire de la même manière que lors d’une vérification bancaire. Lorsque bank_statement_enabled est activé, l’étape le propose dans deux cas :
  • Après une tentative facturée : dès qu’une connexion bancaire ou une vérification de compte a été facturée au cours de la même session, le téléversement de relevé fait office de solution de repli, sans frais supplémentaires.
  • Sans aucune tentative bancaire préalable : dans n’importe quel pays, y compris ceux qu’aucune route bancaire ne dessert. Cela nécessite bank_statement_standalone_enabled, qui est activé par défaut. Désactivez-le pour ne proposer le téléversement de relevé qu’après une tentative facturée.
Le téléversement de relevé et les micro-dépôts consomment chacun l’une des tentatives bank_max_attempts de l’étape, les mêmes que celles utilisées par la connexion bancaire. Dès que la personne les a toutes épuisées, aucun des deux n’est plus proposé, même après une tentative facturée. La vérification de compte dispose de son propre paramètre bank_account_check_max_attempts ; ainsi, là où elle constitue la seule méthode, une personne ayant utilisé toutes ses vérifications de compte peut encore téléverser un relevé, si l’étape en propose un. Lorsqu’une tentative infructueuse épuise la dernière tentative de chaque option encore proposée à la personne, y compris le téléversement de relevé, l’étape se termine d’elle-même : la personne n’est pas invitée à continuer, et le résultat n’enregistre aucune action de continuation. La session applique bank_attempts_exhausted_action, à moins qu’une tentative antérieure n’ait déjà abouti à un verdict, tel qu’une non-concordance de nom, qui est alors maintenu. Pour laisser de la place à une solution de repli après un échec de connexion bancaire, définissez bank_max_attempts sur 2 ou plus.

Quand la personne voit Continuer sans votre banque

bank_continue_without_bank définit quand l’étape affiche Continuer sans votre banque : Aucune des deux valeurs ne désactive l’option : la personne peut toujours continuer. Dans la console, configurez-la dans l’étape Vérification bancaire sous Quand la personne ne peut pas vérifier, via Afficher Continuer sans banque : Quand rien d’autre ne fonctionne ou Dès le début.

Ce que voit la personne

  • Aucun parcours dans son pays : par exemple « Nous ne pouvons pas encore nous connecter aux banques au Vietnam », avec l’import de relevé sous Autres moyens de vérification, et Continuer sans votre banque.
  • Une banque qui ne peut pas être utilisée ici : « Cette banque ne peut pas être utilisée ici ». La personne peut saisir les coordonnées de son compte lorsque le pays propose la vérification de compte, importer un relevé, choisir une autre banque ou continuer sans sa banque.
  • Pas d’accès aux services bancaires en ligne, ou banque non répertoriée : « Vérifiez votre compte d’une autre manière », avec les moyens proposés par son pays, et Continuer sans votre banque.
  • Une banque injoignable pour le moment : la personne peut réessayer. L’écran propose également Continuer sans votre banque dès que l’autre méthode, la connexion bancaire ou la vérification de compte, ne peut pas aider : son pays ne la propose pas, il ne reste plus aucune tentative, ou sa dernière tentative n’a pas pu joindre la banque non plus.
  • Après avoir continué : « Merci, vous pouvez continuer ». Aucun échec n’est jamais présenté à la personne, et elle passe à l’étape suivante de votre workflow.

Choisir le résultat

Lorsque la personne continue sans banque, Didit en détermine la raison à partir de ce qui s’est passé durant l’étape. La plateforme ne prend jamais de motif provenant de l’appareil de la personne. Chaque motif, enregistré sous continuation.reason, suit son propre paramètre de résultat :
  • no_route : aucun parcours de connexion bancaire ou de vérification de compte n’est disponible dans son pays. Décidé par bank_unsupported_action, REVIEW par défaut, avec le code de motif NOT_COVERED.
  • institution_unsupported : la banque choisie ne peut pas être utilisée pour cette étape. Décidé par bank_unsupported_action, REVIEW par défaut, avec le code de motif NOT_COVERED.
  • attempts_exhausted : toutes les tentatives étaient déjà épuisées, et aucune n’était encore en cours, lorsqu’elle a continué. Décidé par bank_attempts_exhausted_action, DECLINE par défaut.
  • person_choice : un moyen de vérification était disponible, et la personne a choisi de continuer. Cela inclut une banque qui n’a pas pu être jointe actuellement : la banque est prise en charge, le choix de la personne est donc le motif retenu. Décidé par bank_skipped_action, REVIEW par défaut, avec le code de motif SKIPPED.
bank_skipped_action et bank_attempts_exhausted_action acceptent REVIEW ou DECLINE. bank_unsupported_action accepte également NO_ACTION, ce qui approuve l’étape tout en enregistrant NOT_COVERED. Dans la console, il s’agit des lignes Banque ou pays non couvert, A continué sans banque et Tentatives épuisées de l’onglet Résultats de l’étape.
Continuer ne remplace jamais un verdict déjà rendu par une tentative. Si une tentative a déjà été évaluée, par exemple si la banque ou un relevé a renvoyé un titulaire qui ne correspond pas et que la personne avait encore des tentatives, ou une correspondance proche qu’elle n’a pas confirmée, l’étape conserve ce verdict et ses codes de motif. Aucun paramètre de résultat de la liste ci-dessus ne s’applique alors, et aucun NOT_COVERED ni SKIPPED n’est ajouté. Le résultat enregistre tout de même que la personne a continué : voir Consulter le résultat.

Le lire dans le résultat

Décision et webhooks

L’élément de l’étape dans bank_verifications[], dans la décision de la session et dans l’objet decision des webhooks status.updated, indique que la personne a continué sans banque :
  • continued_without_bank est true : la personne a quitté l’étape via Continuer sans votre banque.
  • method est none lorsqu’aucune tentative n’a été évaluée avant que la personne ne continue. Après une tentative évaluée, comme un titulaire non correspondant, method conserve la méthode de cette tentative, et son verdict est maintenu.
  • continuation indique comment la personne a continué :
    • reason : no_route, institution_unsupported, attempts_exhausted ou person_choice.
    • country : le pays dans lequel la personne effectuait la vérification, au format ISO 3166-1 alpha-3, ou null si elle a continué avant d’en sélectionner un.
    • offered : les autres méthodes de vérification proposées pour ce pays, dans l’ordre où elles ont été présentées : statement, puis microdeposits. Vide si aucune n’a été proposée.
    • institution_id et institution_name : pour institution_unsupported, la banque que la personne n’a pas pu utiliser : la banque qu’elle a sélectionnée ou celle sur laquelle sa dernière tentative s’est achevée. Didit tire ces deux informations de sa propre liste de banques, jamais de l’appareil de la personne ; une banque absente de cette liste laisse donc ces deux champs à null. Les deux sont à null pour tout autre motif.
    • continued_at : le moment où la personne a continué.
  • reason_codes contient NOT_COVERED ou SKIPPED, comme dans Choisir le résultat, lorsque la continuation a déterminé le résultat de l’étape. Après une tentative évaluée, il conserve les codes de motif de cette tentative.
  • not_covered est true pour no_route et institution_unsupported.
L’exemple ne montre que les champs abordés sur cette page. L’ensemble des champs se trouve dans le schéma BankVerificationResult de la référence de l’API. Lorsque votre workflow restreint les données qu’il renvoie, continued_without_bank et continuation.reason sont toujours renvoyés, ce qui vous permet de distinguer no_route de institution_unsupported, qui partagent tous deux NOT_COVERED. Toutes les autres clés de continuation sont alors à null : le pays, la banque, ce qui a été proposé et quand. continuation lui-même est null si la personne n’a pas continué. method n’est pas renvoyé non plus dans ce cas ; lisez donc continued_without_bank, et non method, pour savoir si la personne a continué.

Règles de workflow

Les branches et les règles de statut personnalisées peuvent lire :
  • bank.continued_without_bank : true ou false.
  • bank.continue_reason : no_route, institution_unsupported, attempts_exhausted ou person_choice.
  • bank.method : none lorsque la personne a continué sans banque avant qu’une tentative ait été évaluée. Après une tentative évaluée, la méthode de cette tentative.

Rapport de session

Lorsque la personne a continué sans banque avant qu’une tentative ait été évaluée, la ligne Méthode de vérification du rapport PDF de la session affiche A continué sans banque. Après une tentative évaluée, elle indique la méthode de cette tentative.

Tarifs

  • Continuer sans votre banque n’est jamais facturé. Les tentatives effectuées par la personne avant de continuer sont facturées comme d’habitude.
  • Un téléversement de relevé sans tentative bancaire facturée préalable coûte $0.20 par relevé lu et évalué par Didit. Il est facturé sur sa propre ligne d’utilisation, Bank verification - statement upload (bank_statement_upload), et le tarif de votre contrat ou votre prix spécifique s’y applique comme pour tout module complémentaire. Si votre contrat définit ses propres prix et ne l’inclut pas, l’étape ne le propose pas.
  • Un téléversement de relevé ou des micro-dépôts après une connexion bancaire ou une vérification de compte facturée au cours de la même session sont inclus sans frais supplémentaires.

Nœuds enregistrés avant Continuer sans votre banque

bank_allow_skip est obsolète. Un nœud enregistré avec ce paramètre s’exécute désormais avec la valeur correspondante : Un nœud qui n’autorisait pas l’omission laissait auparavant la personne sans issue lorsque rien ne fonctionnait pour elle. Il affiche désormais Continuer sans votre banque dans ces situations, et bank_unsupported_action, bank_attempts_exhausted_action ou bank_skipped_action tranche la session. Pour une version, un enregistrement qui transmet bank_allow_skip sans bank_continue_without_bank configure toujours le mode à partir de celui-ci. Chaque enregistrement réécrit bank_allow_skip : true pour from_start, false pour when_needed. Utilisez bank_continue_without_bank dans vos nouvelles intégrations.

Tester dans la sandbox

Une application de sandbox ne facture rien, et le téléversement de relevé ainsi que les micro-dépôts ne nécessitent aucune tentative bancaire préalable. Définissez bank_continue_without_bank sur from_start pour voir Continuer sans votre banque dès le premier écran, et sélectionnez-le pour tester bank_skipped_action. Consultez Tests en sandbox pour découvrir le fonctionnement général des applications sandbox.

En savoir plus

Dernière modification le 7 novembre 2026