API SEPA : intégrez les paiements européens à votre produit en quelques minutes

Intégration en 4 étapes

Nous avons conçu l'API pour qu'un développeur puisse effectuer son premier appel en moins de 5 minutes.

1. Créez un compte gratuit et activez l'option API dans votre abonnement.
2. Copiez votre clé d'API depuis le panneau développeur de votre compte.
3. Appelez nos endpoints avec une authentification basique (clé d'API comme nom d'utilisateur, mot de passe vide ou valeur quelconque).
4. Traitez la réponse JSON. Lorsqu'un endpoint renvoie un fichier (SEPA XML ou mandat PDF), il arrive encodé en Base64.

Exemple : valider un IBAN en un seul appel

Une requête POST vers /api/v2/bank_accounts renvoie toutes les informations de l'IBAN au format JSON.

curl -X POST https://www.conversorsepa.es/api/v2/bank_accounts \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{"bank_account":{"iban":"ES9121000418450200051332"}}'

Réponse attendue :

{
  "status": "ok",
  "iban": "ES9121000418450200051332",
  "bic":  "CAIXESBBXXX",
  "bank": "CaixaBank",
  "country": "ES"
}

Endpoints disponibles

Voici les endpoints REST que vous pouvez utiliser dès le premier jour :

• POST /api/v2/bank_accounts — Validation d'IBAN renvoyant le BIC, le nom de la banque et le pays.
• POST /api/v2/sct — Génération de fichiers SEPA Credit Transfer (virements).
• POST /api/v2/sdd — Génération de fichiers SEPA Direct Debit (prélèvements CORE et B2B).
• POST /api/v2/mandates — émettre un nouveau mandat SEPA en PDF.
• GET /api/v2/mandates/:id — récupérer un mandat existant par son identifiant.

Consulter la documentation officielle complète de l'API

Comment fonctionne l'authentification de l'API ?

Nous utilisons l'authentification basique (Basic Auth). Votre clé d'API sert de nom d'utilisateur ; le mot de passe peut rester vide ou prendre n'importe quelle valeur, il n'est pas utilisé. Vous pouvez obtenir et régénérer votre clé d'API depuis le panneau développeur de votre compte.

Quel format de données est utilisé pour l'envoi et la réception ?

Toutes les communications se font en JSON sur HTTPS. Lorsqu'une réponse contient un fichier (SEPA XML ou mandat PDF), il est fourni sous forme de chaîne Base64 dans le JSON, prêt à être décodé dans le langage de votre choix.

Quels endpoints sont disponibles ?

Validation d'IBAN, génération de fichiers SEPA SCT (virements), génération de fichiers SEPA SDD (prélèvements CORE et B2B), ainsi que création et récupération de mandats SEPA en PDF. Vous trouverez la référence complète dans notre documentation officielle.

Combien coûte l'API ?

L'accès à l'API est une option à +10 €/mois en plus de n'importe quel abonnement, avec conversions illimitées. Vous pouvez l'essayer gratuitement pendant la période d'essai, sans engagement.

Articles liés

• Lire notre blog technique sur le SEPA
• Générateur de mandats SEPA en ligne
• Validateur d'IBAN gratuit

Autres outils SEPA

• Validateur d'IBAN — Vérifiez le format et les chiffres de contrôle MOD-97 de n'importe quel IBAN.
• Banque à partir de l'IBAN — Identifiez la banque à laquelle appartient un IBAN.
• Identifiant créancier SEPA (ICS) — Générez et vérifiez l'identifiant créancier SEPA.
• Validateur XML pain.008 — Contrôlez vos fichiers de prélèvement SEPA par rapport au schéma officiel.