Guide : encaisser vos clients par carte bancaire (Stripe)

Ce guide est pour vous, artisan, qui voulez que vos clients paient par carte bancaire en ligne. L'argent arrive sur votre compte Stripe. Prévoyez 30 à 60 minutes. Demandez d'abord votre numéro d'artisan (ID tenant) au coordinateur pour l'étape 4.

💡 Alternative : Vous préférez les virements ? Renseignez votre IBAN dans Paramètres entreprise → il apparaîtra sur vos factures PDF. Les clients pourront payer par virement (vous marquerez manuellement les factures comme payées).

2. Copier vos deux clés API (mode Live)

Stripe → DéveloppeursClés API (vérifiez « mode production »).

  • Clé publiable : pk_live_…
  • Clé secrète : Révéler → sk_live_… (ne la partagez pas)
2. Copier vos deux clés API (mode Live)

3. Les coller dans Paramètres entreprise

Admin du siteParamètres entreprise → section Configuration Stripe :

  • Clé publique Stripe → pk_live_…
  • Clé secrète Stripe → sk_live_…

Enregistrez. Le secret webhook vient à l'étape 5.

3. Les coller dans Paramètres entreprise

4. Créer le webhook dans Stripe (avec votre numéro)

Demandez au coordinateur votre ID tenant (ex. 3).

Allez sur https://dashboard.stripe.com/webhooksAjouter une destination.

Dans le formulaire Stripe, remplissez :

  • URL de l'endpoint : https://artisan-peinture.com/stripe-webhook/VOTRE_ID
    (Exemple : https://artisan-peinture.com/stripe-webhook/3)
  • Événements à écouter (un seul) : checkout.session.completed

Puis cliquez sur Ajouter une destination.

4. Créer le webhook dans Stripe (avec votre numéro)

5. Copier le secret webhook (whsec_)

Ouvrez la destination créée → Signing secret → Révéler → whsec_…

Admin → Paramètres entrepriseSecret Webhook Stripe → collez whsec_… → Enregistrer.

5. Copier le secret webhook (whsec_)

6. Tester avec un vrai paiement

Sur le site, créez un devis test avec un petit montant :

  1. Créez un devis → cliquez Payer en ligne
  2. Payez avec votre carte
  3. Vérifiez que le devis / la facture passe en payé
  4. Vérifiez que vous recevez l'email de confirmation

Problème fréquent : paiement OK sur Stripe mais rien sur le site = mauvaise URL webhook (stripe-webhook/VOTRE_ID) ou mauvais whsec_ dans Paramètres entreprise.

6. Tester avec un vrai paiement