Diese Anleitung zeigt, wie du dein Konto mit dem Teya-System verbindest und wie du Zahlungen direkt über die Plattform nach deinen Buchungen abwickeln kannst.
1. Teya-API-Daten und Store-ID erhalten
Für die automatische Kommunikation zwischen den beiden Systemen benötigst du folgende Daten aus deinem Teya-Konto:
- Store-ID
- Client-ID
- Client Secret
- Melde dich bei deinem Teya-Konto / Entwicklerportal an.
- Gehe zu Einstellungen > Integrationen.
- Erstelle einen neuen API-Schlüssel / eine neue Anwendung für unsere Plattform.
- Kopiere die generierte Client-ID und das Client Secret.
- Suche und kopiere die Store-ID.
2. Teya mit der Plattform verbinden und Webhook einrichten
Nachdem du die benötigten Daten erhalten hast, kehre zu unserer Plattform zurück, um die Integration abzuschließen.
- Gehe zur Seite Externe Anwendungen.
- Suche die Teya-Karte und klicke unter Teya auf die Schaltfläche API-Daten verknüpfen.
- Fülle im Pop-up-Fenster die erforderlichen Felder (Store-ID, Client-ID, Client Secret) aus.
- Im Pop-up-Fenster wird eine eindeutige Webhook-URL für dein Konto angezeigt (
https://appointio.eu/teya/webhook). Kopiere diese URL! - Kehre zur Teya-Oberfläche zurück und gehe zu den Webhook-Einstellungen. Füge die kopierte URL in das Webhook-Feld ein. Füge anschließend den erhaltenen Webhook-Schlüssel in das untere Feld auf unserer Plattform ein und klicke auf Speichern.
- Der Testmodus muss nur aktiviert werden, wenn du dein Testkonto von teya.xyz verbinden möchtest.
3. Zahlungen über Buchungen verwalten
Nach der Verbindung und der Konfiguration des Webhooks ist das System bereit, Teya-Transaktionen zu verarbeiten. Um zu beginnen, aktiviere auf der Konfigurationsseite der gewünschten Dienstleistungen die Option Online-Zahlung.
Wichtige Regel:
Wenn eine Teya-Transaktion bei der Buchung fehlschlägt, haben Kunden 15 Minuten Zeit, die Zahlung abzuschließen. Andernfalls wird der reservierte Zeitraum automatisch wieder freigegeben.
Was passiert nach der Zahlung?
Im Hintergrund übermittelt unser System die Daten sofort an das Teya-System.
- Die Transaktion wird gestartet und über das Teya-Netzwerk verarbeitet.
- Teya sendet automatisch über die angegebene Webhook-URL (
https://appointio.eu/teya/webhook) eine Benachrichtigung über den Zahlungsstatus zurück. - Der Status der Buchung wird auf unserer Plattform automatisch auf bezahlt aktualisiert. Du musst nichts weiter tun!
