Que pouvez-vous faire avec l'API iBanFirst ?
Notre API vous permet de :
Ouvrir des comptes supplémentaires dans 24 devises
Traiter des ordres de paiement à grande échelle avec ou sans conversion de devises
Suivre les paiements SWIFT avec des liens de suivi de paiement automatisés
Exécuter des opérations de change – Obtenez des cotations en temps réel et exécutez des opérations de change au comptant entre vos comptes en devises
Réserver des contrats de paiement à terme fixe (Fixed Forward)
Gérer les bénéficiaires – Créer et supprimer des bénéficiaires (vos comptes dans d'autres banques ou destinataires de paiement)
Accéder aux informations de compte – Récupérer les soldes, les détails de compte et les identifiants de transaction
Rapprocher les paiements – Accéder à l'historique des mouvements financiers, aux détails des transactions et télécharger des factures
Configurer des webhooks – Recevoir des notifications en temps réel sur les mises à jour de transactions (paiements en attente de signature, paiement entrant, etc.) sans avoir besoin d'interrogations périodiques
Veuillez noter : L'intégration de notre API nécessite des ressources de développement. Nous pouvons vous recommander un partenaire pour vous aider dans l’intégration.
Comptes :
Puis-je ouvrir des comptes de manière autonome via l'API ?
L'ouverture de compte via l'API suit les mêmes règles que la Plateforme :
Premier compte dans une nouvelle devise : cela nécessite l'approbation d'un Account Manager. Contactez votre AM pour discuter de vos besoins avant que la devise puisse être activée.
Compte supplémentaire dans une devise existante : Totalement autonome. Le compte est créé instantanément via l'API sans approbation manuelle requise.
Effectuer des paiements :
L'API peut-elle initier un paiement avec conversion de devises ?
Oui, l'API et la Plateforme prennent en charge les paiements avec conversion.
Combien de paiements puis-je initier en utilisant l'API ?
Vous pouvez envoyer des ordres de paiement un par un, toutes les 2 secondes (pour éviter les dépassements de délai).
L'API peut-elle gérer les flux de travail multi-signatures ? ;
Les signatures doivent être complétées sur la Plateforme ; cependant, les paiements créés via l'API déclencheront le flux de multi-signatures. Le nombre de signatures requises est cohérent sur tous les canaux (Plateforme et API).
Le suivi des paiements est-il disponible via l'API ?
Oui, un lien de suivi pour les paiements SWIFT est disponible. Si vous fournissez l'adresse e-mail du bénéficiaire, le Payment Tracker lui sera envoyé automatiquement.
Puis-je ajouter des bénéficiaires via l'API ?
Oui, avec une étape supplémentaire d'approbation de sécurité effectuée par iBanFirst, ainsi qu'une vérification lors du premier paiement vers tout nouveau bénéficiaire.
La vérification du bénéficiaire (VOP/COP) est facultative et peut être activée pour la création de bénéficiaires et la création de paiements. Veuillez noter que le processus de vérification peut prendre jusqu'à 8 secondes.
Comment puis-je envoyer une facture ou une preuve de transaction pour un paiement ?
Pour automatiser entièrement les paiements, vous pouvez encoder la facture au format binaire et l'inclure dans le champ API dédié, éliminant ainsi le besoin de téléchargements ultérieurs.
Contrat de paiement à terme (Forward) :
Quel type de contrat de paiement à terme puis-je réserver ?
Des contrats à terme fixes, avec les limitations suivantes :
disponibles pour 10 devises (dollar australien, dollar canadien, franc suisse, euro, livre sterling, yen japonais, couronne norvégienne, dollar néo-zélandais, couronne suédoise, dollar américain) (AUD, CAD, CHF, EUR, GBP, JPY, NOK, NZD, SEK, USD),
avec des échéances allant jusqu'à 1 an, et une limite de transaction de 1M EUR équivalent par transaction.
Quelles sont les conditions requises pour utiliser les contrats à terme fixes (Fixed Forward) ?
Pour réserver des contrats de paiement à terme fixes, vous devez vous assurer que trois conditions préalables sont remplies : vous devez avoir l'approbation de crédit d'iBanFirst, avoir une garantie initiale en place et avoir accepté la clause de non-responsabilité relative aux contrats à terme autonomes sur la Plateforme.
Rapprochement des paiements :
Puis-je récupérer les relevés de compte au format MT940, pour le rapprochement des paiements ?
Non, mais vous pouvez accéder aux confirmations de paiement détaillées et à l'historique des transactions. L'API peut également récupérer votre solde à une date spécifique.
Quels types de données puis-je récupérer via l'API ?
Vous pouvez récupérer les coordonnées bancaires, télécharger et charger les identifiants de bénéficiaires et les factures, et accéder à l'historique de vos mouvements financiers.
Notification :
Puis-je recevoir des notifications pour les opérations ?
Oui, via les abonnements webhook, vous pouvez recevoir des notifications en temps réel pour un ou plusieurs types d'événements
par exemple : paiements en attente de signature, finalisés, annulés ou bloqués, transactions au comptant, transactions à terme et paiement entrant
Si une notification webhook échoue, jusqu'à 3 tentatives de livraison seront effectuées par événement.
Démarrage :
Comment créer des identifiants pour mon développeur?
Vous pouvez générer de manière autonome un token pour les actions en "lecture seule" via Paramètres > Utilisateurs > Services.
Pour créer un token avec des permissions d'écriture et des droits avancés, veuillez contacter votre Customer Success Manager.
Comment configurer une intégration avec l'API REST iBanFirst ?
La documentation développeur est disponible ici : Documentation de l'API iBanFirst →
Puis-je utiliser l'API iBanFirst sur un site web ?
Oui, l'API peut être utilisée dans des applications front-end et back-end. Nous recommandons de déployer un modèle "Backend For Frontend". Nous prenons en charge le partage de ressources cross-origin (CORS) pour permettre une interaction sécurisée avec l'API depuis des applications web côté client.