場所を管理する

リーダーを実際の使用場所ごとにグループ化して管理します。

場所とゾーンを使用することで、さまざまな実店舗での複数のリーダーの管理を効率化できます。

場所とゾーンは、各リーダーを特定の運用サイトに関連付けることで役立ち、正しい地域設定がダウンロードされます。

Locations: リーダーをグループ化し、接続ステータスをモニタリングして、実際の使用場所に基づいて設定を変更することができます。この機能は、複数の連結アカウントのマーケットプレイスで役立ちます。
Zones: 場所とリーダーをさらに細かく分類するためのオプションの方法です。ゾーンを使用して、リーダーと場所のより大きいグループ (より大きな地域 (国など) や組織のサブブランドなど) を表すことができます。複数の場所を単一のゾーンに所属させることができ、ゾーンの下に複数のゾーンをグループ化して、階層後続を作成することができます。

注

ゾーンは、場所をグループ化する追加の方法を提供します。さらに、リーダーを場所に割り当てる必要があります。場所を割り当てることができるのは 1 つのゾーンのみです。

場所

リーダーを運用する実際の場所ごとに場所を作成できます。各場所に複数のリーダーを登録し、それらの場所をゾーン内にネストできます。リーダーを使用する前に、それを場所に登録する必要があります。

場所に必要な住所プロパティーは国によって異なります。

国	必須の住所プロパティー
オーストラリアカナダイタリアスペインアメリカ	`line1`, `city`, `state`, `postal_code`, and `country`
オーストリア⁺ ベルギーチェコ共和国⁺ デンマークフィンランド⁺ フランスドイツルクセンブルク⁺ マレーシア⁺ オランダニュージーランド⁺ ノルウェー⁺ ポルトガル⁺ スウェーデンスイス⁺ イギリス	`line1`, `city`, `postal_code`, and `country`
アイルランドシンガポール	`line1`, `postal_code`, and `country`

⁺現在、この国では Terminal はベータです。

**このモバイル SDK の互換性は、React Native で使用した際にも当てはまります。

よくある間違い

ダッシュボードまたは API を使用して Location オブジェクトを更新できます。場所の作成後に、国を変更することはできません。代わりに、新しい国で新しい場所を作成して、古い場所に関連付けられているリーダーを再登録することは可能です。

ゾーン

ゾーンは最上位のグループであり、複数のゾーンまたは場所で構成できます。既存のゾーンの下にネストされたゾーンをさらに追加し、「西海岸」のような追加の階層レベルを作成できます。ただし、ゾーンに場所を整理することはオプションです。

場所とゾーンを作成

注

API を使用してゾーンを作成または変更することはできません。

最初に、決済を受け付けるにはリーダーを場所に登録する必要があります。

API を使用して新しい Terminal Location オブジェクトを作成するには、Create location (場所の作成) リクエストを使用します。

ダイレクト支払いを使用してアカウントの場所を作成する

ダイレクト支払いを使用してアカウントの場所を作成するには、リクエストで Stripe-Account ヘッダーを使用します。これらの場所にアクセスできるのは、認証された Connect アカウントのみです。ビジネスが複数の実店舗で運営されている場合、ダイレクト支払いを使用する個人アカウントに対して複数の場所を作成できます。

デスティネーション支払いを使用してアカウントの場所を作成する

デスティネーション支払いを使用する実装の場合、場所は「プラットフォーム」アカウントに属し、厳密には Connect アカウントにマッピングされません。プラットフォームでデスティネーション支払いを使用するアカウントと場所を関連付ける必要がある場合は、場所の metadata プロパティに、関連するアカウントへの参照を格納できます。

リーダーを場所に登録すると、指定した場所でリーダーがグループ化され、その国の設定が定義されます。

接続トークンの範囲を指定するサーバー側スマートリーダー

Terminal SDK の接続トークンを作成する際は、location パラメーターを指定して、スマートリーダーへのアクセスを制御できます。場所を指定すると、ConnectionToken はその場所に割り当てられたスマートリーダーでのみ利用可能になります。場所を指定しなければ、すべてのリーダーで ConnectionToken を使用できます。

注

Bluetooth リーダーの場合、ConnectionToken の location は何も影響しません。このため、いつでも近くにある Bluetooth リーダーを検出できます。