Paiements Stripe

1Ce que cela apporte à votre application#

Permet aux applications que vous générez d'encaisser de l'argent réel (paywalls, mises à niveau « Pro », boutons d'achat) via Stripe Checkout.

C'est VOTRE compte Stripe : vos clés, votre argent, payé directement à vous. AppMint ne prélève aucune commission et n'assume aucune responsabilité de paiement (pas de Stripe Connect). Vous connectez Stripe UNE SEULE FOIS dans les Paramètres ; chaque application générée le réutilise : vous décrivez seulement ce qu'il faut vendre, sans jamais ressaisir de clés.

L'IA écrit tout le code de paiement. Votre clé secrète n'est jamais livrée dans l'application : elle reste dans votre backend Supabase.

2Connectez d'abord Supabase (obligatoire)#

Les paiements Stripe nécessitent un serveur sécurisé pour conserver votre clé secrète et confirmer les paiements : ce serveur est votre projet Supabase. Connectez donc d'abord Supabase et activez-le (Paramètres → BACKEND - SUPABASE) : le chapitre « 🗄️ Supabase Backend (Connect It Once) » en haut de ce guide vous explique comment faire.

Si Supabase n'est pas actif, vous verrez « Stripe keys saved, but payments also need Supabase active ». AppMint envoie automatiquement votre secret Stripe dans vos fonctions Supabase au déploiement : il n'est jamais placé dans l'application générée.

3Obtenir vos clés Stripe (en mode test pour commencer)#

Sur un ordinateur :

1. Ouvrez le tableau de bord Stripe et restez en mode test / dans un bac à sable pendant le développement (Stripe appelle désormais l'environnement de test un « sandbox » ; les anciens comptes affichent un bouton Test/Live). Aucun paiement réel n'a lieu ici.
2. Allez dans Developers → API keys.
3. Copiez la « Publishable key » (commence par pk_test_…) puis affichez et copiez la « Secret key » (commence par sk_test_…).

Utilisez la clé secrète standard (sk_…), pas une clé restreinte (rk_…) : AppMint valide et envoie la clé secrète sk_. Aucune approbation de marchand n'est nécessaire pour développer et tester tout le parcours avant d'activer les paiements réels.

Ouvrir les clés API Stripe →

4Connecter Stripe dans AppMint#

Ouvrez AI Studio → Paramètres → faites défiler jusqu'à « PAYMENTS - STRIPE (OPTIONAL) » → « CONNECT STRIPE (YOUR ACCOUNT) » :

1. Laissez « Live mode » désactivé pour l'instant (désactivé = Test).
2. Collez votre clé publiable dans le champ pk_test_….
3. Collez votre clé secrète dans le champ sk_test_… (conservée chiffrée sur cet appareil).
4. Activez « Enable Stripe payments for generated apps ».
5. Touchez « Validate & save Stripe keys ». AppMint vérifie le format, s'assure que les deux clés sont du même mode et valide la clé secrète auprès de Stripe. En cas de succès, vous verrez « ● Connected (TEST) ».

5Ce qu'AppMint configure pour vous#

Quand vous générez une application avec des paiements, AppMint s'occupe de toute la plomberie automatiquement : vous ne touchez ni à Supabase ni aux tableaux de bord Stripe :

• Envoie votre STRIPE_SECRET_KEY dans vos Supabase Edge Functions (chiffrée, côté serveur uniquement).
• Déploie une fonction « create-checkout » (démarre une session Stripe Checkout) et une fonction « stripe-webhook » (confirme les paiements).
• Enregistre le webhook auprès de Stripe et stocke son secret de signature.
• Crée une table « entitlements » pour que l'application sache qui a payé.

La clé publiable (pk_) est la seule valeur Stripe livrée dans l'application : cette clé peut être publique sans risque.

6Décrivez votre paywall : l'IA le construit#

Dites simplement ce que vous voulez, en langage courant. L'IA ajoute le bouton d'achat, l'appel au paiement et verrouille les fonctionnalités payantes pour vous :

• « Facturer 5 $ en une fois pour débloquer le thème Pro. »
• « Un abonnement à 9 $/mois qui supprime les publicités. »
• « Vendre un PDF téléchargeable à 19 $. »

Vous ne collez jamais de clés ni de prix dans le chat comme configuration, seulement l'intention. L'accès n'est débloqué qu'une fois que Stripe a confirmé le paiement via le webhook, jamais à partir d'un indicateur « payé » côté client, il ne peut donc pas être falsifié.

7Tester un paiement de bout en bout#

En mode Test, aucun argent réel n'est déplacé. Exécutez le parcours complet :

1. Ouvrez votre application et touchez le bouton d'achat/de mise à niveau.
2. Sur la page Stripe Checkout, payez avec la carte de test :

 4242 4242 4242 4242, any future expiry, any CVC, any ZIP.

1. Vous revenez dans l'application et la fonctionnalité payante se débloque.
2. Consultez le tableau de bord Stripe (mode Test) → Payments : vous verrez le paiement de test.

S'il se débloque, votre webhook et vos droits d'accès sont correctement configurés.

4242 4242 4242 4242   exp: any future date   CVC: any 3 digits

8Passer en production quand vous êtes prêt#

1. Activez votre compte Stripe pour les paiements réels (tableau de bord Stripe → « Activate » / compléter les informations de l'entreprise).
2. Dans Stripe, passez du bac à sable/test au mode live et copiez vos clés LIVE (pk_live_… et sk_live_…) depuis Developers → API keys.
3. Dans AppMint → Paramètres → Paiements : activez « Live mode », collez les clés pk_live_/sk_live_ et touchez « Validate & save ». Le badge passe à « ● Connected (LIVE) ».
4. Recompilez votre application.

AppMint empêche de mélanger les clés de test et live, et changer de mode redirige le secret déployé : test et live ne coexistent jamais sur une même application, vous ne pouvez donc pas publier par erreur des clés de test.

9Si quelque chose ne fonctionne pas#

• « Stripe keys saved, but payments also need Supabase active » → activez d'abord Supabase (étape 2).

• « You selected TEST but the keys are LIVE » (ou l'inverse) → le mode choisi doit correspondre au préfixe de vos clés (pk_test/sk_test ou pk_live/sk_live).

• « Stripe rejected the key » → la clé secrète est incorrecte ou révoquée. Recopiez-la depuis Developers → API keys.

• Le paiement réussit mais la fonctionnalité reste verrouillée → le webhook n'a pas atteint Supabase. Recompilez/redéployez pour qu'AppMint enregistre à nouveau le webhook, et vérifiez que le projet Supabase de l'application est bien celui que vous avez connecté.

• Impossible d'activer un compte live → Stripe n'accueille pas les marchands dans certains pays (dont l'Inde). Le mode test fonctionne partout pour développer ; pour des paiements réels dans ces pays, il vous faudrait un pays pris en charge par Stripe ou un autre prestataire.