Aller au contenu

Stripe

Maintenu par OrkyvoVersion 1.0.1Toutes les offres sauf DevOps3 actions · 1 déclencheur

Créez des clients et des sessions de paiement, lisez les abonnements et réagissez aux paiements.

Connectez votre compte Stripe pour automatiser l'encaissement : création de clients, génération de liens de paiement Checkout, lecture d'abonnements et démarrage d'un workflow à chaque événement de paiement (signé et dédoublonné). Le mode Test et le mode Production sont distincts et choisis explicitement dans la connexion.

Opérations

OpérationTypeDescription
Créer un clienteffet externe : demande une confirmation avant une exécution manuelleactionCrée un client Stripe (email, nom, métadonnées) pour lui rattacher paiements et abonnements.
Créer une session de paiementeffet externe : demande une confirmation avant une exécution manuelleactionGénère une page de paiement Stripe Checkout et renvoie son URL à transmettre au client.
Récupérer un abonnementactionLit l'état d'un abonnement (statut, prix, période en cours, résiliation programmée).
À réception d'un événement de paiementdéclencheurDémarre le workflow quand Stripe envoie l'un des événements choisis. Signature vérifiée, doublons ignorés.

Connexion

Clé secrète (sk_…) ou clé restreinte (rk_…) de votre compte. Commencez avec une clé de test : aucun paiement réel n'est possible en mode Test.

Documentation

Prérequis

  • Un compte Stripe. Commencez en mode Test : les clés commencent par sk_test_ et aucun paiement réel n'est possible.
  • Pour une clé restreinte (rk_…) : droits en écriture sur *Customers* et *Checkout Sessions*, en lecture sur *Subscriptions*, et en écriture sur *Webhook Endpoints* si vous utilisez l'enregistrement automatique.

Connexion

  1. Tableau de bord Stripe › Développeurs › Clés API : copiez la clé secrète.
  2. Dans Orkyvo, créez une connexion Stripe, choisissez l'environnement (Test ou Production) et collez la clé. Une clé de production est refusée en mode Test, et inversement.
  3. Le bouton Tester vérifie la clé (lecture d'un client).

Déclencheur « événement de paiement »

  • Automatique (recommandé) : à la publication du workflow, Orkyvo crée l'endpoint dans Stripe avec les événements choisis et conserve son secret de signature, chiffré. L'endpoint est supprimé à la désactivation. Stripe exige une URL publique en HTTPS : publiez depuis votre serveur de production.
  • Manuel : ajoutez vous-même l'URL affichée dans le bloc (tableau de bord › Webhooks, ou stripe listen --forward-to <URL>), puis collez le secret whsec_… dans la connexion.
  • Chaque événement est vérifié (signature, horodatage de moins de 5 minutes) et ne déclenche qu'une exécution, même s'il est renvoyé par Stripe.
  • Un événement de production reçu par une connexion de test (ou l'inverse) est refusé.

Limites

  • Les montants, devises et produits se gèrent dans Stripe : le nœud référence un identifiant de prix existant.
  • Les sessions Checkout expirent après 24 heures.
  • Version d'API Stripe utilisée : 2025-08-27.basil.