Base de connaissances Rise Up

Stripe standalone client setup

  • Mise à jour
Prérequis

 Cet article s'adresse aux Administrateurs. Avant de commencer, assurez-vous de disposer :

  • d'un accès Administrateur à la plateforme, pour modifier les paramètres Configuration > Payment integration ;
  • d'un accès au Stripe Dashboard de votre organisation, avec un rôle permettant d'ouvrir l'espace Developers (webhooks et clés API) ;
  • d'un nom d'entreprise public renseigné dans le Stripe Dashboard, sur dashboard.stripe.com/account. Stripe Checkout ne peut pas fonctionner tant que ce nom n'existe pas.
Cette configuration doit être activée par Rise Up
Par défaut, la monétisation sur la plateforme passe par Stripe Connect. Connecter votre propre compte Stripe avec des clés API et des signatures de webhook nécessite une activation technique côté Rise Up. Demandez-la à votre Account Manager (AM).
Si les champs Test Stripe webhook signature et Live Stripe webhook signature sont absents de Configuration > Payment integration, cette configuration n'est pas encore active sur votre compte. Contactez votre AM avant de coller des clés.

Les clés secrètes et les secrets de signature Stripe donnent accès à votre compte de paiement. Ne les communiquez que via les champs Payment integration de la plateforme.

Vue d'ensemble

La Payment integration connecte la plateforme à votre compte Stripe. Elle repose sur deux valeurs pour chaque mode (test et live) :

 une clé API du compte Stripe, qui permet à la plateforme de communiquer avec votre compte Stripe, et
 une signature de webhook Stripe, qui permet à la plateforme de vérifier que les événements de paiement reçus proviennent bien de Stripe.

La configuration suit ces étapes :

  • 1Ouvrir l'espace Developers (Workbench) dans Stripe
  • 2Créer ou vérifier la destination d'événements webhook (une par mode) et ses événements
  • 3Copier le secret de signature de la destination
  • 4Copier votre clé secrète Stripe
  • 5Coller les deux valeurs dans les paramètres Payment integration de la plateforme
  • 6Vérifier que les événements sont bien livrés

Répétez les étapes 2 à 5 pour chaque mode utilisé : les valeurs de test vont dans les champs Test, les valeurs de production dans les champs Live.

 

Éléments clés
  • Workbench : l'espace développeur de Stripe, qui contient les onglets Webhooks, Events et Logs.
  • Destination d'événements : le point de terminaison webhook (URL) auquel Stripe envoie les événements. Chaque destination a son propre statut, ses propres événements et son propre secret de signature. Il faut une destination en mode test et une en mode live.
  • Events from : la source des événements écoutés par une destination. Pour cette configuration, elle doit être Your account (votre compte), et non Connected and v2 accounts.
  • Événement : une notification envoyée par Stripe lorsqu'une action se produit sur votre compte, par exemple invoice.paid.
  • Secret de signature : la valeur commençant par whsec_, utilisée par la plateforme pour vérifier les requêtes webhook. Elle est saisie dans la plateforme comme signature de webhook Stripe.
  • Clé secrète : la clé standard Stripe saisie dans la plateforme comme clé API du compte Stripe. La Publishable key (clé publiable) n'est pas utilisée ici.
  • Mode test / mode live : Stripe conserve des clés, des secrets et des destinations distincts pour les paiements de test (sandbox) et les paiements réels.
Valeur Où la trouver dans Stripe À quoi elle sert Champs de la plateforme
Clé secrète (Secret key) Developers > API keys > Standard keys Permet à la plateforme de communiquer avec votre compte Stripe Test / Live Stripe account API key
Secret de signature (whsec_…) Workbench > Webhooks > détails de la destination d'événements (une destination par mode) Permet à la plateforme de confirmer que les événements reçus proviennent de Stripe Test / Live Stripe webhook signature

 

IOuvrir WorkbenchIIDestination d'événementsIIISecret de signatureIVClé secrèteVPayment integrationVIVérifier les livraisons

I. Ouvrir l'espace Developers dans Stripe

 Accès : Stripe Dashboard > Developers > Webhooks.

  1. Connectez-vous à votre Stripe Dashboard et vérifiez que le bon compte est sélectionné en haut du menu de gauche.
  2. Saisissez webhooks dans la  barre de recherche et sélectionnez Webhooks sous Workbench, ou ouvrez Developers en bas du menu de gauche et sélectionnez Webhooks.
Barre de recherche du Stripe Dashboard avec « webhooks » saisi et le résultat Webhooks de Workbench en surbrillance
Rechercher Webhooks depuis le Stripe Dashboard
Menu Developers de Stripe affichant Workbench, Documentation, API keys, Created apps et Developer settings
Le menu Developers : Webhooks sous Workbench, API keys en bas

 Résultat : Workbench s'ouvre sur l'onglet Webhooks, qui affiche la liste Event destinations.

 

II. Créer ou vérifier la destination d'événements

 Accès : Workbench > Webhooks > Event destinations.

La liste affiche pour chaque destination son URL, son statut (par exemple Active), le nombre d'événements écoutés, la source des événements (Events from), l'activité, le temps de réponse et le taux d'erreur.

Liste Event destinations de Stripe avec deux destinations actives et le menu de ligne affichant Edit, Disable et Delete
Liste des destinations d'événements avec le menu d'actions ouvert. Pour cette configuration, la colonne Events from doit afficher Your account.
Écoutez les événements de votre compte
Créez une destination par mode : une en mode test, une en mode live. Chacune doit écouter les événements de Your account. N'utilisez pas une destination dont la colonne Events from affiche Connected and v2 accounts : elle relève de la configuration Stripe Connect.

URL des points de terminaison webhook

 Utilisez l'URL correspondant au mode de la destination :

Mode URL du point de terminaison
Test https://app.yunoo.io/stripe_webhooks/events?stripe_account_mode=test
Live https://app.yunoo.io/stripe_webhooks/events?stripe_account_mode=live
ou https://app.yunoo.io/stripe_webhooks/events

Si aucune destination n'existe pour votre plateforme

Répétez ces étapes en mode test, puis en mode live.

  1. Sur la page Webhooks, cliquez sur  Add destination.
  2. Choisissez d'écouter les événements de Your account.
  3. Dans la section Events, sélectionnez les événements listés dans le tableau ci-dessous.
  4. Saisissez l'URL du point de terminaison du mode choisi (voir le tableau ci-dessus).
  5. Terminez la création de la destination.

Si une destination existe déjà

Cliquez sur le menu  en fin de ligne pour accéder à :

  • Edit — modifier l'URL ou les événements sélectionnés de la destination.
  • Disable — arrêter l'envoi d'événements vers cette destination.
  • Delete — supprimer définitivement la destination.

Événements à sélectionner

Dans la section Events, l'onglet Selected events affiche les événements déjà choisis, et l'onglet All events permet d'en rechercher et d'en ajouter d'autres. L'intégration de paiement utilise les événements suivants :

Catégorie Événement Envoyé par Stripe lorsque…
Checkout checkout.session.completed une session Checkout a été finalisée avec succès.
Customer customer.subscription.created un client souscrit à une nouvelle offre.
Customer customer.subscription.deleted l'abonnement d'un client prend fin.
Customer customer.subscription.updated un abonnement est modifié, par exemple un changement d'offre ou un passage du statut d'essai à actif.
Invoice invoice.paid le paiement d'une facture réussit, ou une facture est marquée comme payée en dehors de Stripe.
Onglet Selected events de Stripe avec cinq événements cochés dans les catégories Checkout, Customer et Invoice
Les cinq événements sélectionnés

 Résultat : chaque destination (test et live) apparaît comme Active dans la liste, avec 5 events dans la colonne Listening to et Your account dans la colonne Events from.

Les événements manquants ne sont pas envoyés
Stripe n'envoie que les événements sélectionnés sur la destination. Si un événement manque, la plateforme n'en est jamais informée, même lorsque le paiement réussit dans Stripe.

 

III. Copier le secret de signature

 Accès : Workbench > Webhooks > cliquez sur l'URL de la destination pour ouvrir sa page de détails.

  1. Dans l'onglet Overview de la destination, repérez le champ  Signing secret. La valeur est masquée et commence par whsec_.
  2. Cliquez sur l'icône  œil pour afficher la valeur complète.
  3. Copiez la valeur complète, y compris le préfixe whsec_.
Champ Signing secret de Stripe avec la valeur whsec_ masquée, l'icône œil et l'icône de renouvellement
Secret de signature sur la page de détails de la destination

 Résultat : vous disposez de la valeur à coller dans le champ Stripe webhook signature de la plateforme (section V).

Renouveler le secret impose une mise à jour dans la plateforme
L'icône de  renouvellement génère un nouveau secret de signature. Dès que l'ancien secret n'est plus valide, la plateforme rejette les événements entrants jusqu'à ce que vous colliez la nouvelle valeur dans le champ Stripe webhook signature correspondant.

 

IV. Copier la clé secrète Stripe

 Accès : Stripe Dashboard > Developers > API keys.

  1. Ouvrez Developers en bas du menu de gauche et sélectionnez API keys.
  2. Dans la section Standard keys, repérez la ligne Secret key.
  3. Affichez puis copiez la clé secrète.
Menu Developers de Stripe avec API keys en surbrillance
Developers > API keys
Section Standard keys de Stripe listant Publishable key et Secret key
Standard keys : utilisez la Secret key

 Résultat : vous disposez de la valeur à coller dans le champ Stripe account API key de la plateforme (section V).

Utilisez la Secret key, pas la Publishable key
La Publishable key apparaît en premier dans Standard keys et constitue une source d'erreur fréquente. La plateforme attend la Secret key. Le mode test et le mode live ont chacun leur propre clé secrète.

 

V. Saisir les valeurs dans la plateforme

 Accès : Configuration > Payment integration.

  1. Collez chaque valeur copiée depuis Stripe dans le champ correspondant, en suivant le tableau ci-dessous.
  2. Vérifiez que les valeurs de test sont dans les champs Test et les valeurs de production dans les champs Live.
  3. Enregistrez vos modifications.
Champ de la plateforme Valeur à coller depuis Stripe
Test Stripe account API key Clé secrète, mode test (section IV)
Live Stripe account API key Clé secrète, mode live (section IV)
Test Stripe webhook signature Secret de signature de la destination en mode test (section III)
Live Stripe webhook signature Secret de signature de la destination en mode live (section III)
Section Payment integration de la plateforme avec quatre champs masqués pour les clés API et signatures de webhook Stripe en test et en live
Champs Payment integration dans la plateforme

 Résultat : la plateforme peut communiquer avec votre compte Stripe et vérifier l'authenticité des requêtes webhook dans chaque mode. Les valeurs enregistrées restent masquées dans les champs.

Bonne pratique
Renseignez et testez d'abord les champs Test avec un paiement de test, puis saisissez les valeurs Live. Lors du copier-coller, veillez à n'ajouter aucun espace ni retour à la ligne avant ou après la valeur.

 

VI. Vérifier la livraison des événements

 Accès : Workbench > Webhooks > détails de la destination > onglet Event deliveries.

  1. Ouvrez l'onglet Event deliveries pour voir tous les événements envoyés par Stripe à la destination, regroupés par date.
  2. Utilisez  Find event by ID ou le filtre Status pour retrouver une livraison précise. Cliquez sur Refresh pour charger les dernières tentatives.
  3. Sélectionnez un événement pour afficher le détail de sa Delivery attempt, y compris son Delivery status.
  4. Si une livraison a échoué et que la cause a été corrigée, cliquez sur  Resend pour la renvoyer.
Page de détails d'une destination Stripe sur l'onglet Event deliveries, avec un événement customer.subscription.updated en 200 OK et le bouton Resend
Une livraison réussie (200 OK) dans Event deliveries

 Résultat : un statut 200 OK associé à un Delivery status Delivered confirme que la plateforme a reçu et accepté l'événement.

 

FAQ et dépannage

Dépannage des livraisons en échec

Problème Cause probable Résolution
Les livraisons échouent juste après la configuration ou après le renouvellement du secret La Stripe webhook signature saisie dans la plateforme ne correspond pas au secret de signature actuel de la destination Copiez de nouveau le secret de signature (section III), collez-le dans le champ correspondant (section V), puis cliquez sur Resend pour les événements en échec
Les événements de test échouent mais ceux en live réussissent (ou l'inverse) Les valeurs de test et de live ont été inversées, ou saisies dans les mauvais champs Vérifiez chaque valeur à l'aide du tableau de correspondance de la section V
Aucune livraison n'apparaît La destination est désactivée, pointe vers une mauvaise URL, n'écoute pas les événements requis, ou écoute Connected and v2 accounts au lieu de Your account Vérifiez le statut, l'URL, les événements sélectionnés et la valeur Events from de la destination (section II)
Le taux d'erreur (Error rate) de la destination augmente Le point de terminaison rejette certains événements ou n'y répond pas Ouvrez Event deliveries, filtrez par Status et examinez les tentatives en échec. Contactez le Support en indiquant les identifiants des événements si la cause n'est pas claire
  • Problème : Les paiements réussissent dans Stripe mais rien n'est mis à jour sur la plateforme.
    Solution : La plateforme n'a pas reçu ou pas accepté l'événement. Vérifiez que la destination est Active, qu'elle écoute les cinq événements requis (section II) et que ses livraisons affichent 200 OK (section VI). Si les livraisons échouent, mettez à jour la Stripe webhook signature et renvoyez les événements.

    Problème : Les champs Test Stripe webhook signature et Live Stripe webhook signature sont absents de Configuration > Payment integration.
    Solution : Cette configuration n'est pas encore active sur votre compte. Par défaut, la monétisation passe par Stripe Connect. Demandez à votre Account Manager (AM) d'activer la configuration avant de coller des clés.

    Problème : Stripe Checkout ne fonctionne pas.
    Solution : Checkout ne peut pas fonctionner tant qu'aucun nom d'entreprise public n'est renseigné dans Stripe. Ajoutez-le sur dashboard.stripe.com/account.

    Problème : La plateforme ne parvient pas à communiquer avec Stripe après la saisie de la clé API.
    Solution : La Publishable key a peut-être été collée à la place de la Secret key, ou une clé de test a été saisie dans un champ live. Copiez la Secret key depuis Developers > API keys dans le bon mode et collez-la de nouveau.

    Problème : Les webhooks ne fonctionnent plus après une modification de paramètres dans Stripe.
    Solution : Le secret de signature a été renouvelé, la destination a été désactivée ou modifiée, ou la clé secrète a changé. Comparez les valeurs actuelles dans Stripe avec celles des champs Payment integration de la plateforme et mettez à jour celles qui diffèrent.

    Problème : Je ne trouve pas les pages Webhooks ou API keys dans Stripe.
    Solution : Votre rôle Stripe ne donne peut-être pas accès à l'espace Developers, ou un autre compte Stripe est sélectionné. Vérifiez le nom du compte en haut du menu de gauche, ou demandez l'accès au propriétaire du compte Stripe.
     
  • Dois-je renseigner à la fois les champs test et live ?
    — Renseignez les champs de chaque mode que vous utilisez. Les valeurs de test permettent de valider la configuration sans paiement réel ; les valeurs live sont nécessaires pour traiter les paiements réels.

    Puis-je réutiliser la destination affichée avec Connected and v2 accounts ?
    — Non. Cette destination relève de la configuration Stripe Connect. Créez une destination par mode qui écoute les événements de Your account, avec les URL de la section II.

    La Publishable key est-elle utilisée dans cette configuration ?
    — Non. Les champs Payment integration attendent uniquement la Secret key et le Signing secret du webhook.

    Puis-je consulter à nouveau le secret de signature plus tard ?
    — Oui. Stripe permet d'afficher ou de renouveler le secret de signature à tout moment depuis la page de détails de la destination.

    Que se passe-t-il si je désactive ou supprime la destination dans Stripe ?
    — Stripe cesse d'envoyer des événements à la plateforme, qui ne reçoit donc plus les mises à jour de paiement. Réactivez la destination ou créez-en une nouvelle, puis mettez à jour la Stripe webhook signature si le secret de signature a changé.

    Pourquoi les valeurs sont-elles masquées dans la plateforme après l'enregistrement ?
    — Les clés et signatures sont des données sensibles. Les champs restent masqués pour éviter qu'elles ne soient exposées à l'écran.
  • Contacter le Support
    Documentation technique
    Documentation API
    Documentation Stripe : webhooks
    Documentation Stripe : clés API
    Page de statut du service
     

Cet article vous a-t-il été utile ?

Utilisateurs qui ont trouvé cela utile : 0 sur 0

Vous avez d’autres questions ? Envoyer une demande