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 :
| Avantages | Inconvénients | |
| Approche 1 | Meilleure expérience utilisateur | Le consommateur de l'API doit se conformer aux spécificités Sis ID et mettre à jour à chaque ajout ou modification d'un pays |
| Approche 2 | Effort d'intégration limité | La gestion des erreurs et l'expérience utilisateur associée doivent être adaptées en conséquence |