Pro vývojáře

Testovací režim a sandboxy

Vývojáři můžou vyvíjet a testovat proti testovacímu podniku v sandboxu s klíči bk_test_, kde se nic nedostane ke skutečnému klientovi a nehýbou se žádné skutečné peníze.

Co to je

Sandbox je testovací podnik uvnitř Bookatu, určený k vývoji a testování integrace. Odpovídá na stejné API se stejnými pravidly rezervací a posílá stejné webhooky jako živý podnik, ale každý e-mail, SMS a upozornění, které by poslal, se uloží do jeho Outbox a jeho platby procházejí simulovanou platební stránkou, pokud není nastavený na testovací režim Stripe. Kompletní průvodce pro vývojáře je Testing with a sandbox na /developers/testing.

Proč se to hodí

Váš vývojář může vyzkoušet každé volání, včetně záloh a webhooků, aniž by se dotkl vašeho skutečného podniku, vašich klientů nebo skutečné karty. Sandbox ukazuje Test mode na každé stránce své administrace a „Testovací firma“ na svých rezervačních stránkách a nikdy není nikde veřejně uvedený.

Jak to používat

  1. 1Přihlaste se účtem Bookatu s potvrzeným e-mailem a otevřete /developers/sandbox. Podnik na Bookatu nepotřebujete. Vyberte název, časové pásmo a měnu, přijměte podmínky testovacího režimu a vytvořte svůj sandbox. Najednou můžete mít až 3. Pokud stránka říká, že vytváření sandboxů je teď vypnuté, ještě nejsou otevřené.
  2. 2Každý sandbox má ukázkový personál, služby, klienty a rezervace a první testovací klíč se všemi oprávněními. Testovací klíče začínají bk_test_ a živé klíče bk_live_. Další klíče a webhooky vytvoříte ve vlastní administraci sandboxu, v Settings, pak API & monitoring.
  3. 3Testovací klíč funguje jen na sandboxu a živý klíč jen na živém podniku. Opačná kombinace se odmítne dřív, než cokoli proběhne, s 403 LIVEMODE_MISMATCH, a každá odpověď v livemode říká, k jakému druhu podniku dorazila.
  4. 4Co by sandbox poslal, najdete v Outbox v jeho administraci a každou simulovanou platbu, kterou provedl, v Test payments hned vedle: zaplacenou, odmítnutou, opuštěnou nebo vrácenou. Jeho simulované platební stránky mají místo formuláře pro kartu tlačítka Pay (test), Decline (test) a Abandon. Do sandboxu nikdy nezadávejte číslo skutečné karty. Simulátor nechá události proběhnout hned, například zaplacení zálohy.
  5. 5Platby můžou tam, kde se to nabízí, místo simulátorem procházet i testovacím režimem Stripe. V Test payments zvolte Connect a Stripe test account a stránky Stripe vyplňte jen testovacími údaji Stripe, nikdy svým skutečným dokladem totožnosti nebo bankovním účtem. Pokud skončíte v půlce, Continue on Stripe vás vrátí zpátky a Check again ukáže, jestli je účet připravený. Pak zvolte Turn on Stripe test mode. Nové platby otevřou vlastní platební stránku Stripe, kde platíte testovací kartou, například 4242 4242 4242 4242, a vypíšou se ve Finance. Žádné skutečné peníze se nehýbou. Na simulované platby se můžete vrátit, kdykoli chcete.
  6. 6Reset sandbox vymaže a naplní čerstvými ukázkovými daty a Delete ho odstraní, obojí ze stránky vašich sandboxů. Sandbox, který nikdo 30 dní nepoužije, se smaže a 7 dní předem dostanete e-mail.
  7. 7Každé volání s příklady najdete v Testing with a sandbox na /developers/testing a jako markdown na /developers/testing.md. Až to funguje, Going live na /developers/going-live vysvětlí, jak přejít na klíč živého podniku.

Was this helpful?

Nenašli jste, co potřebujete?

Kontaktovat podporu nebo si projděte časté otázky.