テストモードとサンドボックス
開発者は、bk_test_ のキーを使ってサンドボックスのビジネスで開発やテストができます。実際のお客様に何かが届くことも、実際のお金が動くこともありません。
どんな機能か
サンドボックスは、連携の開発とテストのために作られた、Bookatuの中のテスト用のビジネスです。本番のビジネスと同じAPIに同じ予約のルールで応答し、同じWebhookを送りますが、送るはずのメール、SMS、通知はすべて「Outbox」に保管されます。お支払いは、Stripeのテストモードに設定していない限り、模擬の決済を通ります。開発者向けの詳しいガイドは、/developers/testing にある「Testing with a sandbox」です。
どう役立つか
開発者は、デポジットやWebhookも含めたすべての呼び出しを、本番のお店、お客様、実際のカードに触れずに試せます。サンドボックスでは、管理画面のすべてのページに「Test mode」、予約ページには「テスト用ビジネス」と表示され、公開の場所に掲載されることはありません。
使い方
- 1メールアドレスを確認済みのBookatuアカウントでログインし、/developers/sandbox を開きます。Bookatu上のお店は必要ありません。名前、タイムゾーン、通貨を選び、テストモードの規約に同意して、サンドボックスを作ります。同時に持てるのは3つまでです。ページに、サンドボックスの作成は現在オフになっていると表示される場合は、まだ公開されていません。
- 2どのサンドボックスにも、サンプルのスタッフ、メニュー、お客様、予約と、すべてのスコープを持つ最初のテストキーが入っています。テストキーは bk_test_ で、本番のキーは bk_live_ で始まります。キーやWebhookを追加するには、サンドボックス自身の管理画面で「Settings」の「API & monitoring」を開きます。
- 3テストキーはサンドボックスでだけ、本番のキーは本番のビジネスでだけ使えます。逆の組み合わせは、何かが実行される前に 403 LIVEMODE_MISMATCH で拒否されます。どの応答でも、livemode に、どちらの種類のビジネスに届いたかが示されます。
- 4サンドボックスが送るはずだったものは管理画面の「Outbox」に、模擬のお支払いはすべてその隣の「Test payments」に、支払い済み、拒否、中止、返金のいずれかとして並びます。模擬の決済画面には、カードの入力欄の代わりに「Pay (test)」「Decline (test)」「Abandon」のボタンがあります。サンドボックスには、絶対に実際のカード番号を入力しないでください。シミュレーターでは、デポジットの支払いなどのイベントをすぐに起こせます。
- 5利用できる場合は、シミュレーターの代わりにStripeのテストモードでお支払いを通すこともできます。「Test payments」で「Connect a Stripe test account」を選び、Stripeのページには、Stripeのテスト用の情報だけを入力します。実際の身分証や銀行口座は決して入力しないでください。途中でやめた場合は「Continue on Stripe」で戻れ、「Check again」でアカウントの準備ができたかを確認できます。そのあと「Turn on Stripe test mode」を選びます。新しいお支払いではStripe自身の決済ページが開き、4242 4242 4242 4242 のようなテストカードで支払います。お支払いは「Finance」に並びます。実際のお金は動きません。模擬のお支払いには、いつでも戻せます。
- 6サンドボックスのページで、「Reset」を押すとサンドボックスが消去されて新しいサンプルデータが入り、「Delete」を押すと削除されます。30日間誰も使わなかったサンドボックスは削除され、その7日前にメールが届きます。
- 7すべての呼び出しは、例とともに /developers/testing の「Testing with a sandbox」に載っていて、/developers/testing.md ではマークダウンで読めます。うまく動いたら、/developers/going-live の「Going live」に、本番のビジネスのキーへの切り替え方が書かれています。
Was this helpful?
お探しのものが見つかりませんでしたか?
サポートに問い合わせる または よくある質問をご覧ください.