Connectez vos propres systèmes à TransferGo et récupérez votre historique de transactions automatiquement — plus besoin de vous connecter pour vérifier.
Que sont les API TransferGo Business et que puis-je en faire ?
Nous ajoutons un nouveau moyen de se connecter à TransferGo : les API TransferGo Business. Cela permet à votre entreprise de récupérer votre historique de transactions directement depuis vos propres systèmes — plus besoin de vous connecter au Portail à chaque fois que vous souhaitez vérifier vos paiements.
Cela est particulièrement utile si :
- Vous rapprochez régulièrement vos paiements : importez vos données de transaction directement dans votre propre logiciel de comptabilité ou ERP (Enterprise Resource Planning / Progiciel de gestion intégré).
- Vous disposez d'une équipe de développeurs : connectez-vous une seule fois et laissez vos systèmes faire les vérifications à votre place.
Pour l'instant, cette fonctionnalité ne concerne que la consultation de l'historique de votre compte. La possibilité d'effectuer des paiements via l'API sera disponible dans le courant de l'année ; nous vous tiendrons informés dès qu'elle sera opérationnelle.
Pour découvrir toutes les fonctionnalités de l'API, consultez la documentation destinée aux développeurs.
Comment commencer à connecter mes systèmes à l’API TransferGo Business ?
- Ouvrir les intégrations API : Connectez-vous à TransferGo Business et cliquez sur Intégrations API dans le menu de gauche.
- Démarrer la connexion : Cliquez sur Accepter et créer une connexion API.
- Accepter les conditions : La création d'une connexion API nécessite d'accepter nos Conditions générales mises à jour.
Vous n'êtes pas le titulaire du compte ? Vous ne pourrez pas confirmer cette étape vous-même — consultez l'article suivant pour savoir quoi faire.
Approuver une connexion API en tant que titulaire du compte
Si un membre de l'équipe commence à configurer une connexion API mais n'est pas le titulaire du compte, il aura besoin de votre approbation avant que celle-ci ne soit activée.
- Recevoir le lien de confirmation : Le membre de votre équipe vous enverra un lien pour confirmer la connexion.
- Vérifier et accepter : Ouvrez le lien et acceptez les Conditions générales mises à jour.
- Terminé : Une fois la confirmation effectuée, le membre de votre équipe peut poursuivre la configuration du certificat et la connexion de ses systèmes.
Comment générer mon certificat et me connecter ?
Une fois votre connexion confirmée, vous devrez configurer un certificat client permettant à vos systèmes de se connecter en toute sécurité, puis l'utiliser pour obtenir un jeton d'accès.
Points clés à retenir :
- Votre clé privée est générée sur votre propre machine et ne la quitte jamais.
- Les certificats sont valables pendant 1 an.
- Les jetons d'accès ont une durée de vie de 5 minutes ; il est donc recommandé de les mettre en cache et de les réutiliser plutôt que d'en demander un nouveau à chaque appel.
- Le téléchargement de votre demande de signature de certificat (CSR) est une étape sensible ; il vous sera donc demandé de la confirmer à l'aide de votre mot de passe.
Comment procéder :
- Ouvrez Intégrations API et suivez le guide Comment se connecter correspondant à votre système d'exploitation (Windows ou macOS/Linux).
- Suivez les étapes indiquées pour générer votre certificat, puis obtenez un jeton d’accès et testez votre connexion.
Vous êtes bloqué en cours de route ? Un lien J’ai besoin d’aide est disponible sur l’écran de configuration.
Pour connaître les commandes exactes, les détails du certificat et les demandes de jeton, consultez le guide Authentification et autorisation.
Comment gérer mes certificats API ?
Vous pouvez gérer vos certificats à tout moment depuis la rubrique « Intégrations API ».
A. Télécharger votre certificat
- Allez dans Intégrations API.
- Trouvez votre certificat dans le tableau et cliquez sur Télécharger .CRT.
B. Ajouter un certificat secondaire
- Allez dans Intégrations API.
- Cliquez sur Ajouter un certificat secondaire.
Cela est utile si vous souhaitez qu'un certificat de secours soit prêt avant l'expiration de votre certificat principal.
C. Révoquer un certificat
- Allez dans Intégrations API.
- Trouvez le certificat que vous souhaitez supprimer et cliquez sur l'icône de révocation à côté de celui-ci.
- Confirmez la suppression.
Une fois révoqué, ce certificat ne peut plus être utilisé pour se connecter — assurez-vous que vos systèmes ne s'appuient pas dessus avant de le révoquer.
Point essentiel à retenir : les certificats ont une durée de validité d'un an. Pour effectuer une rotation sans interruption de service, ajoutez un certificat secondaire avant l'expiration de votre certificat principal, basculez vos systèmes vers ce dernier, puis révoquez le certificat principal.
Pour en savoir plus sur l'expiration et la rotation des certificats, consultez la section « Expiration et rotation des certificats ».
Quelles informations puis-je récupérer via l'API TransferGo Business ?
Une fois connecté, vous pouvez importer l'historique de votre compte directement dans vos propres systèmes. Cela inclut les virements et les recharges, ainsi que les opérations de change, les dépôts et retraits d'épargne, les intérêts et les ajustements de solde.
Pour chaque transaction, vous obtiendrez des détails tels que son statut, la date et l'heure, les montants et les devises, les frais, vos références, ainsi que les coordonnées de l'expéditeur et du bénéficiaire, les numéros de carte étant masqués pour des raisons de sécurité.
Les résultats sont paginés et filtrables, ce qui permet de charger les historiques volumineux par tranches gérables.
Cette fonctionnalité est pour l’instant en mode lecture seule : vous pouvez récupérer des données, mais vous ne pouvez pas encore effectuer de paiements via l’API. Cette fonctionnalité est prévue pour plus tard dans l’année.
Pour obtenir la liste complète des champs, des statuts et des options de filtrage, consultez la documentation sur les transactions.