- API-Zugangsdaten
- API-Schlüssel
- Veröffentlichbarer Schlüssel
- Webhook-Geheimnis
Stripe Elements bringt die Kartenfelder von Stripe auf deine Buchungsseite, sodass Reisende per Karte bezahlen, ohne sie zu verlassen. Du brauchst ein Stripe-Konto, das echte Zahlungen annimmt: Wie du eines eröffnest, zeigt die Anleitung für Stripe.
Deine Schlüssel aus Stripe kopieren
- 1
Deine API-Schlüssel im Live-Modus öffnen
Öffne dashboard.stripe.com/apikeys und prüfe, ob du im Live-Modus bist und nicht in einer Sandbox. Ein Testschlüssel erzeugt keinen Fehler: Er markiert Buchungen mit Geld als bezahlt, das es nicht gibt.
- 2
Den veröffentlichbaren Schlüssel kopieren
Kopiere unter Standard keys den Publishable key. Er beginnt mit pk_live_.
- 3
Den geheimen Schlüssel kopieren
Kopiere den Secret key (klicke auf Reveal live key, falls er verborgen ist). Er beginnt mit sk_live_. Halte ihn geheim: Mit ihm lassen sich Karten in deinem Namen belasten.
Den Webhook in Stripe hinzufügen
Ohne ihn wird Reisenden der Betrag belastet, und ihre Buchungen bleiben unbestätigt.
Deine TourTask-Webhook-Adresse für Stripe Elements
https://api.tourtask.com/v1/payments/stripe-elements/notifications/booking- 1
Ein Ereignisziel erstellen
Öffne dashboard.stripe.com/webhooks, weiterhin im Live-Modus, und klicke auf Create an event destination.
- 2
Dein Konto und Snapshot wählen
Wähle Your account und das Payload-Format Snapshot: TourTask kann die von Stripe empfohlenen Ereignisse vom Typ Thin nicht lesen.
- 3
Das Ereignis auswählen
Wähle payment_intent.succeeded und kein anderes Ereignis.
- 4
Einen Webhook-Endpunkt wählen
Klicke auf Continue und wähle Webhook endpoint als Zieltyp.
- 5
Die TourTask-Adresse eintragen
Klicke auf Continue, füge die TourTask-Adresse von oben in Endpoint URL ein und klicke auf Create destination.
- 6
Das Signaturgeheimnis kopieren
Klicke auf der Seite des Ziels auf Reveal secret und kopiere das Signaturgeheimnis. Es beginnt mit whsec_.
Du hast schon einen Endpunkt für das Stripe-Gateway? Füge trotzdem einen neuen hinzu: Jedes Gateway braucht seinen eigenen.
Stripe Elements in TourTask hinzufügen
- 1
Die Karte Stripe Elements öffnen
Gehe zu Konfiguration → Zahlungsmöglichkeiten und klicke unter Online-Zahlungen → Zahlungsgateways auf die Karte Stripe Elements. Nicht da? Wähle unter den Karten Alle Gateways anzeigen.
- 2
Land und Währung wählen
Wähle unter Land das Land, in dem dein Konto bei Stripe Elements und dessen Bankkonto geführt werden, und unter Währung die Währung, in der Reisende zahlen. Klicke auf Hinzufügen. Um eines davon später zu ändern, entferne Stripe Elements mit Entfernen und füge es neu hinzu.
- 3
API-Zugangsdaten eintragen
Unter Authentifizierung hat die Karte für jede ein Feld:
API-Schlüssel
Veröffentlichbarer Schlüssel
Webhook-GeheimnisJedes Feld wird gespeichert, sobald du es verlässt.
- 4
Stripe Elements aktivieren
Klicke auf Aktivieren, sobald alle Felder ausgefüllt sind. Die Karte wechselt auf Aktiv, und Reisende können auf deiner Buchungsseite mit Stripe Elements zahlen. Jede Zahlung geht direkt auf dein eigenes Konto bei Stripe Elements: TourTask verwahrt dein Geld nie.
API-Schlüssel: dein geheimer Schlüssel sk_live_…
Veröffentlichbarer Schlüssel: dein Schlüssel pk_live_…
Webhook-Geheimnis: dein Signaturgeheimnis whsec_…
Klicke auf der Karte auf Standardmäßig geöffnet, damit das Kartenformular oben auf deiner Buchungsseite geöffnet erscheint.
Prüfen, ob Stripe Elements funktioniert
TourTask hat keinen Testmodus für Stripe Elements, und die Bedingungen von Stripe verbieten Testzahlungen mit echten Karten.
- 1
Das Kartenformular öffnen
Buche auf deiner eigenen Buchungsseite eine Tour und wähle die Zahlung per Karte: Das Kartenformular von Stripe erscheint. Schließe die Seite, ohne zu bezahlen.
- 2
Die Testbuchung stornieren
Öffne die Buchung in TourTask und klicke auf Buchung stornieren.
- 3
Deine erste Zahlung prüfen
Wenn ein Reisender per Karte bezahlt, wird die Buchung als bezahlt angezeigt, und die Zahlung erscheint in deinem Stripe-Dashboard.
- 4
Den Webhook prüfen
Öffne in Stripe die Registerkarte Event deliveries des Ziels: payment_intent.succeeded wird als Delivered angezeigt.
Prüfe den Webhook in Stripe: Live-Modus, Format Snapshot, das Ereignis payment_intent.succeeded und die genaue Adresse. In TourTask muss Webhook-Geheimnis das Signaturgeheimnis dieses Endpunkts enthalten. Die Registerkarte Event deliveries des Ziels in Stripe zeigt jeden fehlgeschlagenen Versuch.
Apple Pay und Google Pay hinzufügen
Apple Pay und Google Pay sind eigene Gateways und werden wie Stripe Elements mit denselben zwei Schlüsseln eingerichtet. Jedes braucht einen eigenen Webhook-Endpunkt unter einer eigenen Adresse, und das Signaturgeheimnis dieses Endpunkts gehört in sein Webhook-Geheimnis.
Apple Pay
https://api.tourtask.com/v1/payments/apple-pay/notifications/bookingGoogle Pay
https://api.tourtask.com/v1/payments/google-pay/notifications/bookingAnders als das Kartenformular erscheinen Wallet-Schaltflächen nur unter Adressen, die in Stripe unter Settings → Payment method domains registriert sind. Registriere jede Adresse, unter der Reisende buchen: deine eigene Webseite, deinefirma.tourtask.com und deine TourTask-Webseite (deinefirma.tourtask.site oder ihre eigene Domain). example.com und www.example.com sind zwei Einträge.
Häufige Fragen
Nein. Die Kartendaten gehen direkt vom Browser des Reisenden an Stripe.
Mit Stripe Elements bleiben Reisende auf deiner Buchungsseite, Stripe schickt sie auf die eigene Seite von Stripe und wieder zurück. Du kannst beide nutzen.
Die, die in deinem Stripe-Dashboard unter den Einstellungen für Zahlungsarten eingeschaltet sind. Karten sind standardmäßig eingeschaltet.
Nein. TourTask rechnet die Buchungssumme in die Währung um, die du für das Gateway gewählt hast.