Stripe

Ce que ca fait

Stripe envoie les evenements de paiement en temps reel vers DURUM.ai : ventes, paiements de factures et remboursements.

Evenement Stripe	Type dans DURUM.ai	Quand ca se declenche
checkout.session.completed	Vente	Un client complete un achat via Stripe Checkout
invoice.paid	Paiement	Une facture Stripe est payee
charge.refunded	Remboursement	Un remboursement est effectue

---

Configuration rapide (3 minutes)

Vous avez besoin de 2 endpoints dans votre Stripe Dashboard. Aucun secret a configurer : collez les URLs et c'est tout.

Etape 1 : Trouvez votre identifiant

Votre identifiant est soit un Business ID (format UUID) soit un client_key (identifiant court). Il vous a ete transmis par votre gestionnaire de compte lors de l'onboarding.

Vous le trouverez aussi dans DURUM.ai :

• Parametres → Integrations → section URLs Webhooks → votre identifiant est pre-rempli dans les URLs

IMPORTANT : Votre identifiant doit etre dans chaque URL

Sans votre identifiant dans l'URL, vos paiements ne seront pas attribues a votre compte et seront rejetes.

Etape 2 : Creez les endpoints dans Stripe

1. Connectez-vous au Dashboard Stripe → dashboard.stripe.com
2. Cliquez sur Developers en bas a gauche
3. Cliquez sur Webhooks dans le menu de gauche
4. Cliquez sur Add endpoint

---

Endpoint 1 : Paiements et remboursements

5. Dans le champ Endpoint URL, entrez :

   https://app.durum.ai/api/webhook/payment?client_key=VOTRE_CLE

   (Remplacez VOTRE_CLE par votre identifiant)

6. Cliquez sur Select events to listen to

7. Cochez les 2 evenements suivants :

   • invoice.paid
   • charge.refunded

8. Cliquez sur Add endpoint

---

Endpoint 2 : Ventes

9. Cliquez sur Add endpoint a nouveau

10. Dans le champ Endpoint URL, entrez :

    https://app.durum.ai/api/webhook/sale?client_key=VOTRE_CLE

    (Remplacez VOTRE_CLE par votre identifiant)

11. Cliquez sur Select events to listen to

12. Cochez :

    • checkout.session.completed

13. Cliquez sur Add endpoint

---

Etape 3 : Testez

1. Dans Stripe Dashboard, cliquez sur l'endpoint que vous venez de creer
2. Cliquez sur Send test webhook
3. Selectionnez le type d'evenement (ex: invoice.paid)
4. Cliquez sur Send test webhook
5. Verifiez que la reponse est 200 OK
6. Dans DURUM.ai, allez dans Logs Data pour confirmer la reception

Test rapide

Si vous voyez 200 OK dans Stripe et l'evenement dans Logs Data de DURUM.ai, tout est bon. Vous pouvez passer a autre chose.

---

FAQ

Est-ce que je dois configurer un secret de signature?

Non. DURUM.ai accepte les webhooks Stripe automatiquement si votre identifiant (client_key ou bid) est present dans l'URL. Aucun secret a copier ou configurer.

Si vous souhaitez tout de meme ajouter une couche de securite supplementaire, vous pouvez transmettre le Signing secret (whsec_...) a votre gestionnaire de compte qui le configurera dans DURUM.ai.

Pourquoi 2 endpoints et pas 3?

L'endpoint /payment gere a la fois les paiements (invoice.paid) et les remboursements (charge.refunded). Un endpoint dedie /refund existe aussi si vous preferez separer, mais ce n'est pas necessaire.

Quel endpoint utiliser si j'utilise Stripe Checkout?

Utilisez l'Endpoint 2 (/sale) avec l'evenement checkout.session.completed. C'est ce qui cree la vente dans DURUM.ai.

Si vos clients paient via des factures Stripe (Stripe Invoicing), utilisez l'Endpoint 1 (/payment) avec invoice.paid.

Mes webhooks etaient actifs mais ne fonctionnent plus

Stripe desactive automatiquement un endpoint apres trop d'erreurs consecutives. Allez dans Developers → Webhooks et verifiez que l'endpoint est Enabled. Si non, cliquez dessus et reactivez-le.

---

Depannage

Probleme	Solution
Paiements non attribues a mon compte	Verifiez que ?client_key=VOTRE_CLE est bien dans l'URL
Endpoint desactive dans Stripe	Reactivez-le dans Developers → Webhooks
Evenement ignore (reponse 200 mais rien dans DURUM.ai)	Verifiez que vous avez selectionne les bons evenements (invoice.paid, pas invoice.created)
Erreur 401	Votre URL ne contient pas votre identifiant : ajoutez ?client_key=VOTRE_CLE
Erreur 429	Trop de requetes simultanees : Stripe va reessayer automatiquement

---

Checklist rapide

• [ ] 2 endpoints crees dans Stripe Dashboard
• [ ] client_key present dans chaque URL
• [ ] Events selectionnes : invoice.paid, charge.refunded, checkout.session.completed
• [ ] Test webhook envoye avec succes (reponse 200)
• [ ] Evenement visible dans Logs Data de DURUM.ai

---