> ## Documentation Index
> Fetch the complete documentation index at: https://wl.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Intégration Stripe
> Acceptez des paiements dans votre projet Macaly
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 :
```
Je veux vendre mes produits de soin en ligne. J'ai besoin d'une boutique
avec un catalogue et un processus de paiement pour que les clients puissent payer par carte.
```
```
J'ai écrit un e-book et je veux le vendre à 19 $. Crée une page
où les gens peuvent payer et le télécharger immédiatement.
```
```
Je lance un cours de yoga en ligne à 29 € par mois. Crée une landing page
où les membres peuvent s'inscrire et démarrer leur abonnement.
```
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 :
| Champ | Valeur |
| - | - |
| Numéro de carte | 4242 4242 4242 4242 |
| Expiration | Toute date future (ex. 01/30) |
| CVC | 3 chiffres (ex. 111) |
| Code postal | Toute valeur (ex. 11000) |
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.
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**.
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.
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.
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.
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.
Rendez-vous sur [dashboard.stripe.com](https://dashboard.stripe.com) et connectez-vous au compte que vous avez utilisé pour revendiquer le bac à sable.
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.
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.
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.
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**.
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.
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](https://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é.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.