API-Integrationsprozess
API-Integrationsprozess
Sandbox (Testumgebung):
Sie haben Zugang zu Produkten, die Sie im Rahmen der Partnerschaft mit bookingkit GmbH (44001) testen können. In dieser Testumgebung können Sie die API-Integration ausprobieren, ohne dass reale Transaktionen stattfinden.
Sie können die verschiedenen Veranstaltungen und Verfügbarkeiten hier einsehen
API Dokumentation: https://developers.bookingkit.de/api_v3/ui
Sandbox (Testumgebung) API-URL:https://api-sandbox.bookingkit.de/
Auth Client ID: Wird nach Unterzeichnung der kommerziellen Vereinbarung geteilt.
Auth Client Secret: Wird nach Unterzeichnung der kommerziellen Vereinbarung geteilt.
Sobald du denkst, dass du fertig bist und bereit für die Produktionsumgebung, musst du uns über die Testbuchungen informieren, damit wir dies auf unserer Seite überprüfen können.
Wenn du ein bookingkit-Widget inklusive Checkout oder nur den bookingkit Checkout verwendest, kannst du hier die Zahlungsmethoden mit Stripe testen. Weitere Informationen dazu findest du in der Widget-Dokumentation.
Test-Event - Termine mit festen Dauerzeiten
1 Teilnehmer: Montag, 10 Uhr: Standarddauer (60 Minuten) - Standardpreisliste
2 Teilnehmer: Montag, 15 Uhr: Zusätzliche Dauer (30 Minuten) - Standardpreisliste
1 Teilnehmer: Samstag, 10 Uhr: Standarddauer (60 Minuten) - Wochenendpreisliste
2 Teilnehmer: Samstag, 15 Uhr: Zusätzliche Dauer (30 Minuten) - Wochenendpreisliste
Test-Event - Termine mit Öffnungszeiten
1 Teilnehmer: Sonntag, 15 Uhr: Zusätzliche Dauer (30 Minuten) - Wochenendpreisliste
Bitte sende uns die bookingkit-Referenzcodes und teile uns mit, welcher Teil der Integration aus der folgenden Liste abgeschlossen wurde: Liste der Veranstaltungen (Erlebnisse), Bestellungen und Stornierungen, Verfügbarkeiten, Produktinhalte (Bilder & Texte), Preise, Tickets, zusätzliche Produkte, Öffnungszeiten, Buchungen auf Anfrage.
!BITTE MACHEN SIE KEINE TESTBESTELLUNGEN!
API URL: https://api.bookingkit.de/v3/
Wir werden dir Zugangsdaten für die Live-Produktionsumgebung senden.
BITTE MACHEN SIE KEINE TESTBESTELLUNGEN!
bookingkit Widget/Checkout-Dokumentation
bookingkit Widget/Checkout-Dokumentation
Bei der Integration des bookingkit Widgets/Checkouts kannst du entscheiden, welche Elemente du von der bookingkit-Erlebnis-Seiten-Widget integrieren möchtest.
Für die Implementierung des bookingkit Widgets muss der folgende Code auf deiner Website implementiert werden. Die beiden Codezeilen fügen einfach sämtliches HTML in den bookingkit-Container ein.
<div id="bookingkitContainer" data-e="eventID"></div>
<script src="https://vendorID.widget.bookingkit.net/bkscript/?e=eventID&ref=ref" async></script>
Wie erhält man die eventID und vendorID?
- Über die bookingkit API
VendorID – Mit dem API-Endpunkt v3/vendors kannst du die Liste der verfügbaren Vendor-IDs einsehen.
eventId – Mit dem API-Endpunkt v3/events kannst du die Liste der verfügbaren Events einsehen.
- In der Aktivierungs-E-Mail, die von bookingkit gesendet wird, nachdem ein Anbieter die Verbindung in bookingkit aktiviert hat.
Wie erhält man den Ref?
Dieser wird vom technischen Team von bookingkit bereitgestellt und ermöglicht es bookingkit, die Verkäufe korrekt zuzuordnen.
Wie bereits erwähnt, kannst du auch wählen, nur den bookingkit Checkout zu verwenden, um Endkunden zu belasten. In diesem Fall musst du deinen eigenen Kalender verwenden und die Checkout-URL abrufen, die mit einem bestimmten Datum und Event verknüpft ist (Verwendung des /dates API-Endpunkts).
Anpassung:
Alle CSS der umgebenden Seite können angepasst werden. Hinweis: Kopiere einfach die Blöcke und füge sie hinter den Integrationscode ein. Wenn mehr als nur CSS-Code verwendet wird, muss das .... nur einmal verwendet werden, und das gesamte CSS muss dazwischen stehen. Unten sind einige Beispiele. Variable Werte sind kursiv dargestellt.
Anpassung
Anpassung
Tracking:
- Du kannst Tracking-Codes im Widget hinzufügen (nicht im Checkout).
- Tracking ist im Checkout nicht möglich.
Tickets: Die verwendeten Tickets sind die des Anbieters (Branding ist nicht möglich).
Customer Success: Der Customer Success wird vom Anbieter übernommen.
Aktivierungsbenachrichtigung:
Du erhältst eine E-Mail, wenn der Anbieter die Verbindung im bookingkit-Backend aktiviert, mit:
- Kontaktdaten des Anbieters
- Liste der aktiven Events des Anbieters
- Ein Link zur Vorschau des Widgets
bookingkit Verticals
Bitte finde unseren Vertical-Baum unter diesem Link. Über die API wird immer die dritte Kategorie übermittelt (falls sie vom Anbieter ausgewählt wurde). Ein Mapping mit deinen Kategorien oder unseren Kategorien muss dann auf deiner Seite vorgenommen werden.
Go Live
Sobald die Testphase abgeschlossen ist, erstellen wir die Live-API-Zugangsdaten und den Ref für dich. Sobald dies auf deiner Seite implementiert wurde, schalten wir dich in unserem Backend auf live, damit du unseren Anbietern zur Verfügung stehst.