Relier Stripe à votre logiciel métier, votre ERP ou votre comptabilité

Que peut faire votre logiciel avec l'API Stripe ?

L'API Stripe permet à un logiciel métier de créer des paiements, des clients, des abonnements et des factures, de rembourser et de lire les virements reçus ; Stripe informe en retour votre application par des événements. Selon sa documentation de référence, l'API Stripe suit les principes REST, accepte des corps de requête encodés comme un formulaire et renvoie du JSON. Elle ne permet pas de mise à jour en masse : chaque requête porte sur un seul objet, ce qui compte quand on reprend des milliers de fiches clients.

Stripe publie des bibliothèques officielles pour Ruby, Python, PHP, Java, Node.js, Go et .NET. Depuis la version 2024-09-30.acacia, Stripe sort une version d'API par mois sans changement cassant et deux versions majeures par an qui peuvent en contenir (version courante en octobre 2026 : 2026-09-30.endive). Une intégration fixe donc sa version d'API et se revoit à chaque version majeure.

Clés d'accès, bac à sable et limites publiées par Stripe

L'accès à l'API Stripe se fait par clé d'API, de trois types utiles à une PME :

• Clé publiable (pk_) : la seule exposable dans un navigateur ou une application mobile ; elle ne permet ni d'encaisser ni de lire les données du compte.
• Clé restreinte (rk_) : une clé serveur dont on choisit les droits. Stripe la recommande pour la plupart des usages.
• Clé secrète (sk_) : un accès sans restriction à toute l'API, que Stripe déconseille pour les nouveaux usages.

Chaque compte Stripe dispose d'un mode production et de bacs à sable (sandboxes), chacun avec ses propres clés ; dans un bac à sable, aucun paiement n'est traité par les réseaux de cartes. Stripe permet d'inviter un prestataire sur un bac à sable sans lui ouvrir les données de production.

Ces plafonds laissent de la marge à une PME, mais un script de reprise de données peut les atteindre : Stripe répond alors par une erreur 429, que le connecteur absorbe en espaçant ses nouvelles tentatives.

Cinq flux Stripe que l'on branche le plus souvent en PME

1. Devis accepté, lien de paiement, commande lancée. Le devis validé dans le logiciel métier crée une session de paiement Stripe dont le lien part au client. Quand le paiement aboutit, le webhook reçoit l'événement ; le logiciel vérifie la signature, relit le paiement, passe la commande en « payée » et prévient l'atelier.
2. Abonnement de maintenance ou d'accès. Le contrat signé dans le CRM crée le client et l'abonnement chez Stripe ; chaque facture émise remonte dans le logiciel, et un paiement refusé ouvre une tâche de relance. Voir notre page pour automatiser les relances d'impayés.
3. Remboursement depuis le back-office. Le retour saisi dans l'outil interne crée un remboursement partiel chez Stripe, avec une clé d'idempotence, puis met à jour l'avoir, sans accès au tableau de bord Stripe.
4. Rapprochement des virements. Stripe reverse les fonds par virements (objets Payout, lisibles par l'API). Le logiciel associe chaque virement aux paiements encaissés sur la période et prépare les écritures pour l'expert-comptable, ce qui supprime l'essentiel du pointage manuel.
5. Place de marché ou réseau de vendeurs. Quand l'argent doit être réparti entre plusieurs vendeurs, Stripe Connect entre en jeu : voir notre guide paiements de plateforme avec Stripe.

Webhooks, doublons, reprise : ce que l'intégration doit garantir

Un webhook Stripe n'est fiable que si votre logiciel le vérifie, le dédoublonne et sait rattraper ce qu'il a manqué. Les règles de la documentation Stripe :

• Vérifier la signature de l'en-tête Stripe-Signature, sur le corps brut de la requête, avec le secret propre à chaque point de réception (il commence par whsec_). Sans elle, n'importe qui pourrait simuler un paiement réussi.
• Répondre tout de suite par un code 2xx, puis traiter l'événement dans une file d'attente.
• Écarter les doublons : un même événement peut arriver deux fois, il faut donc conserver les identifiants déjà traités.
• Rattraper les pannes : Stripe renvoie les événements non délivrés pendant trois jours au maximum, et la liste des événements ne remonte que 30 jours en arrière.
• Rejouer sans double débit : une création envoyée avec une clé d'idempotence (255 caractères au plus) peut être répétée après une coupure réseau sans créer un second objet.

Côté sécurité, Stripe recommande de ranger les clés serveur dans un coffre de secrets, jamais dans le code ; des politiques d'accès limitent une clé à des adresses IP connues, et une rotation laisse jusqu'à 7 jours de chevauchement entre ancienne et nouvelle clé. Avec Checkout, Payment Links ou les composants Elements, la carte est saisie dans des éléments fournis par Stripe et votre logiciel ne manipule que des identifiants ; il conserve en revanche noms, adresses et historique de paiement, à inscrire dans le registre des traitements comme le rappelle notre guide RGPD et logiciel métier.

Faut-il développer, ou les outils sans code de Stripe suffisent-ils ?

Avant de coder, regardez ce que Stripe fait seul : Payment Links crée une page de paiement partageable par lien, QR code ou bouton, et la facturation Stripe (Invoicing) envoie des factures payables en ligne avec relances automatiques. Selon la documentation Stripe, ces deux produits proposent plus de 40 moyens de paiement et plus de 30 langues sans code.

Côté coûts, l'offre standard de Stripe ne comporte ni frais d'installation ni abonnement mensuel : la commission est prise à chaque transaction, par exemple 1,5 % + 0,25 € pour une carte standard de l'Espace économique européen et 0,35 € par prélèvement SEPA (tarif public relevé en octobre 2026). Stripe Billing, pour les abonnements, ajoute 0,7 % du volume traité en formule à l'usage (tarif public relevé en octobre 2026).

Comment YMHB Web relie Stripe à votre logiciel

Stripe fait partie des technologies habituelles de YMHB Web. Sur la boutique de pièces Peugeot Motocycles réalisée pour APARO, le paiement Stripe est vérifié deux fois côté serveur, et le concessionnaire envoie un lien de paiement complémentaire ou rembourse partiellement en un clic. Sur Garage Connect, les abonnements des garages passent par Stripe, factures PDF comprises.

Nous cadrons d'abord les flux (qui crée le client, quel outil fait foi sur le montant, que faire d'une carte refusée), puis nous chiffrons. Le développement se fait dans un bac à sable de votre compte Stripe, la recette rejoue les cas d'erreur, puis le connecteur passe sur les clés de production. Ce qui vous est remis :

• le code du connecteur, déposé chez vous et documenté, avec la correspondance entre vos identifiants et ceux de Stripe ;
• un compte Stripe et des clés restreintes à votre nom, jamais au nôtre ;
• un journal de chaque événement reçu et de chaque appel envoyé, avec une alerte en cas d'échec ;
• une revue de la version d'API à chaque version majeure de Stripe, dans le cadre de la maintenance évolutive.

Quand Stripe n'est qu'un maillon parmi l'ERP, le CRM et la comptabilité, voir notre page connecter ses logiciels par API.