Qu'est-ce qu'une passerelle de paiement ? Fonctionnement des paiements en ligne

Une passerelle de paiement est le service qui recueille en toute sécurité les coordonnées de paiement d'un client à la caisse, les transmet aux banques et aux réseaux de cartes pour approbation, et renvoie une réponse « acceptée » ou « refusée » — en général en quelques secondes. C'est le pont entre votre application et le système financier. Stripe, PayPal, Adyen, Square et Braintree en sont des exemples bien connus.

Aujourd'hui, la plupart de ces entreprises regroupent la passerelle avec tout ce dont vous avez besoin pour encaisser, si bien que « passerelle de paiement », « processeur de paiement » et « fournisseur de paiement » désignent souvent la même chose.

Pourquoi les passerelles de paiement comptent quand on construit avec l'IA

« Ajouter des paiements » est l'une des demandes les plus fréquentes adressées aux créateurs par IA, et l'une des plus faciles à mal faire, subtilement. Le code lui-même est généralement court. Ce qui compte, ce sont les décisions qui l'entourent :

• Quel fournisseur convient à votre activité, à votre pays et à ce que vous vendez.
• Où le code s'exécute. Les clés secrètes de paiement doivent rester sur le serveur, jamais dans le navigateur.
• Comment votre application apprend qu'un paiement a réussi. La méthode fiable passe par un webhook envoyé par le fournisseur — et non par le client qui arrive sur une page « merci ».
• Vos responsabilités juridiques et fiscales, qui dépendent de qui est le marchand officiel.

Comprendre ce que fait une passerelle vous aide à donner des instructions claires et à vérifier que le résultat est sûr.

Une analogie du quotidien

Pensez au paiement par carte dans un magasin.

Le terminal de carte sur le comptoir est la passerelle : il lit votre carte en toute sécurité et envoie la demande. Il ne décide de rien — il transmet la question « cette personne peut-elle payer 40 € ? » le long d'une chaîne jusqu'à votre banque, puis rapporte la réponse. La banque du commerçant (acquéreur) et votre banque (émetteur) prennent la décision, par l'intermédiaire du réseau de cartes (Visa, Mastercard) qui les relie.

Une passerelle de paiement en ligne, c'est ce terminal, reconstruit pour le web, avec en plus la sécurité nécessaire pour traiter des données de carte qui arrivent par Internet.

Comment fonctionne un paiement par carte en ligne

Voici ce qui se passe dans les quelques secondes qui suivent le clic sur « Payer » :

Deux points méritent d'être connus :

• L'autorisation n'est pas la même chose que le paiement. Le montant est d'abord réservé, puis capturé, puis versé sur votre compte — souvent quelques jours plus tard.
• Votre application ne devrait jamais voir le numéro de carte. Les fournisseurs modernes proposent une page de paiement hébergée ou des champs intégrés qu'ils contrôlent, et votre application ne reçoit qu'une référence au paiement.

Les principaux éléments, et qui s'en occupe

Certains fournisseurs (Paddle, Lemon Squeezy) agissent eux-mêmes comme marchand officiel, en gérant pour vous la TVA et les taxes de vente, en échange de frais plus élevés. D'autres (Stripe, PayPal) vous laissent marchand officiel, avec des outils fiscaux facultatifs. Pour un comparatif équilibré des options, voir Stripe vs Paddle vs Lemon Squeezy et Stripe vs PayPal.

Un exemple concret : vendre une formation

Vous vendez une formation en ligne à 99 € et demandez à votre créateur par IA d'ajouter un bouton « Acheter ».

1. Le client clique sur Acheter. Votre serveur utilise sa clé secrète pour demander au fournisseur de créer une session de paiement de 99 € et reçoit en retour un lien.
2. Le client est envoyé sur la page de paiement hébergée du fournisseur, saisit sa carte et valide l'éventuelle vérification 3D Secure auprès de sa banque.
3. Le paiement est accepté, et le client est redirigé vers votre page de « succès ».
4. Séparément, le fournisseur envoie un webhook à votre serveur : « le paiement de la session X a réussi ». Votre serveur vérifie la signature du webhook, retrouve la commande, la marque comme payée et débloque la formation.
5. Quelques jours plus tard, l'argent, déduction faite des frais, arrive sur votre compte bancaire.

L'étape 4 est la plus importante. Si vous débloquiez la formation sur la page de succès, n'importe qui ayant trouvé cette URL l'obtiendrait gratuitement, et les clients dont le navigateur s'est fermé trop tôt paieraient sans rien recevoir.

Termes clés

Idées reçues courantes

• « Je dois stocker les numéros de carte pour facturer à nouveau les clients. » Non. Les fournisseurs conservent la carte et vous donnent une référence (jeton) pour les prélèvements répétés et les abonnements. Vous ne devriez jamais stocker vous-même les numéros de carte.
• « La page de succès prouve que le paiement a fonctionné. » Confirmez les paiements par webhooks, côté serveur. Les redirections peuvent être sautées, falsifiées ou ne jamais avoir lieu.
• « Tous les fournisseurs de paiement coûtent à peu près pareil. » Les frais varient selon le fournisseur, le pays, le type de carte et selon que la gestion fiscale est incluse. Consultez la page tarifaire actuelle de chaque fournisseur pour votre pays.
• « Utiliser Stripe me rend conforme PCI. » Cela simplifie beaucoup les choses, car les données de carte restent chez le fournisseur — mais vous devez toujours remplir une auto-évaluation, en général courte.
• « Le mode test et le mode réel se comportent à l'identique. » Ils sont proches, mais le mode réel exige un compte entièrement vérifié, des points de terminaison de webhook configurés pour l'environnement réel, et de vraies coordonnées bancaires.
• « Une passerelle de paiement gère mes taxes. » Seulement si elle est marchand officiel, ou si vous activez et configurez ses outils fiscaux. Vérifiez les règles locales ou demandez à un conseiller.

Ce qu'il faut demander à votre créateur par IA

• « Ajoute Stripe Checkout pour [produit]. Crée la session côté serveur, avec la clé secrète lue depuis une variable d'environnement. »
• « Marque une commande comme payée uniquement à partir d'un webhook vérifié, et contrôle la signature du webhook. »
• « Gère le cas où le webhook est envoyé deux fois sans créer de commandes en double. »
• « Utilise les clés du mode test et explique-moi comment tester avec les cartes de test du fournisseur, y compris une carte refusée. »
• « Que se passe-t-il si le client ferme l'onglet après avoir payé ? »
• « Montre-moi chaque endroit où une clé de paiement est utilisée, et confirme que la clé secrète n'atteint jamais le navigateur. »

Passerelles de paiement dans Mythex

Mythex n'inclut pas de paiements intégrés pour les applications que vous créez, et il n'existe pas de bouton « Connecter Stripe » en un clic. Vous créez un compte chez le fournisseur de votre choix, vous ajoutez ses clés de test comme secrets du projet, et vous demandez à l'agent de construire le paiement côté serveur. Testez dans l'aperçu avec les cartes de test du fournisseur, puis publiez. La documentation détaille cette démarche dans Accepter des paiements avec Stripe, et Webhooks explique l'étape de confirmation.

Pour une construction pas à pas, voir comment ajouter des paiements à votre application et, pour la facturation récurrente, comment ajouter des abonnements avec Stripe.

Questions