Validation CSV en masse

Validez des milliers de coordonnées bancaires en une seule requête via l'upload d'un fichier CSV.

Fonctionnalité Pack Business

La validation CSV en masse est disponible exclusivement avec le Pack Business (100 000 validations). Chaque ligne du fichier consomme un crédit de validation.

Comment ça fonctionne

Préparez votre CSV

Créez un fichier CSV avec les colonnes requises : type, identifier, account_number. Chaque ligne représente une coordonnée bancaire à valider.

Envoyez le fichier

Uploadez votre fichier CSV via l'endpoint POST /api/v1/validate/bulk. Le traitement est asynchrone pour les fichiers volumineux.

Récupérez les résultats

Téléchargez le fichier CSV enrichi avec les colonnes de résultat : status, confidence, bank_name et errors.

Format CSV

Colonnes requises

Colonne	Description	Exemple
type	Type de validation : US, UK, SWIFT ou IBAN	US
identifier	Identifiant principal (routing number, sort code, BIC ou IBAN)	021000021
account_number	Numéro de compte (requis pour US et UK, vide pour SWIFT et IBAN)	1234567890

Types supportés

ABA Routing

Sort Code

SWIFT

BIC/SWIFT

IBAN

Exemple de fichier CSV

type	identifier	account_number
US	021000021	1234567890
UK	200000	58658244
SWIFT	CHASUS33
IBAN	DE89370400440532013000

Endpoint API

POST/api/v1/validate/bulk

Envoyez votre fichier CSV via une requête multipart/form-data.

Content-Type:multipart/form-data

Taille max. du fichier:10 MB

Lignes max.:10,000

curl

curl -X POST https://bankvalidor.com/api/v1/validate/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@bank_coordinates.csv"

Format de la réponse

Le fichier CSV retourné contient les colonnes d'origine plus les colonnes de résultat ajoutées par BankValidor.

Colonnes ajoutées

Colonne	Description
status	Résultat de la validation : VALID, WARNING ou INVALID
confidence	Niveau de confiance : HIGH, MEDIUM, LOW ou NONE
bank_name	Nom de la banque identifiée (si trouvée dans les registres)
errors	Messages d'erreur détaillés (si la validation échoue)

Exemple complet

Fichier d'entrée (input.csv)

input.csv

type,identifier,account_number
US,021000021,1234567890
UK,200000,58658244
SWIFT,CHASUS33,
SWIFT,INVALIDXX,
IBAN,DE89370400440532013000,

Fichier de sortie (output.csv)

output.csv

type,identifier,account_number,status,confidence,bank_name,errors
US,021000021,1234567890,VALID,HIGH,JPMorgan Chase,
UK,200000,58658244,VALID,HIGH,Barclays Bank,
SWIFT,CHASUS33,,VALID,HIGH,JPMorgan Chase Bank N.A.,
SWIFT,INVALIDXX,,INVALID,NONE,,Invalid SWIFT/BIC format
IBAN,DE89370400440532013000,,VALID,HIGH,Commerzbank,

Limites et contraintes

10 000 lignes maximum par fichier
Les fichiers dépassant cette limite seront rejetés. Divisez vos fichiers si nécessaire.
1 upload simultané par clé API
Les uploads supplémentaires seront mis en file d'attente et traités séquentiellement.
Timeout de 5 minutes
Les fichiers volumineux peuvent nécessiter plusieurs minutes de traitement. Utilisez les webhooks pour être notifié de la complétion.

Documentation associée

API REST

Documentation complète des endpoints de validation unitaire.

Consulter →

Webhooks

Recevez des notifications automatiques à la fin du traitement de vos fichiers CSV.

Consulter →

BankValidor — Validation CSV en masse