Skip to main content
L’intégration Stripe de Macaly vous permet d’accepter des paiements ponctuels et récurrents (abonnements) directement dans votre projet. Un environnement de test entièrement fonctionnel est provisionné automatiquement, vous pouvez donc commencer à créer et tester sans compte Stripe. Lorsque vous êtes prêt à passer en production, connectez votre compte Stripe et passez en mode live.

​
Ajouter des paiements à votre projet

Décrivez vos besoins de paiement à l’agent dans le chat. Par exemple :
L’agent crée votre projet avec un flux de paiement complet et provisionne un environnement de test Stripe en arrière-plan. Une fois la configuration terminée, un onglet Paiements apparaît dans le projet. Vous pouvez commencer les tests immédiatement en utilisant la carte de test affichée dans l’onglet Paiements : Accédez à votre projet, effectuez un achat test et vérifiez l’expérience de paiement.
Nous recommandons de parcourir le flux de paiement complet au moins une fois avant de passer en production. Vérifiez la page de succès, la gestion des erreurs et la réactivité mobile.

​
Accepter de vrais paiements

Pour commencer à traiter de vraies transactions, vous devez effectuer deux étapes : revendiquer votre bac à sable Stripe et saisir vos clés API live. Les deux se gèrent depuis l’onglet Paiements.

​
Revendiquer votre bac à sable Stripe

Lorsque Macaly provisionne un environnement de test, il crée un bac à sable Stripe qui n’est encore lié à aucun compte. Le revendiquer connecte le bac à sable à votre compte Stripe, vous permettant de recevoir de vrais paiements.
1

Ouvrez l'onglet Paiements

Ouvrez l’onglet Paiements dans votre projet. Sous « Activez votre espace de test sécurisé », vous verrez un bouton Réclamez votre bac à sable Stripe.
2

Cliquez sur Réclamez votre bac à sable Stripe

Stripe s’ouvre dans un nouvel onglet avec la page Revendiquer votre bac à sable.Si vous avez un compte Stripe existant, sélectionnez-le dans la liste. Sinon, cliquez sur + Créer un nouveau compte pour en créer un gratuitement.Cliquez sur Continuer pour poursuivre.
3

Fournissez vos informations d'entreprise

Stripe vous demandera quelques informations de base :
  1. Nom et emplacement de l’entreprise. Saisissez le nom de votre entreprise et sélectionnez votre pays. Cliquez sur Continuer.
  2. Site web et description de l’entreprise. Fournissez l’URL de votre site web et une brève description de vos produits ou services. Cette étape peut être ignorée en cliquant sur Passer pour l’instant.
  3. Utilisation prévue de Stripe. Sélectionnez les types de paiement pertinents pour votre activité (ex. paiements ponctuels ou récurrents). Cette étape peut aussi être ignorée.
4

Finalisez la configuration du bac à sable

Sur l’écran final, Stripe présente un résumé des étapes suivantes : finaliser votre configuration, passer en mode live et commencer à accepter des paiements. Cliquez sur Aller au bac à sable pour terminer.
5

Retournez dans Macaly

Revenez dans Macaly. L’onglet Paiements devrait maintenant afficher Les paiements sont en mode test en orange, confirmant que la revendication a réussi.
Les mises à jour de statut peuvent prendre quelques instants. Si le bouton de revendication est toujours visible, actualisez la page.

​
Passer en production

Lorsque vous êtes prêt à accepter de vrais paiements, vous devez activer votre compte Stripe et connecter vos clés API live à Macaly.

​
Activer votre compte Stripe

Avant de pouvoir accéder aux clés API live, Stripe exige que vous vérifiez votre entreprise. C’est un processus d’onboarding standard qui se déroule entièrement côté Stripe.
1

Ouvrez le tableau de bord Stripe

Rendez-vous sur dashboard.stripe.com et connectez-vous au compte que vous avez utilisé pour revendiquer le bac à sable.
2

Complétez le guide de configuration

Stripe vous invitera à finaliser la configuration de votre compte. Cela inclut généralement :
  • Informations sur l’entreprise (raison sociale, adresse, type d’entreprise)
  • Vérification d’identité personnelle
  • Compte bancaire ou détails de versement pour recevoir les fonds
Suivez le guide de configuration de Stripe jusqu’à ce que toutes les étapes soient marquées comme terminées.
3

Attendez la vérification

Stripe examine vos informations et active votre compte. C’est généralement instantané mais peut prendre quelques jours selon votre pays et votre type d’entreprise.Une fois vérifié, votre compte est actif et vos clés API live sont disponibles dans le tableau de bord.
Vous pouvez continuer à créer et tester votre projet en mode test en attendant que Stripe vérifie votre compte.

​
Saisir vos clés API live

Une fois votre compte Stripe vérifié, copiez vos clés live dans Macaly.
1

Copiez vos clés depuis le tableau de bord Stripe

Dans le tableau de bord Stripe, vos clés API sont affichées dans la carte Clés API à droite de la page d’accueil. Vous pouvez aussi les trouver sous Développeurs → Clés API en bas de la barre latérale.Vous verrez deux clés :
  • Clé publique commence par pk_live_.
  • Clé secrète commence par sk_live_.
Copiez les deux clés.
Votre clé secrète donne un accès complet à votre compte Stripe. Ne la partagez jamais et ne la collez jamais dans le chat.
2

Ajoutez vos clés dans Macaly

Dans l’onglet Paiements, cliquez sur Ajouter une connexion Stripe. Collez chaque clé dans le champ correspondant et cliquez sur Enregistrer les clés API.
3

Basculez en mode Live

Cliquez sur Basculer en mode Live. Macaly reconfigure votre projet pour utiliser votre compte Stripe live. Le statut passera à Les paiements sont en production en vert.
4

Publiez votre projet

Publiez votre projet pour déployer les modifications. Les paiements live ne sont traités que sur le site publié, pas en prévisualisation.

​
Gérer votre intégration

Tous les paramètres de paiement sont accessibles depuis l’onglet Paiements :
  • Ouvrir Stripe ouvre le tableau de bord Stripe où vous pouvez consulter les transactions, émettre des remboursements et suivre les versements.
  • Basculer en mode Live / Basculer en mode test vous permet de basculer entre les environnements à tout moment sans affecter le code de votre projet.
  • Gérer la connexion Stripe vous permet de mettre à jour vos clés API live après la configuration initiale.
  • Paiements de test affiche les détails de la carte de test en mode test.

​
Dépannage

Un bac à sable est un environnement de test temporaire que Macaly crée pour vous. Il est livré avec ses propres clés API de test et vous permet de simuler des paiements sans toucher à de l’argent réel. Ce n’est pas votre compte Stripe. Lorsque vous revendiquez le bac à sable, vous le liez à votre compte Stripe réel. Tant que vous ne l’avez pas revendiqué, le bac à sable est anonyme et expire après 60 jours.
Assurez-vous d’utiliser le numéro de carte de test 4242 4242 4242 4242 avec une date d’expiration future, un CVC à 3 chiffres et un code postal quelconque. Si le problème persiste, consultez le chat pour les détails de l’erreur ou demandez à l’agent de diagnostiquer le flux de paiement.
Le mode Test utilise l’environnement bac à sable avec des clés de test. Tous les paiements sont simulés et aucun argent réel n’est impliqué. Le mode Live utilise votre compte Stripe vérifié avec des clés live. De l’argent réel est débité et déposé sur votre compte bancaire. Vous pouvez basculer entre les modes à tout moment dans l’onglet Paiements. Le changement de mode n’affecte pas le code de votre projet, seulement les clés Stripe actives.
Revendiquer le bac à sable et vérifier votre compte Stripe sont deux étapes distinctes. La revendication lie le bac à sable à votre compte, mais vous devez encore compléter la vérification d’entreprise de Stripe (identité, informations d’entreprise, compte bancaire) avant que les clés live ne soient générées. Ouvrez le tableau de bord Stripe et suivez le guide de configuration pour terminer la vérification. Si vous ne voyez que des clés de test (commençant par pk_test_ et sk_test_), votre compte n’a pas encore été entièrement vérifié.
La vérification de votre compte Stripe ne bascule pas automatiquement Macaly en mode live. Vous devez saisir manuellement vos clés API live dans l’onglet Paiements puis cliquer sur Basculer en mode Live. Macaly vous maintient en mode test jusqu’à ce que vous basculiez explicitement.
Vérifiez trois choses dans l’ordre :
  1. Avez-vous publié votre projet ? Les paiements live ne sont traités que sur le site publié, pas en prévisualisation.
  2. Vos clés sont-elles correctes ? Vérifiez que vous avez saisi votre clé publique (commençant par pk_live_) et votre clé secrète (commençant par sk_live_). Si vous avez accidentellement collé des clés de test, cliquez sur Gérer la connexion Stripe et mettez-les à jour.
  3. Votre compte Stripe est-il entièrement vérifié ? Ouvrez le tableau de bord Stripe et vérifiez s’il y a des étapes en attente dans le guide de configuration. Stripe peut exiger des documents supplémentaires avant de traiter les paiements live.
Les bacs à sable non revendiqués expirent après 60 jours. Ouvrez l’onglet Paiements et cliquez sur Configurer un nouveau bac à sable pour provisionner un nouvel environnement. Votre code de paiement existant reste inchangé. Si vous aviez déjà revendiqué et vérifié votre compte Stripe, vous devrez resaisir vos clés live après le provisionnement d’un nouveau bac à sable.

​
Bon à savoir

  • Les frais Stripe s’appliquent. Macaly ne facture pas de frais supplémentaires pour les paiements. Les frais de traitement standard de Stripe s’appliquent à chaque transaction (voir stripe.com/pricing).
  • Expiration du bac à sable. Les environnements de test non revendiqués expirent après 60 jours. Si cela se produit, ouvrez l’onglet Paiements et cliquez sur Configurer un nouveau bac à sable pour en provisionner un nouveau.
  • Les webhooks sont gérés automatiquement. Macaly configure et maintient tous les endpoints webhook. Aucune configuration manuelle n’est requise dans le tableau de bord Stripe.
  • Les environnements de test et live sont isolés. Les transactions de test n’apparaissent pas dans votre compte Stripe live, et aucun frais réel n’est engagé.