Tutoriel API: synchroniser vos réservations avec un IBAN virtuel

Pourquoi lier vos réservations à un IBAN virtuel ?

Gérer les encaissements d’une petite agence de voyages est souvent un casse-tête : vous devez attribuer chaque virement client au bon dossier, pointer les versements fournisseurs, relancer les erreurs de saisie… Résultat : des heures perdues en rapprochement bancaire et un risque d’erreur élevé.

L’IBAN virtuel Elia résout ce problème en générant un RIB unique par dossier de réservation. Grâce à l’API, l’IBAN est créé automatiquement dès qu’un client valide un devis, et toutes les opérations remontent dans votre back-office réservation en temps réel. Ce tutoriel vous guide, pas à pas, pour :

créer une clé API sécurisée ;
générer un IBAN virtuel pour chaque réservation ;
recevoir les virements et les rapprocher automatiquement ;
exploiter les webhooks pour mettre à jour l’état du dossier.

Niveau : développeur ou intégrateur technique. Temps d’implémentation moyen : 2 heures.

Diagramme simplifié montrant l’échange entre un logiciel de réservation, l’API Elia Pay et la banque, avec création d’un IBAN virtuel, réception d’un virement client, puis mise à jour automatique du statut payé dans l’ERP.

1. Comprendre l’IBAN virtuel Elia

Un IBAN virtuel est un numéro de compte rattaché à votre compte principal, mais créé à la volée pour identifier un flux précis. Chez Elia :

l’IBAN commence par FR76 3000 (Crédit Mutuel Arkéa) ;
il existe aussi longtemps que votre réservation est active ;
chaque virement reçu est automatiquement tagué avec le champ reference_id que vous avez fourni.

Concrètement, vous gagnez :

100 % d’automatisation du rapprochement ;
la traçabilité complète vis-à-vis d’Atout France et de votre assureur garantie financière ;
moins de frais qu’un compte bancaire supplémentaire.

2. Pré-requis techniques

Un compte Elia Pay avec droits administrateur.
Votre clé « Live » (nous commencerons en mode Sandbox).
Un point d’écoute HTTPS (webhook) exposé publiquement.
Votre logiciel de réservation ou votre ERP maison.

Si vous cherchez encore une solution de back-office, jetez un œil à notre article « Les outils SaaS indispensables pour gérer une agence de voyage ».

3. Étape 1 : créer et sécuriser votre clé API

Connectez-vous au tableau de bord Elia > Paramètres > API.
Cliquez sur « Nouvelle clé Sandbox ». Choisissez les scopes :
- iban:create
- iban:read
- transaction:read
- webhook:manage
Notez la clé et stockez-la dans un coffre (AWS Secrets Manager, Vault…).
Restreignez votre IP pour limiter le risque de fraude.

Exemple d’appel de test

curl -X GET \
  -H "Authorization: Bearer SANDBOX_KEY" \
  https://api.eliapay.com/v1/ping

Réponse attendue :

{"status":"ok","environment":"sandbox"}

4. Étape 2 : générer un IBAN virtuel pour chaque dossier

Dès qu’un devis est accepté par le client, votre système appelle :

POST /v1/virtual-ibans

Payload minimal :

{
  "reference_id": "RES-4582",          // votre ID de réservation
  "label": "Circuit Costa Rica 12j",   // visible sur le RIB PDF
  "expiry_date": "2025-12-15"          // optionnel
}

Réponse :

{
  "iban": "FR76 3000 6000 0000 0101 2345 678",
  "bic": "CMCIFRPP",
  "reference_id": "RES-4582"
}

Stockez l’IBAN dans votre base et affichez-le sur la facture client. Si vous utilisez un CRM comme MyTravel Office, vous pouvez injecter le champ via l’API public « custom fields » de l’éditeur.

5. Étape 3 : activer le rapprochement automatique

Pour chaque virement reçu, Elia poste un événement payment.received. Si le virement est supérieur ou égal au solde du dossier, vous pouvez passer le statut à « Payé ». Exemple de payload :

{
  "event": "payment.received",
  "data": {
    "reference_id": "RES-4582",
    "amount": 2940.50,
    "currency": "EUR",
    "sender_name": "M DUPONT JEAN"
  }
}

Exemple de handler Node.js

app.post('/elia/webhook', async (req, res) => {
  const sig  = req.headers['elia-signature'];
  if (!verifySignature(req.rawBody, sig, ELIA_WEBHOOK_SECRET)) {
    return res.status(400).send('invalid');
  }

  const {event, data} = req.body;
  if (event === 'payment.received') {
    await Reservation.updateStatus(data.reference_id, 'Payé');
  }
  res.send('ok');
});

6. Étape 4 : gérer les remboursements et les ajustements

Parfois un client paie trop ou annule partiellement. Deux options :

Remboursement SEPA via l’endpoint POST /v1/payouts.
Transfert interne vers votre compte principal et affectation manuelle.

Elia calcule automatiquement la commission interchange et le cashback voyage (jusqu’à 1 %) lorsque le paiement concerne un fournisseur référencé IATA.

7. Bonnes pratiques de conformité et de sécurité

Activez la double signature sur les virements sortants de plus de 5 000 €.
Tenez votre registre de bénéficiaires à jour pour rester conforme à la directive européenne sur le blanchiment.
Enregistrez les webhooks dans deux régions cloud pour une haute disponibilité.
Testez le plan de reprise tous les 6 mois (simulation de défaillance bancaire).

Écran d’ordinateur montrant un tableau de bord Elia Pay avec la liste des IBAN virtuels, indicateur vert “reçu”, et graphique de cash-flow positif. Le bureau est celui d’une petite agence de voyage, affiches de destinations en arrière-plan.

8. Cas d’usage : packages vs circuits sur mesure

Packages vols + hôtels
- Un seul IBAN virtuel par dossier.
- Réconciliation unique quand la facture est soldée.
Circuits multi-fournisseurs
- IBAN virtuel par sous-dossier (vols, hébergement, activités).
- Vous déclenchez des paiements fournisseurs dès que la branche correspondante est créditée.

Résultat : vous réduisez la trésorerie immobilisée et améliorez la marge nette.

9. Prochaines étapes

Passez en mode Live lorsque tous vos tests unitaires sont verts.
Activez la fonctionnalité Rapprochement bancaire automatique dans votre module comptable. Elle s’appuie sur le champ reference_id pour pré-lettrer vos écritures dans Sage ou Pennylane.
Explorez nos cartes virtuelles pour régler les hôtels sans avancer de fonds.

Foire aux questions (FAQ)

Puis-je créer un IBAN virtuel sans date d’expiration ?
Oui, l’IBAN reste actif tant que le compte principal est ouvert. Nous recommandons toutefois de supprimer les IBAN inutilisés pour garder votre interface claire.

Quel est le délai de réception des fonds ?
Les virements SEPA créditent votre IBAN virtuel sous 24 h ouvrées en moyenne. Un webhook est émis dès que la banque confirme la réception.

Comment sont facturés les IBAN virtuels ?
La création est gratuite. Des frais fixes de 0,10 € sont prélevés par virement reçu, dégressifs au-delà de 1 000 opérations/mois.

L’API est-elle compatible avec Zapier ou Make ?
Oui. Un connecteur Elia officiel est disponible sur Zapier. Il permet de déclencher un Zap à chaque payment.received.

Je ne suis pas développeur ; puis-je quand même utiliser la fonction ?
Notre équipe d’intégration peut réaliser le raccordement pour vous en 48 h. Contactez-nous via le chat du tableau de bord.

Prêt à dire adieu aux rapprochements manuels ?

Essayez Elia Pay gratuitement pendant 30 jours. Ouvrez votre compte, générez votre premier IBAN virtuel et constatez le temps gagné dès la première réservation.

Créer mon compte test