Configuration Stripe

Guide complet pour accepter les paiements avec Stripe.

Étape 1 : Créer un compte Stripe

1. Allez sur Stripe.com 
2. Cliquez Sign Up
3. Remplissez vos informations commerciales
4. Acceptez les conditions
5. Validez votre email

Étape 2 : Accéder au dashboard

1. Connectez-vous à Stripe Dashboard 
2. Vous êtes en mode Test par défaut
3. Les paiements de test n’utilisent pas de vraie argent

Étape 3 : Récupérer vos clés API

Public Key (Clé publique)

1. Allez à Developers → API Keys
2. Onglet Standard keys
3. Copiez la Publishable key (commence par pk_test_)

Secret Key (Clé secrète)

⚠️ Gardez-la privée!

1. Cliquez Reveal test key
2. Copiez la Secret key (commence par sk_test_)

Étape 4 : Configurer dans Wagoo

1. Allez dans vos paramètres Wagoo → Payments
2. Collez les clés Stripe
3. Cliquez Save

Ou manuellement dans .env.local :

NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY="pk_test_..."
STRIPE_SECRET_KEY="sk_test_..."

Étape 5 : Configurer les webhooks

Les webhooks permettent à Stripe de notifier Wagoo des paiements.

Via Wagoo (Recommandé)

1. Allez à Settings → Webhooks → Add Stripe
2. Cliquez Authorize
3. Wagoo configure automatiquement

Manuellement

1. Allez à Stripe → Developers → Webhooks

2. Cliquez Add endpoint

3. URL : https://votredomaine.com/api/webhooks/stripe

4. Événements à écouter :

   • payment_intent.succeeded
   • charge.refunded
   • customer.subscription.updated

5. Cliquez Add endpoint

6. Copiez le Signing secret (commence par whsec_)

7. Ajoutez à .env.local :

STRIPE_WEBHOOK_SECRET="whsec_..."

Étape 6 : Créer des produits

Via Stripe Dashboard

1. Allez à Products → Add product

2. Remplissez :

   • Nom : “Accès Premium”, “Billet Festival”, etc.
   • Description : Optionnel
   • Pricing model : Standard pricing
   • Price : En cents (ex: 2999 = 29.99€)

3. Cliquez Save

Pour abonnements

1. Même processus

2. Dans la section “Pricing” :

   • Recurring : Activé
   • Billing period : Monthly / Yearly
   • Price : Montant

3. Cliquez Save

Étape 7 : Tester les paiements

Cartes de test

Utilisez ces cartes en mode test (ne débite pas):

Tester un paiement

1. Allez à Products
2. Cliquez sur un produit
3. Cliquez Create checkout link
4. Ouvrez le lien dans une fenêtre privée
5. Utilisez une carte de test
6. Complétez le paiement
7. Vérifiez le résultat dans Stripe Dashboard

Intégration dans Wagoo

Ajouter un produit Stripe

1. Allez à Project → Settings → Products
2. Cliquez Link Stripe Product
3. Sélectionnez le produit créé
4. Cliquez Link

Créer un lien de paiement

1. Allez à Payments
2. Cliquez New Product ou Add Stripe Product
3. Sélectionnez ou créez le produit
4. Cliquez Create

Wagoo génère un lien partageable.

Afficher les produits sur votre site

<a href="https://wagoo.app/checkout/prod_123">
  Acheter Premium
</a>

Passer en mode LIVE (Production)

Activation du compte

1. Allez à Stripe Settings
2. Cliquez Activate your account
3. Complétez la vérification (documents, infos bancaires)
4. Vous êtes approuvé en 1-2 jours

Récupérer les clés live

1. Stripe Dashboard
2. Cliquez le switch “View test data” → “OFF”
3. Vous êtes en mode Live
4. Récupérez les clés live (commencent par pk_live_ et sk_live_)

Mettre à jour Wagoo

1. Allez à Settings → Payments
2. Remplacez les clés test par les clés live
3. Cliquez Save

Ou dans .env.production.local :

NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY="pk_live_..."
STRIPE_SECRET_KEY="sk_live_..."

Reconfigurer les webhooks

1. Stripe → Developers → Webhooks
2. Ajoutez un nouvel endpoint (mode live)
3. URL : https://votredomaine.com/api/webhooks/stripe
4. Copiez le nouveau secret
5. Mettez à jour STRIPE_WEBHOOK_SECRET

Gérer les paiements

Voir les transactions

1. Stripe Dashboard → Payments
2. Affiche tous les paiements reçus
3. Cliquez pour voir les détails

Remboursements

1. Cliquez sur la transaction
2. Cliquez Refund
3. Montant complet ou partiel
4. Confirmez

Abonnements

1. Stripe Dashboard → Customers → Subscriptions
2. Voir les clients actuels
3. Modifier ou annuler un abonnement

Sécurité

✅ Jamais hard-coder les clés secret ✅ Toujours utiliser les variables d’env ✅ Les clés live ne doivent pas être dans Git ✅ Vérifiez les signatures des webhooks

Webhooks traités par Wagoo

Facturation et invoices

Créer une invoice

Stripe crée automatiquement les invoices pour :

• Paiements uniques
• Abonnements récurrents

Télécharger une invoice

1. Stripe → Customers → [Client]
2. Cliquez Invoices
3. Cliquez l’invoice
4. Cliquez PDF

Support

Pour les questions Stripe :

• Stripe Documentation 
• Stripe Support 

Prochaines étapes

→ Commencez à accepter les paiements! → Monitorer les transactions → Préparer votre passage en mode live