Paiements (Stripe)

Générez des liens de paiement sur les devis en utilisant votre propre compte Stripe (modèle BYO).

L'intégration Paiements utilise VOTRE compte Stripe (modèle BYO : vous apportez votre propre compte). Les paiements vont directement sur votre compte Stripe : il n'y a aucun coût, marge ou intermédiation de notre part. Nous nous contentons de connecter les champs et le bouton pour générer le lien.

L'intégration démarre inerte : rien ne se passe tant que vous n'avez pas collé votre clé et activé. Les clés sont stockées chiffrées dans le CRM et ne sont jamais réaffichées.

Prérequis

• Un compte Stripe actif (pour facturer réellement, le compte doit être activé pour les paiements dans votre pays).
• Un accès au Stripe Dashboard avec la permission de voir les clés API (Developers → API keys) et de créer des webhooks (Developers → Webhooks).
• Dans Sellio, un accès administrateur pour enregistrer les clés et activer l'intégration dans Paramètres → Intégrations.

Ce que vous devez coller

• Clé secrète : dans le Stripe Dashboard, sous Developers → API keys (commence par sk_live_ en production ou sk_test_ en test).
• Secret de signature du webhook (optionnel au départ) : généré lorsque vous créez le webhook dans Stripe (commence par whsec_). C'est ce qui permet de confirmer automatiquement les paiements.

Comment configurer

1. Ouvrez Paramètres → Intégrations et trouvez la carte « Paiements (Stripe) ».
2. Collez votre clé secrète Stripe et cliquez sur « Enregistrer les clés ».
3. Copiez « l'URL du webhook Stripe » qui apparaît et, dans le Stripe Dashboard (Developers → Webhooks), créez un endpoint pour cette URL avec les événements checkout.session.completed et payment_intent.succeeded.
4. Revenez dans le CRM, collez le secret de signature du webhook (whsec_...) avec la clé secrète et enregistrez à nouveau.
5. Cliquez sur « Activer ».

Comment générer un lien de paiement

1. Ouvrez une opportunité et allez dans la section Devis.
2. Sur la version souhaitée, cliquez sur « Lien de paiement » : le CRM crée un lien dans Stripe avec le montant total du devis et le copie dans votre presse-papiers.
3. Envoyez le lien au client. Quand il paie, Stripe notifie le CRM via webhook et le paiement apparaît comme « Payé » sur le devis.

Traitez l'URL du webhook comme secrète et collez toujours les deux clés ensemble lorsque vous les modifiez (par sécurité, le CRM ne réaffiche pas les clés enregistrées).

Comment tester

1. Utilisez les clés de TEST (sk_test_.../whsec_ du mode test) pour ne pas facturer réellement.
2. Générez un « Lien de paiement » sur un devis et ouvrez-le : vous devriez arriver sur le checkout Stripe avec le montant total du devis.
3. Payez avec une carte de test Stripe (par ex. 4242 4242 4242 4242). Vérifiez que le devis devient « Payé » et est marqué comme accepté, signe que le webhook est arrivé et que la signature a été validée.
4. Dans le Stripe Dashboard (Developers → Webhooks → votre endpoint), consultez l'historique des événements livrés et le statut 200.

Dépannage

• Erreur lors de la génération du lien / 401 sur Stripe : la clé secrète est incorrecte ou provient d'un autre mode (vous avez collé celle de test mais êtes en production, ou l'inverse). Recollez le bon sk_.
• Le client paie mais le devis ne devient pas « Payé » : le webhook ne confirme pas. Vérifiez que vous avez créé l'endpoint dans Stripe pointant vers « l'URL du webhook Stripe » avec les événements checkout.session.completed et payment_intent.succeeded.
• Signature invalide sur le webhook : le secret de signature du webhook (whsec_...) dans le CRM ne correspond pas à celui de l'endpoint dans Stripe. Copiez le secret de l'endpoint et collez-le AVEC la clé secrète (enregistrez les deux ensemble).
• 404 sur l'URL du webhook : l'intégration n'est pas activée ou le token de l'URL a changé. Réactivez et recopiez l'URL vers Stripe.
• Rien ne se passe lors de la génération du lien : l'intégration est inerte faute de clé. Collez d'abord la clé secrète et activez.

Open this article inside the system →