Passer au contenu principal

Intégration Stripe - Guide de configuration

Connectez votre compte Stripe à Goodweek pour gérer les paiements, les clients, les abonnements, les factures et les données de facturation directement depuis votre espace de travail IA.

A
Écrit par Antoine Stempien

Connectez votre compte Stripe à Goodweek pour gérer les paiements, les clients, les abonnements, les factures et les données de facturation directement depuis votre espace de travail IA.

ℹ️ Remarque sur la gouvernance

Goodweek ne dépassera jamais les niveaux d'accès accordés à l'utilisateur dans Stripe, garantissant ainsi l'alignement avec les politiques de gouvernance de votre organisation. Les résultats et les fonctionnalités disponibles peuvent varier selon les autorisations spécifiques et l'accès authentifié de chaque utilisateur.

📋 Prérequis

Avant que tout utilisateur puisse voir et connecter l'intégration Stripe, l'administrateur de votre organisation doit d'abord l'activer depuis le Panneau d'administration Goodweek, dans l'onglet Intégrations.

Configuration administrateur

L'intégration Stripe utilise OAuth 2.0 et ne nécessite aucune approbation au niveau administrateur dans Stripe avant que les utilisateurs puissent se connecter.

⚠️ Important : mode réel ou mode test

Stripe fonctionne selon deux modes : réel et test. Lors de la connexion, assurez-vous d'autoriser depuis le mode approprié à votre usage. Les actions effectuées via Goodweek affecteront l'environnement réel de Stripe, sauf si vous connectez un compte de test.

Connexion utilisateur

  1. Dans Goodweek, accédez à Intégrations.

  2. Trouvez Stripe et cliquez sur Connecter.

  3. Vous serez redirigé vers Stripe, où il vous sera demandé de vous connecter et d'autoriser l'accès.

  4. Cliquez sur Connecter pour accorder l'accès et revenir à Goodweek.

Remarques importantes

  • Chaque utilisateur doit connecter son propre compte Stripe individuellement.

  • Goodweek fonctionnera dans le mode (réel ou test) du compte que vous autorisez.

  • Vous pouvez révoquer l'accès de Goodweek à tout moment depuis le Tableau de bord Stripe → Paramètres → Applications connectées → Composio → Déconnecter.


Outils disponibles

Outil

Description

Type

Créer un client

Crée un nouveau client dans Stripe, nécessaire pour créer des paiements ou des abonnements.

Écriture

Récupérer le compte

Récupère des informations détaillées pour le compte Stripe authentifié.

Lecture

Créer une intention de paiement

Crée un PaymentIntent Stripe pour lancer et traiter le paiement d'un client.

Écriture

Confirmer une intention de paiement

Confirme un PaymentIntent pour finaliser le paiement avec le moyen de paiement fourni.

Lecture

Capturer une intention de paiement

Capture les fonds d'un PaymentIntent autorisé lorsqu'il est à l'état requires_capture.

Lecture

Récupérer une facture

Récupère une facture spécifique par son ID.

Lecture

Créer une facture

Crée une nouvelle facture Stripe à l'état brouillon pour un client.

Écriture

Créer un poste de facture

Ajoute une ligne à une facture brouillon avant sa finalisation.

Écriture

Ajouter des lignes à la facture

Ajoute plusieurs lignes à une facture Stripe brouillon existante en un seul appel.

Écriture

Finaliser la facture

Finalise une facture brouillon en la rendant ouverte et prête pour le recouvrement.

Lecture

Obtenir les postes de facture

Récupère une liste paginée des postes d'une facture spécifique.

Lecture

Créer un avoir

Émet un avoir pour ajuster le montant d'une facture finalisée.

Écriture

Prévisualiser un avoir

Prévisualise un avoir sans le créer dans Stripe.

Lecture

Créer un abonnement client

Crée un nouvel abonnement pour un client Stripe existant avec des éléments et des tarifs.

Écriture

Créer un abonnement

Crée un abonnement hautement configurable prenant en charge plusieurs éléments, essais et remises.

Écriture

Récupérer l'abonnement d'un client

Récupère un abonnement spécifique pour un client.

Lecture

Créer un poste d'abonnement

Ajoute un nouvel élément à un abonnement existant sans modifier les éléments existants.

Écriture

Créer un remboursement

Crée un remboursement total ou partiel dans Stripe ciblant un paiement ou une intention de paiement.

Écriture

Créer un remboursement de paiement

Crée un remboursement pour un paiement précédemment créé.

Écriture

Créer un coupon

Crée un nouveau coupon de réduction avec une remise en pourcentage ou en montant fixe.

Écriture

Créer un code promotionnel

Crée un code promotionnel utilisable par le client, lié à un coupon sous-jacent.

Écriture

Créer un produit

Crée un nouveau produit dans Stripe pour représenter un bien ou un service.

Écriture

Créer un tarif

Crée un nouveau tarif Stripe pour un produit, définissant ses paiements (ponctuel ou récurrent).

Écriture

Créer une session de paiement

Crée une session Checkout Stripe pour une page de paiement ou d'abonnement hébergée.

Écriture

Créer un lien de paiement

Crée une URL de paiement hébergée et partageable pouvant être envoyée directement aux clients.

Écriture

Créer une intention de configuration

Crée un SetupIntent pour recueillir les autorisations de moyen de paiement pour une utilisation future.

Écriture

Lister les événements

Récupère une liste d'événements Stripe des 30 derniers jours avec filtrage et pagination.

Lecture

Récupérer un événement

Récupère les détails d'un événement webhook Stripe spécifique par son ID.

Lecture

Créer une exécution de rapport

Crée et lance l'exécution asynchrone d'un rapport financier Stripe.

Écriture

Lister les compteurs de facturation

Récupère une liste des compteurs de facturation configurés pour la facturation à l'usage.

Lecture

Créer un compteur de facturation

Crée un compteur de facturation pour suivre les événements d'usage pour la tarification à l'usage.

Écriture

Créer une session du portail de facturation

Crée une URL de session du portail de facturation permettant aux clients de gérer leurs abonnements et factures.

Écriture

Créer un calcul de taxe

Calcule les taxes pour un achat client avant la création d'une commande.

Écriture

Créer un virement

Crée un virement pour transférer des fonds entre comptes Stripe dans le cadre de Connect.

Écriture

Annuler une intention de paiement

Annule un PaymentIntent qui n'est plus nécessaire.

⚠️ Destructif

Annuler un abonnement

Annule l'abonnement actif d'un client Stripe.

⚠️ Destructif

Supprimer un client

Supprime définitivement un client et annule ses abonnements actifs.

⚠️ Destructif

Supprimer une facture brouillon

Supprime définitivement une facture brouillon. Cette action est irréversible.

⚠️ Destructif

Annuler une facture

Marque définitivement une facture finalisée comme annulée, empêchant son recouvrement.

⚠️ Destructif

Supprimer un produit

Supprime un produit de Stripe. Uniquement possible si aucun tarif n'y est associé.

⚠️ Destructif

Cas d'usage

  • Créez des factures et encaissez des paiements depuis les conversations. Rédigez des factures Stripe, ajoutez des lignes, finalisez-les et créez des liens de paiement directement depuis Goodweek — utile pour facturer les clients à la demande sans naviguer dans le tableau de bord Stripe.

  • Gérez les abonnements et les clients. Créez de nouveaux abonnements, ajoutez des produits à des abonnements existants et récupérez les détails d'abonnement de clients spécifiques depuis Goodweek pour gérer rapidement les changements de facturation.

  • Émettez des remboursements et des avoirs. Créez des remboursements pour des paiements ou des intentions de paiement et émettez des avoirs sur des factures finalisées depuis Goodweek lors du traitement de litiges clients ou de corrections de facturation.

  • Surveillez les événements et l'activité de facturation. Récupérez les événements Stripe récents et filtrez-les par type depuis Goodweek pour étudier les problèmes de paiement, les changements d'abonnement ou l'activité des webhooks sans utiliser le tableau de bord Stripe.


Dépannage

Les actions affectent le mauvais environnement Stripe

Vérifiez que vous avez autorisé Goodweek avec le bon compte Stripe (réel ou test). Déconnectez-vous et reconnectez-vous si nécessaire, en veillant à sélectionner le bon compte lors du flux d'autorisation Stripe.

L'intégration n'est pas visible dans Goodweek

Assurez-vous que l'administrateur de votre organisation a activé l'intégration Stripe depuis le Panneau d'administration Goodweek, dans l'onglet Intégrations.

Références

Avez-vous trouvé la réponse à votre question ?