Stripe Elements

Kaartbetalingen accepteren met Stripe Elements

Ontvang kaartbetalingen op je boekingspagina met Stripe Elements.

Landen

  • Australië
  • België
  • Brazilië
  • Bulgarije
  • Canada

Valuta's

  • AED
  • AFN
  • ALL
  • AMD
  • ANG
  • AOA
  • ARS
DocumentatieContact
API-toegangsgegevens
  • API-sleutel
  • Publiceerbare sleutel
  • Webhook-geheim

Stripe Elements zet de kaartvelden van Stripe op je boekingspagina, zodat reizigers met hun kaart betalen zonder die pagina te verlaten. Je hebt een Stripe-account nodig dat live betalingen accepteert: de handleiding voor Stripe laat zien hoe je er een opent.

Je sleutels uit Stripe kopiëren


  1. 1

    Open je API-sleutels in de live-modus

    Open dashboard.stripe.com/apikeys en controleer dat je in de live-modus zit, niet in een sandbox. Een testsleutel geeft geen fout: die markeert boekingen als betaald met geld dat niet bestaat.

  2. 2

    Kopieer de publiceerbare sleutel

    Kopieer onder Standard keys de Publishable key. Die begint met pk_live_.

  3. 3

    Kopieer de geheime sleutel

    Kopieer de Secret key (klik op Reveal live key als die verborgen is). Die begint met sk_live_. Houd hem geheim: er kunnen uit jouw naam kaarten mee worden belast.

De webhook toevoegen in Stripe


De webhook markeert boekingen als betaald

Zonder webhook worden reizigers wel belast, maar blijven hun boekingen onbevestigd.

Je TourTask-webhookadres voor Stripe Elements

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

    Maak een eventbestemming aan

    Open dashboard.stripe.com/webhooks, nog steeds in de live-modus, en klik op Create an event destination.

  2. 2

    Kies je account en Snapshot

    Selecteer Your account en het payloadformaat Snapshot: TourTask kan de Thin-events die Stripe aanraadt niet lezen.

  3. 3

    Selecteer het event

    Selecteer payment_intent.succeeded en geen ander event.

  4. 4

    Kies een webhook-endpoint

    Klik op Continue en selecteer Webhook endpoint als type bestemming.

  5. 5

    Vul het TourTask-adres in

    Klik op Continue, plak het TourTask-adres hierboven in Endpoint URL en klik op Create destination.

  6. 6

    Kopieer het ondertekeningsgeheim

    Klik op de pagina van de bestemming op Reveal secret en kopieer het ondertekeningsgeheim. Dat begint met whsec_.

Eén endpoint per gateway

Heb je al een endpoint voor de gateway Stripe? Voeg toch een nieuw toe: elke gateway heeft een eigen endpoint nodig.

Stripe Elements toevoegen in TourTask


  1. 1

    Open de kaart van Stripe Elements

    Ga naar Configuratie → Betaalmogelijkheden en klik onder Online betalingen → Betalingsgateways op de kaart Stripe Elements. Staat hij er niet bij? Kies Toon alle gateways onder de kaarten.

  2. 2

    Kies het land en de valuta

    Kies bij Land het land waar je account bij Stripe Elements en de bijbehorende bankrekening zijn, en bij Munteenheid de valuta waarin reizigers betalen. Klik op Toevoegen. Wil je een van beide later wijzigen, verwijder Stripe Elements dan met Verwijderen en voeg het opnieuw toe.

  3. 3

    Vul je API-toegangsgegevens in

    Onder Authenticatie heeft de kaart voor elk een veld:
    API-sleutel
    Publiceerbare sleutel
    Webhook-geheim

    Elk veld wordt opgeslagen zodra je erbuiten klikt.

  4. 4

    Activeer Stripe Elements

    Klik op Activeren zodra alle velden zijn ingevuld. De kaart wordt Actief en reizigers kunnen op je boekingspagina met Stripe Elements betalen. Elke betaling komt rechtstreeks op je eigen account bij Stripe Elements: TourTask houdt je geld nooit vast.

API-sleutel: je geheime sleutel sk_live_…
Publiceerbare sleutel: je sleutel pk_live_…
Webhook-geheim: je ondertekeningsgeheim whsec_…

Toon het standaard open (optioneel)

Klik op de kaart op Standaard geopend om het kaartformulier open bovenaan je boekingspagina te tonen.

Controleren of Stripe Elements werkt


TourTask heeft geen testmodus voor Stripe Elements, en de voorwaarden van Stripe verbieden testbetalingen met echte kaarten.

  1. 1

    Open het kaartformulier

    Boek een tour op je eigen boekingspagina en kies betalen met een kaart: het kaartformulier van Stripe verschijnt. Sluit de pagina zonder te betalen.

  2. 2

    Annuleer de testboeking

    Open de boeking in TourTask en klik op Boeking annuleren.

  3. 3

    Controleer je eerste betaling

    Betaalt een reiziger met een kaart, dan staat de boeking als betaald en verschijnt de betaling in je Stripe-dashboard.

  4. 4

    Controleer de webhook

    Open in Stripe het tabblad Event deliveries van de bestemming: payment_intent.succeeded staat op Delivered.

Belast, maar niet betaald in TourTask?

Controleer de webhook in Stripe: live-modus, formaat Snapshot, het event payment_intent.succeeded en het exacte adres. In TourTask moet Webhook-geheim het ondertekeningsgeheim van dit endpoint bevatten. Het tabblad Event deliveries van de bestemming in Stripe toont elke mislukte poging.

Apple Pay en Google Pay toevoegen


Apple Pay en Google Pay zijn aparte gateways, die je instelt zoals Stripe Elements, met dezelfde twee sleutels. Elk heeft een eigen webhook-endpoint nodig op een eigen adres, en het ondertekeningsgeheim van dat endpoint komt in het Webhook-geheim ervan.

Apple Pay

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

Google Pay

https://api.tourtask.com/v1/payments/google-pay/notifications/booking
Registreer je webadressen in Stripe

Anders dan het kaartformulier verschijnen walletknoppen alleen op adressen die in Stripe zijn geregistreerd onder Settings → Payment method domains. Registreer elk adres waarop reizigers boeken: je eigen website, jouwnaam.tourtask.com en je TourTask-website (jouwnaam.tourtask.site of het eigen domein ervan). example.com en www.example.com zijn twee aparte vermeldingen.

Veelgestelde vragen


Nee. De kaart gaat rechtstreeks van de browser van de reiziger naar Stripe.

Met Stripe Elements blijven reizigers op je boekingspagina; Stripe stuurt ze naar de eigen pagina van Stripe en weer terug. Je kunt ze allebei gebruiken.

De methoden die aanstaan in de instellingen voor betaalmethoden van je Stripe-dashboard. Kaarten staan standaard aan.

Nee. TourTask rekent het boekingstotaal om naar de valuta die je voor de gateway hebt gekozen.

Was deze pagina nuttig?