APIとWebhookの活用例

決済に合わせた暗証番号の自動発行|支払いが済んだ予約にだけ、利用時間だけ使えるカギを送るしくみ

支払いが済んだ予約にだけ、利用時間だけ使える暗証番号を自動で発行して送れます。
レンタルスペースや貸し会議室など、予約と同時にオンラインで代金を受け取る施設で、決済の完了をきっかけにRemoteLOCK APIを使う例です。
こんなとき

支払いの確認と番号の発行をまとめて自動にできます

支払いを確かめてからクラウド管理画面でアクセスゲストを登録していると(アクセスゲストの追加)、確認に手間がかかり、直前の予約では発行が間に合わないこともあります。確認の前に番号を渡すと、未払いのまま使われるおそれがあります。決済の完了を受けてAPIで予約を作るようにすると、支払いが済んだ予約にだけ、自動で番号が届きます。
しくみ

決済が済んだら、予約の内容を送ります

決済から入室までの流れの図。1 予約する人:予約して代金を支払う。予約と同時にオンラインで決済します。2 貴社が作る連携:決済の完了を受けて予約を作る。名前・扉・開始と終了の日時を送ります。3 RemoteLOCK:利用時間だけ使えるカギを作る。カギのURLを返します。扉には次の通信で届きます。4 貴社が作る連携:カギのURLをメールで送る。表に書き戻すのは予約のIDまでにします。5 予約する人:時間内に暗証番号で開ける。URLの画面に番号やQRコードが出ます。6 扉:終了の時刻で使えなくなる。番号を消す操作は要りません。「貴社が作る連携」は、貴社か開発会社で作っていただく部分です
決済のサービスから支払い完了の知らせが届くと、貴社で作る連携のプログラムが、予約した人の名前、使う扉、開始と終了の日時をRemoteLOCK APIに送ります。RemoteLOCKは、その時間だけ使える暗証番号などのカギを作り、カギの画面のURL(ユニバーサルアクセスキー)を返します。連携のプログラムが、このURLを予約した人にメールで送ります。支払いが済んでいない予約には、カギは作られません。
返金やキャンセルをしたときは、その予約を無効にします。扉で番号が使えなくなるのは、本体が次に通信したときです。無効にした予約は記録として残ります。予約の時間を変えてもURLは変わらないため、送り直さずに済みます(ユニバーサルアクセスキー)。
※ お使いの予約システムがすでにRemoteLOCKと連携している場合は、開発は要りません。連携済みのサービスは 予約エンドポイントに対応した連携サービス と 連携システム一覧(公式サイト)でご覧いただけます。
必要なもの

始める前に4つがそろっているかお確かめください

必要なもの 中身
料金プラン ビジネス スタンダード以上で、お支払いが有効なこと(ご利用までの手続き)
アカウントとデバイス 有効なRemoteLOCKのアカウントに、扉のデバイスが登録されていること
契約 機密保持契約(NDA)。APIのご利用に必要です。API利用料はかかりません
連携のプログラム 貴社か、ご依頼先の開発会社で作っていただきます。弊社は開発の受託や技術支援を行っておりません
気をつける点

作る前にお確かめいただきたいこと

  • 番号も、予約の変更や取り消しも、扉に届くのは本体が次にクラウドと通信したときです。予約は早めに作り、延長は元の終了の時刻まで余裕をもって送ってください。直前の予約にはプールPINを使えます(ハートビート通信のしくみ、プールPIN)
  • 開始の少し前から入れるようにしたいときは、マージンで、開けられる時間を前後に延ばせます。設定したあとに作った予約にだけ効きます(Bookings API設定)
  • 暗証番号やカギのURLは、見られる人が多い表やチャットに残さないでください。表に書き戻すのは、予約のIDまでにするのがおすすめです
  • APIを呼べる回数には上限があります。予約をまとめて作るときは、間隔をあけて送ってください
始め方

まずはAPI資料をお申し込みください

API資料のお申し込み からご請求いただくと、概要資料と、機密保持契約(NDA)の手続きのご案内をお送りします。NDAの締結後に、API仕様書と、動作を確かめるためのサンプルのアカウントとデバイスの情報をお送りします。手続きの流れは RemoteLOCK APIのご利用までの手続き に、そのほかの使い方は RemoteLOCK APIでできること にまとめています。
関連する記事

最終更新

この記事は役に立ちましたか?

0人中0人がこの記事が役に立ったと言っています

記事で解決しないときは

問い合わせフォーム(24時間受付)か、お電話でご相談ください。