CIIFragments Studio est agréée CII : récupérez jusqu'à 20 % de vos dépenses en développement logicielEn savoir plus

Intégration API Qonto

Nous développons votre connecteur Qonto

Nous relions votre produit à l'API Qonto pour récupérer vos transactions, rapprocher vos factures et déclencher vos virements sans saisie manuelle.

  • Équipe produit senior
  • intégrations bancaires en production
  • du cadrage au monitoring
En bref

À quoi sert l'API Qonto et pourquoi connecter sa banque professionnelle à son logiciel ?

Qonto est une banque professionnelle en ligne utilisée par des centaines de milliers d'entreprises françaises. Son API permet à votre application de lire les comptes, les transactions et les pièces justificatives, et de déclencher des virements. On l'intègre pour automatiser le rapprochement bancaire dans un outil comptable, alimenter un tableau de trésorerie en temps réel, ou déclencher une action dans votre logiciel dès qu'un règlement client est reçu. L'accès peut être limité à votre propre compte Qonto ou ouvert à vos clients via OAuth, si vous connectez les comptes de plusieurs entreprises.

Cas d'usage

Ce que nos clients construisent sur l'API Qonto

01

Rapprochement bancaire automatique

Chaque paiement reçu est associé à la bonne facture dans votre outil. Vos équipes arrêtent de pointer des lignes à la main en fin de mois.

02

Tableau de bord de trésorerie temps réel

Soldes, encaissements et décaissements consolidés dans votre application, avec projection à trente ou soixante jours.

03

Relances de paiement déclenchées par la banque

Dès que l'encaissement est détecté, la séquence de relance s'arrête. Vous ne relancez plus un client qui a déjà payé.

04

Chaîne banque vers comptabilité

Les opérations Qonto alimentent Pennylane ou votre logiciel comptable, avec les justificatifs attachés. Un seul flux, deux outils à jour.

Pour vous

Ce que ça change dans votre gestion

La technique au service d'un résultat mesurable : moins de saisie, une trésorerie lisible, une clôture plus rapide.

Fini la double saisie

Les données bancaires arrivent seules dans vos outils. Le temps passé à recopier des relevés disparaît du planning de vos équipes.

Une trésorerie que vous voyez venir

Vos soldes et vos encaissements sont à jour en permanence, pas à J+15. Vous décidez sur des chiffres actuels.

Moins d'erreurs, moins de litiges

Le rapprochement automatique élimine les écarts de saisie et les relances envoyées à tort, qui coûtent surtout de la relation client.

Une clôture plus courte

Les justificatifs sont déjà rattachés quand le comptable arrive. Les allers-retours de fin de mois se réduisent nettement.

Méthode

Comment nous livrons votre connecteur Qonto

01

Cadrage

Quels flux, quel volume, quelle fréquence, quel mode d'authentification. On liste les cas limites avant d'écrire une ligne de code.

02

Développement

Connecteur typé, gestion du débit limité, file de reprise sur erreur, secrets isolés. Démonstration chaque semaine.

03

Recette

Rejeu de vos données réelles, contrôle des écarts au centime, test des scénarios de panne côté API.

04

Monitoring

Alertes sur échec de synchronisation, journal des appels, tableau de bord de santé du connecteur. Vous savez qu'un flux est cassé avant vos clients.

Ce que permet l'API

Ce que permet l'API Qonto

Comptes et soldes
Lecture des comptes bancaires de l'organisation, avec solde autorisé et solde comptable distincts. La base de tout tableau de bord de trésorerie.
Transactions et pièces jointes
Historique des opérations, filtrable par compte, statut et période. Chaque transaction porte ses justificatifs, ses étiquettes et sa catégorie de flux.
Virements et demandes
Création de virements uniques ou multiples, et de demandes soumises à validation. Un virement reste toujours confirmé par un humain avec sa double authentification.
Webhooks et facturation client
Notification en temps réel des nouvelles opérations, plus la gestion des factures clients, devis et avoirs émis depuis Qonto.
Lexique

Le vocabulaire de l'API Qonto

Scope OAuth
Permission nommée attachée à un jeton (organization.read, payment.write, card.write). Qonto en documente 29 : une intégration propre ne demande que celles dont elle a besoin, et cette liste est opposable à un DSI.
transactions.created
Événement du webhook des transactions, émis à l'apparition d'une opération. C'est lui qui déclenche le rapprochement, à la place d'une relecture périodique de l'API.
Clé d'idempotence
En-tête qui garantit qu'un même ordre rejoué ne crée pas deux virements. La réponse est mémorisée 30 minutes : au delà, un rejeu crée une nouvelle ressource, donc la file de reprise a besoin de son propre verrou.
SCA
Authentification forte du client, imposée par la DSP2. Certaines opérations (virement international, bénéficiaire de confiance, plafond de carte) ne peuvent pas être validées par un automate.
Révocation de consentement
Événement émis quand un client coupe l'accès accordé à votre application. Le traiter évite de découvrir la coupure par une série de refus d'authentification en production.
QSealC
Certificat de cachet électronique exigé si vous intervenez comme prestataire tiers au sens DSP2, avec signature des requêtes. Hors de ce cas, la clé API ou OAuth suffit.
À savoir

Les contraintes réelles de l'API Qonto

01

Deux modes d'authentification, deux usages

La clé API convient à votre propre organisation. Pour accéder aux comptes de vos clients, il faut passer par OAuth 2.0 et déclarer votre application auprès de Qonto.

02

Débit limité et pagination

L'API applique une limitation de débit et pagine les listes de transactions. Une synchronisation d'historique se conçoit par lots avec reprise sur erreur, pas en une seule requête.

03

Aucun virement sans validation humaine

L'API crée des virements et des demandes, mais la validation finale passe par l'authentification forte d'un utilisateur habilité. C'est une contrainte réglementaire, pas un défaut : à intégrer dans le parcours dès la conception.

04

La donnée bancaire impose un cadre

Chiffrement au repos et en transit, journalisation des accès, cloisonnement des secrets, durée de conservation définie. Nous posons ce cadre au cadrage, pas après la mise en production.

Qonto ou agrégation

API Qonto ou agrégation bancaire ?

Deux chemins pour lire des comptes depuis votre application. Le bon dépend de qui détient les comptes, pas de la technique.

CritèreAPI QontoAccès directAgrégation DSP2Bridge, Powens, Tink
Banques couvertesComptes Qonto uniquementLa plupart des banques françaises
Richesse des donnéesÉtiquettes, catégories de flux, justificatifs attachésLibellé, montant, date, rarement la pièce
Virements sortantsOui, unitaires et en masseVariable selon le fournisseur et la banque
Temps réelOui, webhooks signésRafraîchissement périodique
Renouvellement d'accèsJeton renouvelé côté serveurConsentement à renouveler régulièrement
Coût d'accèsInclus dans l'offre QontoAbonnement au fournisseur d'agrégation
Le bon casTous vos comptes sont chez QontoVos utilisateurs sont dans des banques différentes

Les deux se combinent : l'API Qonto pour vos propres comptes, l'agrégation pour ceux de vos clients. C'est un arbitrage de cadrage, pas un choix définitif.

Notre expertise

Ce que nous mesurons sur une intégration Qonto

15 j
premier flux Qonto en production
100 %
des opérations rapprochées automatiquement visées
< 1 min
latence entre l'opération bancaire et votre application
4
développeurs seniors sur le projet
Comparer

Les autres API bancaires

Si tous vos comptes ne sont pas chez Qonto, ces options se discutent au cadrage.

On combine Qonto avec

La stack qui entoure Qonto sur nos projets.

  • Pennylane
  • Stripe
  • n8n
  • PostgreSQL
  • Node.js
FAQ

Intégration Qonto : vos questions

Trois étapes : générer les accès dans votre espace Qonto (identifiant et clé secrète, ou application OAuth si vous connectez des comptes tiers), construire un connecteur qui lit les comptes et les transactions en gérant la pagination et la limitation de débit, puis brancher les webhooks pour recevoir les nouvelles opérations en temps réel plutôt que d'interroger l'API en boucle. La partie sensible n'est pas l'appel API, c'est la reprise sur erreur et le rapprochement des données avec votre modèle métier.

Un premier flux utile, typiquement la synchronisation des transactions vers un tableau de bord, se livre en deux à trois semaines. Une chaîne complète avec rapprochement, justificatifs et virements demande plutôt six à huit semaines selon la complexité de votre modèle de facturation. Nous cadrons le périmètre en amont et vous donnons une estimation ferme avant de commencer.

Oui, l'API permet de créer des virements uniques ou multiples, ainsi que des demandes de virement soumises à approbation. En revanche la validation finale exige toujours l'authentification forte d'un utilisateur habilité : aucun automate ne peut sortir de l'argent seul. On conçoit donc le parcours autour de cette étape humaine.

Oui, et c'est le cas d'usage le plus demandé. Nous construisons le flux qui pousse les opérations Qonto avec leurs justificatifs vers Pennylane ou votre logiciel comptable, en gérant les correspondances de comptes et les cas d'écart.

L'API Qonto donne un accès direct et riche à vos propres comptes Qonto. Une API d'agrégation type Bridge ou Powens couvre plusieurs banques mais avec un périmètre de données plus pauvre et des reconnexions régulières imposées par la DSP2. Si tous vos comptes sont chez Qonto, l'API Qonto est le bon choix. Si vos utilisateurs sont dans des banques différentes, il faut l'agrégation.

Un projet d'intégration Qonto ?

Parlons-en. 30 minutes pour cadrer votre besoin, vérifier ce que l'API permet vraiment et vous dire franchement ce qui est faisable.

Parler de mon projet Qonto
Parler de mon projet Qonto