Formats et regex des inputs par pays

Gestion des spécificités pays pour les contrôles Sis ID

Les informations utiles pour la gestion des jeux de données internationaux sont disponibles dans la documentation de l'API et incluent : Identifiants sociétés et formats de coordonnées bancaires supportés par géographie

Deux approches observées par Sis ID

Approche 1 : Répliquer la couverture et les spécificités Sis ID côté intégration.

• Dans cette approche, le consommateur de l'API doit gérer lui-même la liste des pays disponibles et le format accepté pour chacun de ces pays.

💡Pour tester les expressions régulières, vous pouvez utiliser un outil dédié comme https://regex101.com/ par exemple

Approche 2 : Ignorer la couverture et les spécificités Sis ID côté intégration.

• Dans cette approche, le consommateur de l'API envoie toutes les requêtes à Sis ID, indépendamment de la capacité de traitement de Sis ID. Le consommateur de l'API anticipe alors la réception de plusieurs erreurs de type 400 - Bad Request telles que :

{ 
  "message": "error.illegalState", 
  "description": "Country code [UU] is not a valid country code!", 
  "httpStatus": "BAD_REQUEST", 
  "httpCode": "400", 
  "httpMessage": "Bad Request" 
}

{ 
  "message": "error.illegalState", 
  "description": "Country [SG] does not support the registration id [824003958]!", 
  "httpStatus": "BAD_REQUEST", 
  "httpCode": "400", 
  "httpMessage": "Bad Request" 
}

{ 
  "message": "error.illegalState", 
  "description": "Country [TF] is not supported yet!", 
  "httpStatus": "BAD_REQUEST", 
  "httpCode": "400", 
  "httpMessage": "Bad Request" 
}

{ 
  "message": "error.validation", 
  "fieldErrors": [ 
    { 
      "objectName": "entity", 
      "field": "paymentIdentity.iban", 
      "message": "size must be between 14 and 34" 
    } 
  ], 
  "httpStatus": "BAD_REQUEST", 
  "httpCode": "400", 
  "httpMessage": "Bad Request" 
}

En savoir plus sur les erreurs dans Quelles réponses d’API peuvent être rencontrées en cas d’erreur ?

Comparatif des approches

Vous trouverez ci-dessous une brève comparaison des approches d'intégration pour vous guider dans votre implémentation des API Sis Inside :