Se connecterCréer un compte gratuit

Langue

Se connecterCréer un compte gratuit
Menu de la documentation

Stripe : vos nouveaux clients

Faites entrer dans Mailcheer, sans export ni import, les clients qui paient sur Stripe : destination d'événements webhook, essai, choix des champs.

Chaque fois qu'un client termine un paiement sur une page Stripe Checkout ou par un lien de paiement, Stripe émet l'événement checkout.session.completed. Stripe peut envoyer cet événement à une adresse web de votre choix : c'est un webhook. Donnez-lui votre adresse de réception Mailcheer, et l'adresse e-mail du client arrive dans vos contacts, sans export ni import.

Avant de commencer

  • Une adresse de réception Mailcheer. Dans Mailcheer, ouvrez Intégrations → Faire entrer des contacts et cliquez sur « Créer une adresse de réception ». Mailcheer vous donne une adresse de la forme https://mailcheer.com/api/in/<jeton>. C'est un secret : ne la publiez nulle part, car quiconque la connaît peut y envoyer des données.
  • Workbench dans votre Dashboard Stripe. Stripe l'active par défaut sur les nouveaux comptes. Si vous ne le voyez pas, activez-le dans les paramètres Développeurs du Dashboard.

Si votre Dashboard Stripe est en anglais, voici les libellés utilisés dans cette fiche :

En françaisEn anglais
Environnements de testSandboxes
Créer une destination d'événementsCreate an event destination
Votre compteYour account
ContinuerContinue
endpoint de webhookWebhook endpoint
URL de l'endpointEndpoint URL
Créer une destinationCreate destination
Envois d'événementsEvent deliveries
RenvoyerResend

Un mot sur le consentement

Un client qui paie n'a pas forcément accepté de recevoir vos newsletters. N'y faites entrer que des personnes qui ont accepté de recevoir vos e-mails. Le double opt-in (un e-mail de confirmation) est activé par défaut dans Mailcheer.

1. Créez la destination dans un environnement de test

Stripe recommande de faire vos essais dans un environnement de test avant de passer en production. Une destination appartient à l'environnement dans lequel vous la créez.

  1. Dans le Dashboard Stripe, ouvrez le sélecteur de compte, cliquez sur « Environnements de test » et ouvrez l'environnement de votre choix.
  2. Ouvrez l'onglet Webhooks dans Workbench.
  3. Cliquez sur « Créer une destination d'événements ».
  4. Sélectionnez « Votre compte ».
  5. Choisissez la version de l'API : Stripe propose celle de votre compte ou la plus récente. Notez celle que vous prenez, elle resservira à l'étape 4.
  6. Dans les types d'événements, sélectionnez uniquement checkout.session.completed. Stripe conseille de n'écouter que les événements dont vous avez besoin.
  7. Cliquez sur « Continuer », puis choisissez « endpoint de webhook » comme type de destination.
  8. Cliquez sur « Continuer » et collez votre adresse de réception Mailcheer dans « URL de l'endpoint ». La description est facultative : « Mailcheer » suffit à la reconnaître.
  9. Cliquez sur « Créer une destination ».

2. Envoyez un essai

Le plus rapide passe par le Shell de Workbench, qui accepte la commande stripe trigger :

  1. Toujours dans l'environnement de test, ouvrez l'onglet Shell de Workbench (menu « Développeurs » → « Workbench » → « Shell »). En mode production, le Shell est en lecture seule : l'essai ne fonctionne que dans un environnement de test.
  2. Tapez la commande suivante, puis appuyez sur Entrée :
stripe trigger checkout.session.completed

Stripe crée les objets de test nécessaires, puis émet l'événement, qui part vers votre destination.

Vous pouvez aussi payer l'une de vos pages de paiement de l'environnement de test (un lien de paiement, par exemple) avec la carte de test 4242 4242 4242 4242, une date d'expiration future comme 12/34, n'importe quel CVC à trois chiffres et votre propre adresse e-mail.

Mailcheer répond tout de suite, comme Stripe l'exige, et traite l'événement ensuite. Dans Stripe, l'onglet « Envois d'événements » de la destination indique si l'envoi est passé.

3. Choisissez les champs dans Mailcheer

Revenez sur votre adresse de réception dans Mailcheer : elle affiche ce qu'elle a reçu, avec la liste des champs trouvés.

Stripe envoie l'événement complet. La session de paiement se trouve dans data → object, et c'est là que Stripe range les coordonnées du client :

  • l'adresse e-mail dans customer_details → email (chemin complet : data.object.customer_details.email) ;
  • le nom complet dans customer_details → name.

Choisissez ensuite, en cliquant :

  • le champ qui contient l'e-mail (obligatoire) ;
  • le prénom et le nom, si vous le souhaitez ;
  • les étiquettes : fixes (par exemple client-stripe) ou tirées d'un champ ;
  • le double opt-in, activé par défaut ;
  • l'automatisation à déclencher, si vous en avez une.

4. Passez en production

  1. Quittez l'environnement de test et reprenez les étapes de la partie 1 dans votre compte en mode production, avec la même adresse de réception Mailcheer et, si possible, la même version de l'API : c'est elle qui fixe la forme des événements envoyés.
  2. Dans l'environnement de test, désactivez ou supprimez la destination d'essai depuis l'onglet Webhooks de Workbench, pour que vos essais ne fassent plus entrer de contacts.

Pour importer les clients que vous aviez déjà, passez par un fichier : voir Importer vos contacts.

Si ça ne marche pas

Commencez par regarder ce que Stripe a envoyé : onglet Webhooks de Workbench → votre destination → onglet « Envois d'événements ». Chaque événement y figure comme « Envoyé », « En attente » ou « Échec », et un clic affiche le code HTTP de chaque tentative.

  • Aucun événement n'apparaît. Vérifiez que la destination est abonnée à checkout.session.completed : Stripe n'envoie à une destination que les types d'événements qu'elle écoute. Vérifiez aussi qu'elle a été créée dans le même environnement que votre essai (test ou production), et qu'elle n'est pas désactivée : Stripe n'envoie rien à une destination désactivée.
  • L'envoi est en échec. Ouvrez la destination et comparez « URL de l'endpoint » avec l'adresse de réception affichée dans Mailcheer : elle doit être copiée en entier, sans espace ni caractère en trop.
  • Vous avez corrigé le problème. Ouvrez l'événement concerné et cliquez sur « Renvoyer ». Stripe permet ce renvoi manuel jusqu'à 15 jours après la création de l'événement.

Sources