Stripe Elements

Comment accepter les paiements par carte avec Stripe Elements

Encaissez les paiements par carte sur votre page de réservation avec Stripe Elements.

Pays

  • Allemagne
  • Australie
  • Autriche
  • Belgique
  • Brésil

Devises

  • AED
  • AFN
  • ALL
  • AMD
  • ANG
  • AOA
  • ARS
DocumentationContact
Identifiants API
  • Clé API
  • Clé publiable
  • Secret du webhook

Stripe Elements place les champs de carte de Stripe sur votre page de réservation : les voyageurs paient par carte sans la quitter. Il vous faut un compte Stripe qui accepte les paiements réels : le guide Stripe explique comment en ouvrir un.

Copier vos clés depuis Stripe


  1. 1

    Ouvrez vos clés API en mode production

    Ouvrez dashboard.stripe.com/apikeys et vérifiez que vous êtes en mode production, et non dans une sandbox. Une clé de test n’échoue pas : elle marque les réservations comme payées avec de l’argent qui n’existe pas.

  2. 2

    Copiez la clé publiable

    Sous Standard keys, copiez la Publishable key. Elle commence par pk_live_.

  3. 3

    Copiez la clé secrète

    Copiez la Secret key (cliquez sur Reveal live key si elle est masquée). Elle commence par sk_live_. Gardez-la pour vous : elle permet de débiter des cartes en votre nom.

Ajouter le webhook dans Stripe


Le webhook marque les réservations comme payées

Sans lui, les voyageurs sont débités et leurs réservations restent non confirmées.

Votre adresse de webhook TourTask pour Stripe Elements

https://api.tourtask.com/v1/payments/stripe-elements/notifications/booking
  1. 1

    Créez une destination d’événements

    Ouvrez dashboard.stripe.com/webhooks, toujours en mode production, et cliquez sur Create an event destination.

  2. 2

    Choisissez votre compte et Snapshot

    Sélectionnez Your account et le format de charge utile Snapshot : TourTask ne sait pas lire les événements Thin que Stripe recommande.

  3. 3

    Sélectionnez l’événement

    Sélectionnez payment_intent.succeeded et aucun autre événement.

  4. 4

    Choisissez un endpoint de webhook

    Cliquez sur Continue et sélectionnez Webhook endpoint comme type de destination.

  5. 5

    Saisissez l’adresse TourTask

    Cliquez sur Continue, collez l’adresse TourTask ci-dessus dans Endpoint URL et cliquez sur Create destination.

  6. 6

    Copiez le secret de signature

    Sur la page de la destination, cliquez sur Reveal secret et copiez le secret de signature. Il commence par whsec_.

Un endpoint par passerelle

Vous avez déjà un endpoint pour la passerelle Stripe ? Ajoutez-en quand même un nouveau : chaque passerelle a besoin du sien.

Ajouter Stripe Elements dans TourTask


  1. 1

    Ouvrez la carte Stripe Elements

    Allez dans Configuration → Options de paiement et cliquez sur la carte Stripe Elements sous Paiements en ligne → Passerelles de paiement. Elle n’y est pas ? Choisissez Afficher toutes les passerelles sous les cartes.

  2. 2

    Choisissez le pays et la devise

    Dans Pays, choisissez le pays de votre compte Stripe Elements et de son compte bancaire, et dans Devise, la devise dans laquelle les voyageurs paient. Cliquez sur Ajouter. Pour modifier l’un ou l’autre plus tard, retirez Stripe Elements avec Retirer puis ajoutez-le à nouveau.

  3. 3

    Saisissez vos identifiants API

    Sous Authentification, la carte a un champ pour chacun :
    Clé API
    Clé publiable
    Secret du webhook

    Chaque champ est enregistré dès que vous cliquez en dehors.

  4. 4

    Activez Stripe Elements

    Cliquez sur Activer une fois tous les champs remplis. La carte passe à Actif et les voyageurs peuvent payer avec Stripe Elements sur votre page de réservation. Chaque paiement arrive directement sur votre propre compte Stripe Elements : TourTask ne détient jamais votre argent.

Clé API : votre clé secrète sk_live_…
Clé publiable : votre clé pk_live_…
Secret du webhook : votre secret de signature whsec_…

Ouvrez-le par défaut (facultatif)

Cliquez sur Ouvert par défaut sur la carte pour afficher le formulaire de paiement par carte déjà ouvert en haut de votre page de réservation.

Vérifier que Stripe Elements fonctionne


TourTask n’a pas de mode test pour Stripe Elements, et les conditions de Stripe interdisent les paiements de test avec de vraies cartes.

  1. 1

    Ouvrez le formulaire de carte

    Sur votre propre page de réservation, réservez une visite et choisissez de payer par carte : le formulaire de carte de Stripe s’affiche. Fermez la page sans payer.

  2. 2

    Annulez la réservation de test

    Ouvrez la réservation dans TourTask et cliquez sur Annuler la réservation.

  3. 3

    Vérifiez votre premier paiement

    Quand un voyageur paie par carte, la réservation apparaît comme payée et le paiement figure dans votre tableau de bord Stripe.

  4. 4

    Vérifiez le webhook

    Dans Stripe, ouvrez l’onglet Event deliveries de la destination : payment_intent.succeeded apparaît comme Delivered.

Débité, mais pas payé dans TourTask ?

Vérifiez le webhook dans Stripe : mode production, format Snapshot, l’événement payment_intent.succeeded et l’adresse exacte. Dans TourTask, Secret du webhook doit contenir le secret de signature de cet endpoint. Dans Stripe, l’onglet Event deliveries de la destination montre chaque tentative échouée.

Ajouter Apple Pay et Google Pay


Apple Pay et Google Pay sont des passerelles à part entière, configurées comme Stripe Elements avec les deux mêmes clés. Chacune a besoin de son propre endpoint de webhook, à sa propre adresse, et le secret de signature de cet endpoint va dans son Secret du webhook.

Apple Pay

https://api.tourtask.com/v1/payments/apple-pay/notifications/booking

Google Pay

https://api.tourtask.com/v1/payments/google-pay/notifications/booking
Enregistrez vos adresses web dans Stripe

Contrairement au formulaire de carte, les boutons de portefeuille électronique ne s’affichent que sur les adresses enregistrées dans Stripe sous Settings → Payment method domains. Enregistrez chaque adresse sur laquelle les voyageurs réservent : votre propre site web, votrenom.tourtask.com et votre site web TourTask (votrenom.tourtask.site ou son propre domaine). example.com et www.example.com comptent comme deux entrées.

Questions fréquentes


Non. La carte va directement du navigateur du voyageur à Stripe.

Stripe Elements garde les voyageurs sur votre page de réservation ; Stripe les envoie sur la page de Stripe, puis les ramène. Vous pouvez utiliser les deux.

Ceux qui sont activés dans les paramètres des moyens de paiement de votre tableau de bord Stripe. Les cartes sont activées par défaut.

Non. TourTask convertit le total de la réservation dans la devise choisie pour la passerelle.

Cette page vous a-t-elle été utile ?