Für Entwickler

Testmodus und Sandboxes

Entwickler können mit bk_test_-Schlüsseln gegen ein Sandbox-Geschäft bauen und testen, bei dem nichts einen echten Kunden erreicht und kein echtes Geld fließt.

Was es ist

Eine Sandbox ist ein Testgeschäft in Bookatu, gemacht, um eine Integration zu bauen und zu testen. Sie beantwortet dieselbe API mit denselben Buchungsregeln und schickt dieselben Webhooks wie ein Live-Geschäft, aber jede E-Mail, SMS und Benachrichtigung, die sie schicken würde, bleibt in ihrer Outbox, und ihre Zahlungen laufen über einen simulierten Checkout, außer sie ist für den Stripe-Testmodus eingerichtet. Der vollständige Entwicklerleitfaden ist Testing with a sandbox unter /developers/testing.

Warum es hilft

Dein Entwickler kann jeden Aufruf ausprobieren, Anzahlungen und Webhooks eingeschlossen, ohne dein echtes Geschäft, deine Kunden oder eine echte Karte zu berühren. Eine Sandbox zeigt auf jeder Seite ihres Adminbereichs Test mode und auf ihren Buchungsseiten 'Testunternehmen', und sie wird nirgends öffentlich gelistet.

So nutzt du es

  1. 1Melde dich mit einem Bookatu-Konto mit bestätigter E-Mail an und öffne /developers/sandbox. Du brauchst kein Geschäft auf Bookatu. Wähl einen Namen, eine Zeitzone und eine Währung, akzeptier die Bedingungen für den Testmodus und leg deine Sandbox an. Du kannst bis zu 3 gleichzeitig haben. Sagt die Seite, dass das Anlegen von Sandboxes gerade ausgeschaltet ist, sind sie noch nicht geöffnet.
  2. 2Jede Sandbox kommt mit Beispieldaten für Team, Leistungen, Kunden und Buchungen und einem ersten Testschlüssel mit allen Scopes. Testschlüssel beginnen mit bk_test_, Live-Schlüssel mit bk_live_. Weitere Schlüssel und Webhooks legst du im eigenen Adminbereich der Sandbox an, unter Settings, dann API & monitoring.
  3. 3Ein Testschlüssel funktioniert nur bei einer Sandbox und ein Live-Schlüssel nur bei einem Live-Geschäft. Andersherum wird abgelehnt, bevor etwas läuft, mit 403 LIVEMODE_MISMATCH, und jede Antwort sagt in livemode, welche Art von Geschäft sie erreicht hat.
  4. 4Was die Sandbox geschickt hätte, steht in ihrem Adminbereich unter Outbox, und jede simulierte Zahlung, die sie gemacht hat, gleich daneben unter Test payments: bezahlt, abgelehnt, abgebrochen oder erstattet. Ihre simulierten Checkouts haben statt eines Kartenformulars die Buttons Pay (test), Decline (test) und Abandon. Gib nie eine echte Kartennummer in eine Sandbox ein. Der Simulator lässt Ereignisse sofort passieren, etwa dass eine Anzahlung bezahlt wird.
  5. 5Zahlungen können statt über den Simulator auch über den Stripe-Testmodus laufen, wo er angeboten wird. Wähl unter Test payments Connect a Stripe test account und füll die Seiten von Stripe nur mit den Testangaben von Stripe aus, nie mit deinem echten Ausweis oder Bankkonto. Hörst du mittendrin auf, bringt dich Continue on Stripe zurück, und Check again zeigt, ob das Konto bereit ist. Wähl dann Turn on Stripe test mode. Neue Zahlungen öffnen die eigene Checkout-Seite von Stripe, wo du mit einer Testkarte wie 4242 4242 4242 4242 bezahlst, und sie stehen unter Finance. Es fließt kein echtes Geld. Wechsel zurück zu simulierten Zahlungen, wann immer du willst.
  6. 6Reset leert eine Sandbox und füllt sie mit frischen Beispieldaten, und Delete entfernt sie, beides auf deiner Seite mit den Sandboxes. Eine Sandbox, die 30 Tage lang niemand nutzt, wird gelöscht, und du bekommst 7 Tage vorher eine E-Mail.
  7. 7Jeder Aufruf steht mit Beispielen in Testing with a sandbox unter /developers/testing, und als Markdown unter /developers/testing.md. Wenn alles funktioniert, erklärt Going live unter /developers/going-live, wie du zum Schlüssel eines Live-Geschäfts wechselst.

Was this helpful?

Nicht gefunden, was du brauchst?

Support kontaktieren oder geh zu den häufigen Fragen.