Dla programistów

Tryb testowy i sandboksy

Programiści mogą budować i testować na firmie testowej w sandboksie z kluczami bk_test_, gdzie nic nie trafia do prawdziwego klienta i nie przesuwa prawdziwych pieniędzy.

Czym to jest

Sandbox to firma testowa w Bookatu, stworzona do budowania i testowania integracji. Odpowiada na to samo API z tymi samymi zasadami rezerwacji i wysyła te same webhooki co prawdziwa firma, ale każdy e-mail, SMS i powiadomienie, które by wysłał, trafia do jego Outbox, a jego płatności przechodzą przez symulowaną płatność, chyba że ma ustawiony tryb testowy Stripe. Pełny przewodnik dla programistów to Testing with a sandbox, pod adresem /developers/testing.

W czym pomaga

Twój programista może wypróbować każde wywołanie, łącznie z zadatkami i webhookami, bez dotykania Twojej prawdziwej firmy, Twoich klientów czy prawdziwej karty. Sandbox pokazuje Test mode na każdej stronie swojego panelu i „Firma testowa” na swoich stronach rezerwacji i nigdy nie jest nigdzie publicznie wymieniony.

Jak z tego korzystać

  1. 1Zaloguj się kontem Bookatu z potwierdzonym e-mailem i otwórz /developers/sandbox. Nie potrzebujesz firmy w Bookatu. Wybierz nazwę, strefę czasową i walutę, zaakceptuj warunki trybu testowego i utwórz swój sandbox. Możesz mieć do 3 naraz. Jeśli strona mówi, że tworzenie sandboksów jest w tej chwili wyłączone, nie są jeszcze dostępne.
  2. 2Każdy sandbox ma przykładowy personel, usługi, klientów i rezerwacje oraz pierwszy klucz testowy ze wszystkimi zakresami. Klucze testowe zaczynają się od bk_test_, a klucze produkcyjne od bk_live_. Więcej kluczy i webhooków utworzysz we własnym panelu sandboksa, w Settings, potem API & monitoring.
  3. 3Klucz testowy działa tylko w sandboksie, a klucz produkcyjny tylko w prawdziwej firmie. Odwrotne użycie jest odrzucane, zanim cokolwiek się wykona, z 403 LIVEMODE_MISMATCH, a każda odpowiedź podaje w livemode, do jakiego rodzaju firmy trafiła.
  4. 4To, co sandbox by wysłał, jest w Outbox w jego panelu, a każda symulowana płatność, którą wykonał, jest obok, w Test payments: opłacona, odrzucona, porzucona albo zwrócona. Jego symulowane płatności mają przyciski Pay (test), Decline (test) i Abandon zamiast formularza karty. Nigdy nie wpisuj w sandboksie prawdziwego numeru karty. Symulator sprawia, że zdarzenia dzieją się od razu, na przykład opłacenie zadatku.
  5. 5Płatności mogą też przechodzić przez tryb testowy Stripe zamiast przez symulator, tam, gdzie jest dostępny. W Test payments wybierz Connect a Stripe test account i wypełnij strony Stripe wyłącznie testowymi danymi Stripe, nigdy swoim prawdziwym dokumentem tożsamości ani kontem bankowym. Jeśli przerwiesz w połowie, Continue on Stripe zabierze Cię z powrotem, a Check again pokaże, czy konto jest gotowe. Potem wybierz Turn on Stripe test mode. Nowe płatności otwierają własną stronę płatności Stripe, gdzie płacisz kartą testową, na przykład 4242 4242 4242 4242, i są widoczne w Finance. Żadne prawdziwe pieniądze się nie przesuwają. Do symulowanych płatności możesz wrócić, kiedy chcesz.
  6. 6Reset czyści sandbox i wypełnia go świeżymi przykładowymi danymi, a Delete go usuwa, oba ze strony z Twoimi sandboksami. Sandbox, którego nikt nie używa przez 30 dni, jest usuwany, a 7 dni wcześniej dostajesz e-mail.
  7. 7Każde wywołanie, z przykładami, jest w Testing with a sandbox pod adresem /developers/testing, a jako markdown pod adresem /developers/testing.md. Gdy wszystko działa, Going live pod adresem /developers/going-live wyjaśnia, jak przejść na klucz prawdziwej firmy.

Was this helpful?

Nie znalazłeś tego, czego szukasz?

Skontaktuj się z pomocą albo przejrzyj FAQ.