Aller au contenu principal

Modèle unique de représentation de la verification externe d'une appartenance de compte bancaire

Mise à jour

Cet article vise à informer les consommateurs de l’API des changements à venir sur l’API Sis ID Controls concernant les vérifications FR et NL prises en charge par SepaMail Diamond.
Il s’applique également aux vérifications des personnes physiques.
 

Contexte

La vérification de la propriété d’un compte bancaire dans Sis ID repose sur des sources internes et externes. Historiquement, la première source externe utilisée a été SepaMail Diamond.

Les vérifications prises en charge via SepaMail Diamond incluent un ensemble de propriétés dédiées et spécifiques :

  • Des reasonCodes et reasonLabels spécifiques commençant par SD-XX

  • D’autres propriétés spécifiques au niveau de la vérification dans la réponse de l’API POST /checks

  • D’autres propriétés spécifiques au niveau des lots dans les réponses des routes /audition

Par exemple :

  "reasons": [
    "S-NR",
    "I-NR",
    "CLH-SINR",
    "COH-CRL",
    "SD-V"
  ],
  "sepamailVerificationStatus": "VERIFIED",
  "sepamailReportCodes": [
    "01001",
    "02001",
    "03001"
  ],
  "reasonLabels": {
    "sepamail.code.01001": "01001 (existant and valid IBAN)",
    "sepamail.status.VERIFIED": "The IBAN and the company are verified by the SEPAmail DIAMOND service.",
    "sepamail.code.03001": "03001 (correct SIREN)",
    "sepamail.code.02001": "02001 (correct customer type)",
    "reason.code.I-NR": "IBAN not added on the platform.",
    "reason.code.CLH-SINR": "Analysis of your payment history: company and IBAN unknown.",
    "reason.code.S-NR": "Company not enrolled on the platform.",
    "reason.code.COH-CRL": "Analysis of the community's payment history: combination known but with a low payment frequency."
  },

 

{
  "id": "",
  "name": "Import #2 of August 31, 2020",
  "nbItems": 387,
  "nbAuditedItems": 352,
  "nbErrorItems": 35,
  "completed": false,
  "failed": false,
  "classificationResult": {
    "high": 297,
    "medium": 19,
    "low": 11,
    "no": 25
  },
  "nbPendingSepamail": 15,
  "errors": ""
}

 

À mesure que Sis ID a élargi son portefeuille de sources externes intégrées pour la vérification de la propriété des comptes bancaires, un modèle générique a été introduit afin de représenter les données collectées auprès de différents fournisseurs sous la catégorie reasonCode et reasonLabel MV-XX.

Toutes les autres sources de données ayant un rôle similaire à SepaMail Diamond sont désormais intégrées dans cette catégorie MV-XX, disponible depuis le premier trimestre 2023.

 

Simplification

Sis ID rationalise le portefeuille des sources de données intégrées ainsi que les propriétés de l’API.

À terme, les codes SD-XX et les propriétés associées seront dépréciés puis abandonnés, selon un calendrier qui sera précisé au cours de l’année 2026.

Tous les résultats utilisant une source externe de référence pour la vérification de la propriété d’un compte bancaire, tant pour les personnes morales que pour les personnes physiques, seront harmonisés sous le concept M-XX.

 

{
  ...

  "reasons": [
    "S-NR",
    "I-NR",
    "CLH-SINR",
    "COH-SINR",
    "MV-M"
  ],
  "reasonLabels": {
    "reason.code.COH-SINR": "Analysis of the community's payment history: company and bank details unknown.",
    "reason.code.MV-M": "Match of bank details with an account owner has been verified by the service: NAME.",
    "reason.code.I-NR": "Bank details not added on the platform.",
    "reason.code.CLH-SINR": "Analysis of your payment history: company and bank details unknown.",
    "reason.code.S-NR": "Company not enrolled on the platform."
  },
  "lastMatchVerificationDetail": {
    "dataProvider": "NAME",
    "status": "MATCH",
    "categories": [],
    "date": "2023-01-16T09:42:21.440Z"
  },

  ...
}

 

Mapping

Cette section fournit une correspondance entre les codes actuel SD-XX et les nouveaux codes MV-XX

Reason code actuel  Reason code correspondant Label
These new labels will be applied in a second phase
SD-P MV-P External source: verification in progress
SD-V MV-M External source: match between bank details and third party validated
SD-NV MV-NM External source: correspondence between bank details and third party invalidated
SD-IV MV-U External source: data not eligible
  MV-TO External source: timeout
  MV-ERR External source: technical error
  MV-CM External source: partial match between bank details and third party

 

Que devez-vous faire ?

En tant que consommateur de l’API :

  • Vérifiez le niveau de dépendance de votre intégration aux reasonCodes et reasonLabels SD-XX, ainsi qu’aux autres propriétés spécifiques à SepaMail Diamond :

    • nbPendingSepaMail

    • sepamailVerificationStatus

    • sepamailReportCodes

    • sepamail.code.XX

    • sepamail.status.XX

  • Vérifiez que votre intégration est prête à utiliser les reasonCodes et reasonLabels MV-XX. Par défaut, cela devrait déjà être compatible.

  • Consultez la documentation de l’API disponible ici.

  • Contactez votre interlocuteur Sis ID.

Articles associés