コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要決済を受け付ける構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つける継続課金
対面決済
Terminal
決済手段
決済業務
残高と売上処理にかかる期間領収書返金とキャンセル
高度な連携システム
決済以外の機能

店舗を管理する

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

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

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

  • 店舗: リーダーをグループ化し、接続ステータスをモニタリングして、実際の使用店舗に基づいて設定を変更することができます。この機能は、複数の連結アカウントのマーケットプレイスで役立ちます。

  • ゾーン: 店舗とリーダーをさらに細かく分類するためのオプションの方法です。ゾーンを使用して、リーダーと店舗のより大きいグループ (国などのより大きな地域や組織のサブブランドなど) を表すことができます。複数の店舗を単一のゾーンに所属させることができ、ゾーンの下に複数のゾーンをグループ化して、階層後続を作成することができます。

メモ

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

店舗

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

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

国必須の住所プロパティー
オーストラリア
カナダ
イタリア
日本+
スペイン
アメリカ
line1, city, state, postal_code, and country
オーストリア
ベルギー
チェコ共和国
デンマーク
エストニア+
フィンランド
フランス
ドイツ
ハンガリー+
ラトビア+
リヒテンシュタイン+
リトアニア+
ルクセンブルク
マレーシア
オランダ
ニュージーランド
ノルウェー
ポーランド+
ポルトガル
ルーマニア+
スロバキア+
スウェーデン
スイス
イギリス
line1, city, postal_code, and country
ブルガリア+
クロアチア+
キプロス+
アイルランド
マルタ+
シンガポール
スロベニア+
line1, postal_code, and country
ジブラルタル+
line1 and country
+現在、この国では Terminal はベータです。
**このモバイル SDK の互換性は、React Native で使用した際にも当てはまります。

よくある間違い

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

ゾーン

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

店舗とゾーンの作成

メモ

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

まず、決済を受け付ける店舗にリーダーを登録する必要があります。

API を使用して新しい Terminal 店舗オブジェクトを作成するには、店舗作成リクエストを使用します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/terminal/locations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d display_name=HQ \
  -d "address[line1]"="1272 Valencia Street" \
  -d "address[city]"="San Francisco" \
  -d "address[state]"=CA \
  -d "address[country]"=US \
  -d "address[postal_code]"=94110

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

ダイレクト支払いを使用するアカウントの店舗を作成するには、リクエストで Stripe-Account ヘッダーを使用します。これらの店舗にアクセスできるのは、認証を行った Connect アカウントのみです。ビジネスを複数の物理的な場所で展開している場合は、ダイレクト支払いを使用する個々のアカウントに対して、複数の店舗を作成できます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/terminal/locations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d display_name=HQ \
  -d "address[line1]"="1272 Valencia Street" \
  -d "address[city]"="San Francisco" \
  -d "address[state]"=CA \
  -d "address[country]"=US \
  -d "address[postal_code]"=94110

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

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

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/terminal/locations \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "display_name"="HQ" \
  -d "address[line1]"="1272 Valencia Street" \
  -d "address[city]"="San Francisco" \
  -d "address[state]"="CA" \
  -d "address[country]"="US" \
  -d "address[postal_code]"="94110" \
  -d "metadata[connected_account]"=
"{{CONNECTED_ACCOUNT_ID}}"

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

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

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

メモ

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

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/terminal/connection_tokens \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d location=
"{{LOCATION_ID}}"