Vérifiez le format national, la longueur et la clé de contrôle avant d’enregistrer les coordonnées bancaires du client.
API de validation d’IBAN SEPA
Validez les IBAN et vérifiez la participation bancaire à SEPA
Vérifiez un IBAN et la participation de la banque aux virements SEPA, aux virements instantanés et aux prélèvements Core et B2B. Obtenez un résultat distinct par schéma dans une réponse JSON, à partir des données bancaires et des registres de participants de l’EPC.
Commencez avec 10 requêtes API gratuites toutes les 24 heures.
L’IBAN est-il valide et la banque prend-elle en charge votre schéma SEPA ?
Il s’agit de vérifications distinctes. Un IBAN peut réussir les contrôles de format et de clé sans que la participation de la banque à un schéma de paiement donné soit confirmée. Vérifiez les deux lors de la collecte des coordonnées bancaires ou de la préparation d’une remise de paiements.
Utilisez les annuaires bancaires disponibles pour identifier la banque et son BIC. La vérification dans les annuaires est disponible pour 40 pays.
Consultez le résultat propre à votre virement, virement instantané ou prélèvement.
Quatre schémas SEPA, quatre résultats indépendants
Virement SEPA
details.sepa.sct
Indique la participation de la banque au schéma de virement SEPA classique.
Virement SEPA instantané
details.sepa.sctInst
Indique la participation au schéma de virement instantané. Ce résultat ne constitue ni un contrôle d’accessibilité en temps réel via RT1/TIPS, ni une garantie d’exécution instantanée.
Prélèvement Core
details.sepa.sddCore
Indique la participation au schéma de prélèvement SEPA Core.
Prélèvement B2B
details.sepa.sddB2b
Indique la participation au schéma interentreprises B2B. Ne déduisez pas ce résultat de celui du schéma Core.
Les données proviennent des registres distincts de chaque schéma de l’European Payments Council. Un résultat confirmé nécessite une identification univoque de la banque et une correspondance avec un participant actuellement adhérent dans des données de registre à jour.
Requête API SEPA et réponse JSON
Utilisez le point d’accès de validation d’IBAN avec votre clé API. Les résultats SEPA sont inclus lorsque des données bancaires sont renvoyées ; aucune requête supplémentaire par schéma n’est nécessaire.
curl --get "https://www.iban-test.eu/api/v2/iban/validate" \
--header "Authorization: Bearer YOUR_API_TOKEN" \
--data-urlencode "iban=DE89370400440532013000"Extrait de réponse illustrant uniquement les champs SEPA. Les résultats réels dépendent de l’IBAN et des données de registre disponibles.
{
"details": {
"sepa": {
"sct": {
"status": "confirmed",
"reason": "matched"
},
"sctInst": {
"status": "confirmed",
"reason": "matched"
},
"sddCore": {
"status": "confirmed",
"reason": "matched"
},
"sddB2b": {
"status": "confirmed",
"reason": "matched"
}
}
}
}Consulter la référence complète des champs SEPA et des motifs de résultat.
Traiter correctement les résultats confirmés et inconnus
Traitez d’abord les IBAN invalides. La participation SEPA est une information complémentaire qui ne modifie pas le résultat de validation de l’IBAN.
confirmed avec le motif matched confirme la participation de la banque à ce schéma. Chaque schéma doit être évalué séparément.
unknown signifie que la participation n’a pas pu être confirmée. Examinez le motif et prévoyez une vérification ou une solution de repli, au lieu de considérer automatiquement le schéma comme non pris en charge par la banque.
Par exemple, missing_bic signifie que le BIC de la banque était indisponible ; no_match, qu’aucun participant correspondant n’a été trouvé ; et stale_data, que les données du registre sont obsolètes.
Cette API valide les IBAN et vérifie la participation bancaire. Elle n’initie pas de paiements, ne vérifie ni le titulaire ni l’existence d’un compte, ne confirme pas de mandat de prélèvement et ne garantit pas le règlement. Votre prestataire de paiement doit gérer l’éligibilité du compte et le routage des paiements en temps réel.
Intégrez les contrôles SEPA à votre parcours de paiement
Utilisez ces résultats lors de l’entrée en relation client, de la mise en place de prélèvements et de la préparation des paiements. Commencez avec une clé API gratuite, examinez une réponse et traitez le schéma requis dans votre application.
Pour les contrôles généraux de format, de clé et d’annuaire bancaire, consultez l’API de validation d’IBAN.