- 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
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
Copiez la clé publiable
Sous Standard keys, copiez la Publishable key. Elle commence par pk_live_.
- 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
Votre adresse de webhook TourTask pour Stripe Elements
https://api.tourtask.com/v1/payments/stripe-elements/notifications/booking- 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
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
Sélectionnez l’événement
Sélectionnez payment_intent.succeeded et aucun autre événement.
- 4
Choisissez un endpoint de webhook
Cliquez sur Continue et sélectionnez Webhook endpoint comme type de destination.
- 5
Saisissez l’adresse TourTask
Cliquez sur Continue, collez l’adresse TourTask ci-dessus dans Endpoint URL et cliquez sur Create destination.
- 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_.
Ajouter Stripe Elements dans TourTask
- 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
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
Saisissez vos identifiants API
Sous Authentification, la carte a un champ pour chacun :
Clé API
Clé publiable
Secret du webhookChaque champ est enregistré dès que vous cliquez en dehors.
- 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.
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
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
Annulez la réservation de test
Ouvrez la réservation dans TourTask et cliquez sur Annuler la réservation.
- 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
Vérifiez le webhook
Dans Stripe, ouvrez l’onglet Event deliveries de la destination : payment_intent.succeeded apparaît comme Delivered.
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/bookingGoogle Pay
https://api.tourtask.com/v1/payments/google-pay/notifications/bookingQuestions 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.