ハードウェアを注文する

リーダーのハードウェアおよびアクセサリーの注文方法をご紹介します。

ダッシュボードから、または Stripe API (ベータ) を使用して、Stripe Terminal と互換性のある事前認証済みのリーダーを注文します。Stripe から直接リーダーを購入することにより、Stripe の決済アプリケーションと安全な暗号化キーがリーダーに読み込まれます。

使用を開始するには、ダッシュボードのリーダーセクションに移動します。購入をクリックして提供されている商品を表示します。

購入する商品

最初に、物理ハードウェアで組み込み全体をテストするため、リーダーとテストカードを注文します。組み込みの準備が整ったら、必要な個数のリーダーを注文します。

必要なリーダーが不明な場合は、導入方法の設計を参照して、導入に適したいずれかのリーダーを選択してください。

1 回の注文で各アイテムを 10000 個まで注文できます。ボリュームディスカウントの情報をご希望の場合は、お問い合わせください。

料金体系

各リーダーの価格は国によって異なります。ダッシュボードで最新価格を確認できます。

	Stripe リーダー M2	BBPOS WisePOS E	BBPOS WisePad 3	Stripe リーダー S700

オーストラリア	–	329 AUD	89 AUD	499 AUD
カナダ	–	299 CAD	79 CAD	449 CAD
オーストリアフランスドイツアイルランドベルギースペインオランダルクセンブルクフィンランドポルトガルイタリア	–	199 EUR	59 EUR	299 EUR
チェコ共和国	–	4,990 CZK	1,490 CZK	7250 CZK
マレーシア	–	999 MYR	279 MYR	1499 MYR
ニュージーランド	–	349 NZ	99 NZ	549 NZ
シンガポール	–	299 SGD	89 SGD	449 SGD
イギリス	–	179 GBP	49 GBP	279 GBP
Switzerland	–	199 CHF	59 CHF	329 CHF
Norway	–	1,990 NOK	590 NOK	3590 NOK
デンマーク	–	1,499 DKK	449 DKK	2400 DKK
スウェーデン	–	2,195 SEK	645 SEK	3490 SEK
アメリカ	59 USD	249 USD	–	349 USD
	今すぐ購入アメリカのみ	今すぐ購入	今すぐ購入アメリカ以外	今すぐ購入

注文を追跡してキャンセルする

注文後は、ダッシュボードでステータスを確認できます。

ステータス	定義
保留中	注文を受け付けました。まもなくフルフィルメントを開始します。必要に応じて、ダッシュボードでこの注文をキャンセルできます。注文は 30 分以上保留状態になります。
配送可能	注文の配送準備をしており、キャンセルはもうできません。注文が配送された後、注文をキャンセルするには返品を開始する必要があります。追跡番号が利用可能になると、注文は配送済みになります。
配送済み	販売業者が指定された注文。追跡情報は、注文の詳細ページで確認できます。
配達済み	商品は配送されています。
キャンセル済み	注文はキャンセルされました。

セルフサービスでの返品

セルフサービスでの返品は、特定の国 (以下の国を参照) で注文され、出荷された商品を対象としています。その他すべての注文については、セルフサービスでの返品に対応していない国での返品をご覧ください。

セルフサービスでの返品に対応可能な国で Stripe ダッシュボードを使用して注文し、注文したアイテムの一部または全部を返品する必要がある場合、十分な権限が付与されているユーザーは、Stripe ダッシュボードで返品を開始できます。元の梱包のままである (すべてのアクセサリーを含む) 場合、Stripe は購入日から 30 日間はその注文に対する返金を承諾できます。30 日を超えた返品については、Stripe サポートにお問い合わせください。

ダッシュボードでフローを進めると、返品配送ラベルが作成されます。返品配送ラベルを作成した後、現地の配送業者で荷物を引き渡すことができます。

Stripe は、流通機関で返品を受け取ったときに支払いを返金します。クレジットカードの場合、このプロセスには、資金が銀行口座に返金されるまでに最大 10 日かかることがあります。

セルフサービスでの返品に対応可能な国

アイテムを返品ボタンを選択する

ダッシュボードでの返品を開始するには、ハードウェアの注文に進み、返品する注文を選択します。注文を選択した後、アイテムを返品をクリックして、プロセスを開始します。アイテムを返品ボタンは、ハードウェアの注文のステータスが Shipped または Delivered の場合に Terminal の注文詳細ページで使用できます。

返品するユニット数を確認する

ポップアップが開いたら、注文の商品ごとに返品するアイテムの数を選択します (複数のアイテムがある場合)。返品の対象となるアイテムの数のみが表示されます。そのため、以前に 3 個のアイテムを購入して、1 個を返品した場合は、返品するユニットを最大 2 個までしか選択できません。

返品の金額を計算する

希望するアイテムの数を選択した後、返金される金額がポップアップに表示されます。

配送手数料は、Terminal ハードウェアの注文の最初に開始された返品で返金されます。たとえば、3 台のリーダーを購入した後、一部返金によって 1 ユニットを返品してから、もう 1 ユニットを返品する場合、2 番目のダッシュボードでの返品では、返金される配送手数料は $0 と示されます。この手数料は最初の返品で返金されているためです。

返品の理由を選択する

次に、返品の理由をドロップダウンメニューから選択する必要があります。

届いた商品に欠陥がある、または破損している: 受け取った商品のいずれかに損傷または欠陥があった場合には、このオプションを選択します。
注文しすぎた: デバイスを注文しすぎた場合は、このオプションを選択します。
デバイスの設定が複雑すぎる: Stripe Terminal の使用を開始する手順が複雑すぎるか、商品が期待に沿わなかった場合は、このオプションを選択します。
その他: 上記のどのオプションもユースケースに合致しない場合は、このオプションを選択してください。理由は必須です。

配送ラベルを確認してエクスポートする

情報が正確であることを確認したら、返品を送信を選択します。選択した後、配送ラベルをダウンロードするためのオプションが表示されます。UPS の場所を表示を選択して、最寄りの引き渡し場所を見つけることができます。

返金

返品が処理された後、注文詳細ページにリダイレクトされます。必要に応じて、配送ラベルを再びダウンロードすることができます。Stripe は、返品を受け取ったときに指定された支払い方法に対して返金を発行します。

セルフサービスでの返品に対応できない国

セルフサービスでの返品を利用できない国でデバイスを返品するには、サポートにお問い合わせください。ダッシュボードで注文に移動し、サポートに問い合わせるをクリックすると、注文詳細が自動的に Stripe に送信されます。元の梱包のままである (すべてのアクセサリーを含む) 場合、購入日から 30 日間はその注文に対する返金を受け付けることができます。

配送

Stripe は配送パートナーと連携して Terminal の注文のフルフィルメントを行います。配送先の国に応じて、標準配送、エクスプレス配送、または優先配送を選択できます。ハードウェアは (私書箱ではなく) 実在住所に配送する必要があります。

Connect プラットフォームで Terminal を使用している場合は、決済時に配送先住所を指定することにより、連結アカウントに直接リーダーを配送できます。

配送先の国	注文の締め時間	署名が必要になる注文額	配送除外地域 (私書箱はすべて除外対象)
アメリカ	午前 11:00 (東部標準時)	500 USD	ヴァージン諸島、および軍郵便サービスの住所
カナダ	午後 1:00 (太平洋標準時)	400 CAD	–
オーストリア	午前 11:00 (中央ヨーロッパ標準時)	400 EUR	–
ベルギー	午前 11:00 (中央ヨーロッパ標準時)	400 EUR	–
チェコ共和国	午前 11:00 (中央ヨーロッパ標準時)	9900 CZK	–
デンマーク	午前 11:00 (中央ヨーロッパ標準時)	2975 DKK	–
フィンランド	午前 11:00 (中央ヨーロッパ標準時)	400 EUR	–
フランス	午前 11:00 (中央ヨーロッパ標準時)	400 EUR	サンピエール島・ミクロン島、サンパルテルミー島、フランス領南方地域、ウォリス・フツナ、フランス領ポリネシア、ニューカレドニア
ドイツ	午前 11:00 (中央ヨーロッパ標準時)	400 EUR	–
アイルランド	午前 11:00 (中央ヨーロッパ標準時)	400 EUR	–
イタリア	午前 11:00 (中央ヨーロッパ標準時)	400 EUR	–
ルクセンブルク	午前 11:00 (中央ヨーロッパ標準時)	400 EUR	–
オランダ	午前 11:00 (中央ヨーロッパ標準時)	400 EUR	アルバ、キュラソー島、シントマールテン島、ボネール島、シント・ユースタティウス島、サバ島
Norway	午前 11:00 (中央ヨーロッパ標準時)	400 EUR	スヴァールバル諸島およびヤンマイエン島
ポルトガル	午前 11:00 (中央ヨーロッパ標準時)	400 EUR	–
スペイン	午前 11:00 (中央ヨーロッパ標準時)	400 EUR	–
スウェーデン	午前 11:00 (中央ヨーロッパ標準時)	4315 SEK	–
Switzerland	午前 11:00 (中央ヨーロッパ標準時)	400 EUR	–
イギリス	午前 11:00 (中央ヨーロッパ標準時)	400 GBP	ジャージー島、ガーンジー、マン島、英領ヴァージン諸島
オーストラリア	午前 11:00 (オーストラリア東部標準時)	400 AUD	–
マレーシア	午前 11:00 (オーストラリア東部標準時)	1,200 MYR	–
ニュージーランド	午前 11:00 (オーストラリア東部標準時)	400 NZD	–
シンガポール	午前 11:00 (オーストラリア東部標準時)	400 SGD	–

ユーザーの役割と権限

次の表は、どのユーザーの役割がアカウントを代表してダッシュボードから発注できるかを示しています。

	管理者	開発者	アナリスト	サポートスペシャリスト	表示のみ
新規に注文する
注文のリストを表示する
注文をキャンセルする
セルフサービスでの返品

Hardware Orders API を使用するベータ

Hardware Orders API は、下記のような目的で使用できます。Terminal の Hardware Orders API では、プログラムを使用して Terminal リーダーおよびアクセサリーを購入して、ユーザーに直接送付できます。注文のフルフィルメントは Stripe の配送パートナーによって行われるため、複雑な物流管理を行う必要がなくなり、対面支払いのビジネスの構築に集中できます。

店長などの従業員がハードウェアの注文を行うための社内ツールを構築する
顧客が Terminal リーダーとアクセサリーを注文するための E-コマース注文システムを構築する

API を使用してハードウェアの注文を作成するには、以下のステップを使用します。

利用可能な SKU を取得する
利用可能な配送方法を取得する
「(オプション)」注文をプレビューする
注文を作成する

ベータ

API リクエストのヘッダーに API バージョンと Terminal ハードウェアの注文 (ベータ) の現行バージョンを含める必要があります。Stripe-Version: 2024-11-20.acacia;terminal_hardware_orders_beta=v4

SKU を取得する

ユーザーに適切な商品ページを表示するには、Stripe から提供されるアイテムをシステムからリクエストする必要があります。各アイテムは SKU として表示され、商品のトークンおよび価格などの商品の詳細が含まれます。

Each SKU is associated with a country: a reader available in the US has a different SKU from the same reader that’s available in Canada. To retrieve SKUs, you must specify the country parameter when making a request to the Hardware Order SKUs endpoint:

Command Line
curl https://api.stripe.com/v1/terminal/hardware_skus?country=US \
  -usk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -H "Stripe-Version: 2024-11-20.acacia;terminal_hardware_orders_beta=v4"

Each SKU is also associated with a Hardware Product. Products represent different categories of devices. If you’re building an e-commerce ordering system for your customers, make sure you only show the SKUs for the products that apply for your Terminal integration. For example, if your Terminal integration only uses the BBPOS WisePOS E, don’t make the BBPOS Chipper 2X BT reader available for purchase. To retrieve all BBPOS WisePOS E SKUs, you can specify the optional product parameter when making a request to the Hardware Order SKUs endpoint:

Command Line
curl 'https://api.stripe.com/v1/terminal/hardware_skus?country=US&product={{TERMINAL_HARDWARE_PRODUCT_ID}}
' \
  -usk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -H "Stripe-Version: 2024-11-20.acacia;terminal_hardware_orders_beta=v4"

SKU の提供状況

SKU と商品は、新しいハードウェアに置き換えられると廃番になる場合があります。廃盤予定に対応するには、SKU と商品のステータスをご覧になり、現在 available のものと unavailable のものを把握してください。SKU のステータスが unavailable の場合、注文を作成することはできません。

また、それぞれの SKU と商品には、オプションの unavailable_after フィールドがあり、いつ unavailable になる可能性があるかを確認できます。オブジェクトの提供状況は時間経過に伴い変わるため、動的にクエリを実行することをお勧めします。方法としては、ユーザーに available のオブジェクトを表示する前にクエリを作成するか、定期的に (毎日など) クエリを実行して、ユーザーに提示する結果をキャッシュしておきます。

オブジェクトのトークンをハードコード化することはお勧めしません。そのような実装では、配送方法が unavailable になった場合にコード変更が必要になるからです。コード変更をタイミングよく行わないと、unavailable のオブジェクトに注文を試みようとしてエラーが生じる恐れがあります。

配送方法を取得する

注文を作成する際の入力として必須のオブジェクトには、Hardware Shipping Method (ハードウェア配送方法) もあります。このオブジェクトによって、注文の予定配送日時と価格の一部が決まります。注文を作成する際に配送先住所の国で使用可能な配送方法を使用する必要があります。

Like SKUs, each Shipping Method is associated with a country: the shipping methods available in the US might be different from those available in Canada. Each Shipping Method also has a name, which denotes the basic category for this shipping method. To retrieve Shipping Methods, you must specify the country and can optionally specify the name parameter when making a request to the Hardware Shipping Methods endpoint:

Command Line
curl https://api.stripe.com/v1/terminal/hardware_shipping_methods?country=US \
  -usk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -H "Stripe-Version: 2024-11-20.acacia;terminal_hardware_orders_beta=v4"

SKU と商品と同様に、配送方法も時間経過とともに変わる可能性があります。この変更に対応できるように、各配送方法には、それが現在 available か unavailable かを示す status があります。このメカニズムは、前述の SKU と商品と同様に機能します。SKU と商品のように、実装が古くならないように配送方法も定期的に取得することをお勧めします。

ハードウェアの注文をプレビューする

ハードウェアの注文をプレビューするには、注文の SKU、数量、配送先住所、および配送方法を含めて Stripe にリクエストします。

Command Line
curl https://api.stripe.com/v1/terminal/hardware_orders/preview \
  -usk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -H "Stripe-Version: 2024-11-20.acacia;terminal_hardware_orders_beta=v4" \
  --data-urlencode "shipping[name]"="Jenny Rosen" \
  --data-urlencode "shipping[address][line1]"="1234 Main Street" \
  --data-urlencode "shipping[address][city]"="San Francisco" \
  --data-urlencode "shipping[address][state]"=CA \
  --data-urlencode "shipping[address][country]"=US \
  --data-urlencode "shipping[address][postal_code]"=94111 \
  --data-urlencode "shipping[company]"="Rocket Rides" \
  --data-urlencode "shipping[phone]"=15555555555 \
  --data-urlencode "shipping[email]"="test@example.com" \
  --data-urlencode shipping_method=thsm_MfuTjLaPEgXMa4 \
  --data-urlencode payment_type=monthly_invoice \
  --data-urlencode "hardware_order_items[][terminal_hardware_sku]"=thsku_JokaJ6KpLMlDID \
  --data-urlencode "hardware_order_items[][quantity]"=2 \
  -G

注文をプレビューすると、注文を確認したり、実際に発注しなくてもその注文に付随する税金の全体的なコストを確認できます。これは、顧客向けの E-コマースの決済ページの設計に利用できます。プレビューのエンドポイントを呼び出しても、注文は実際には作成されません。

ハードウェア注文のプレビューとハードウェア注文の作成のリクエストの間の時間をできる限り短くすることで、(確率は非常に低いですが) その間に価格が変更される余地を減らすようにしてください。この問題が懸念される場合は、プレビューを保存し、同じパラメーターを使用して注文を作成できます。保存したプレビューを注文と比較し、変更があった場合には注文をキャンセルできます。

ハードウェアの注文を作成する

Terminal のハードウェア注文を作成するために、ハードウェア注文のプレビューリクエストによく似たハードウェア注文の作成リクエストを Stripe に対して行うことができます。リクエストには、注文の SKU、数量、配送先住所、配送方法を含めてください。

Command Line
curl https://api.stripe.com/v1/terminal/hardware_orders \
  -usk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -H "Stripe-Version: 2024-11-20.acacia;terminal_hardware_orders_beta=v4" \
  -d "shipping[name]"="Jenny Rosen" \
  -d "shipping[address][line1]"="1234 Main Street" \
  -d "shipping[address][city]"="San Francisco" \
  -d "shipping[address][state]"="CA" \
  -d "shipping[address][country]"="US" \
  -d "shipping[address][postal_code]"="94111" \
  -d "shipping[company]"="Rocket Rides" \
  -d "shipping[phone]"="15555555555" \
  -d "shipping[email]"="test@example.com" \
  -d "hardware_order_items[][terminal_hardware_sku]"="thsku_JokaJ6KpLMlDID" \
  -d "hardware_order_items[][quantity]"="2" \
  -d shipping_method="thsm_MfuTjLaPEgXMa4" \
  -d payment_type="monthly_invoice"

下記の例は、アメリカの電話番号を示しています。shipping.phone パラメーターで指定された電話番号が国際電話番号の場合は、+ 記号をエスケープして先頭に付加します (例: shipping[phone]="+358131234567" ではなく shipping[phone]="%2B358131234567")。

注文のステータスが変化したときに、shipping.email パラメーターで指定されたメールアドレスに Stripe のブランド名が入った更新メールが届きます。Stripe ブランドのメールを受信しても差し支えないメールアドレスを使用してください。

ハードウェア注文を取得してクエリする

注文を作成した後、以下のリクエストを使用して Terminal のハードウェア注文を取得することができます。

Command Line
curl https://api.stripe.com/v1/terminal/hardware_orders/{{TERMINAL_HARDWARE_ORDER_ID}}
 \
  -usk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -H "Stripe-Version: 2024-11-20.acacia;terminal_hardware_orders_beta=v4"

すべての Terminal のハードウェア注文をリストアップすることもできます。

Command Line
curl https://api.stripe.com/v1/terminal/hardware_orders \
  -usk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -H "Stripe-Version: 2024-11-20.acacia;terminal_hardware_orders_beta=v4"

Webhook

注文のステータスの移行が更新されるように Webhook イベントを設定できます。イベントを正しく受信するには、Webhook エンドポイントにヘッダーバージョン (例: Stripe-Version: 2024-11-20.acacia;terminal_hardware_orders_beta=v4) を追加する必要があります。以下の Webhook イベントがサポートされます。

terminal_hardware_order.created
terminal_hardware_order.canceled
terminal_hardware_order.ready_to_ship
terminal_hardware_order.shipped
terminal_hardware_order.delivered
terminal_hardware_order.undeliverable

テスト環境の注文ステータスを更新する

API で次のエンドポイントを使用して、テスト環境で端末ハードウェアの注文のステータスを更新できます。

/v1/test_helpers/terminal/hardware_orders/:hardware_order/mark_ready_to_ship
/v1/test_helpers/terminal/hardware_orders/:hardware_order/ship
/v1/test_helpers/terminal/hardware_orders/:hardware_order/deliver
/v1/test_helpers/terminal/hardware_orders/:hardware_order/mark_undeliverable

端末ハードウェアの注文のステータスはテスト環境でのみ更新できます

税金

注文を作成すると、Stripe はその注文に付随する税額を返します。Stripe はその購入で Stripe に支払うべき税金に基づいてこの金額を計算します。API を使用して行われた注文の税をエンドユーザーに請求する場合、支払うべき金額を計算し、その金額をユーザーに伝えることができます。お客様への支払い金額は、Stripe への支払い金額とは異なることがあります。

イタリアのタックス請求書については、イタリアの税金ポータルにアクセスして請求書をご覧ください。

請求書

ベータ期間は、この API を介して作成された注文に対して、Stripe から請求書が毎月送付されます。請求書を受信するメールアドレスは、ダッシュボードで変更できます。

配送の追跡

配送セクションの説明にあるように、Stripe では、配送パートナーと連携して Terminal の注文のフルフィルメントを実行します。配送パートナーが注文の追跡情報を取得すると、注文は shipped ステータスに移行します。terminal_hardware_order.shipped に Webhook エンドポイントを設定して、注文に追跡番号が設定されたときに通知が送られるようにすることができます。

変更ログ

新しい配送業者

Carrier (配送業者) 列挙フィールドに、新しい値 (canada_post、dhl、dpd、usps) を追加します。

v5 (2024-11-25)

Add pagination to the List all Terminal Hardware SKUs, List all Terminal Hardware Products, and List all Terminal Hardware Shipping Methods endpoints.
Require the country filter for the List all Terminal Hardware SKUs and List all Terminal Hardware Shipping Methods endpoints.

v4 (2023-01-23)

新しいハードウェア注文のプレビューエンドポイントを追加します。draft と expired の注文ステータスを削除します。ハードウェア注文の作成エンドポイントで /v1/terminal/hardware_orders/confirm エンドポイントと confirm パラメーターを削除します。
ready_to_ship と呼ばれる新しい TerminalHardwareOrder ステータスを追加します。これは、注文のキャンセルができなくなった発送前の状態を表します。
新しい API エンドポイントを追加し、テスト環境の端末ハードウェアの注文のステータスを、ready_to_ship、出荷済み、配送済み、配送不能に更新します。
新しい Hardware Shipping Method (ハードウェア配送方法) オブジェクトを追加して、shipping_method フィールドの以前のオブジェクトと、これらの新しいオブジェクトをクエリして取得するための API エンドポイントを置き換えます。
新しい Hardware Product (ハードウェア商品) オブジェクトを追加して、以前の product_type フィールドと、これらの新しいオブジェクトをクエリして取得するための API エンドポイントを置き換えます。
TerminalHardwareSku オブジェクトに新しい動的な orderable フィールドを追加して、以前の max_per_order フィールドを置き換えます。
TerminalHardwareSku に status フィールドと unavailable_after フィールドを追加することで、SKU が注文に利用できなくなった時期を確認できます。これらのフィールドは、新しい Hardware Shipping Method (ハードウェア配送方法) と Hardware Product (ハードウェア商品) オブジェクトにも含まれています。
同じ環境 (両方ともテスト環境であるか、両方とも本番環境である) で v3 と v4 に対して同時に有効になっている Webhook が存在すると、Stripe は、terminal_hardware_order.shipped Webhook を 2 回送信します。terminal_hardware_order.shipped Webhook は、注文が shipped に移行した場合にのみ送信されるのではなく、注文が ready_to_ship および shipped に移行した場合に送信されます。v3 を本番環境で使用していて、v4 をテスト環境で使用していても、Webhook は重複しません。v3 と v4 の両方を同じ環境で同時に有効にする必要がある場合は、まず、重複する terminal_hardware_order.shipped Webhook を処理できるようににシステムを更新してください。
v4 で ready_to_ship になっている注文は、v3 では shipped と表示されます。移行の更新中は、注文が v3 ではステータス shipped、v4 では ready_to_ship と表示される場合があります。このようになるのは、ready_to_ship の概念が v3 にはないためです。これらの注文のステータスが実際に逆行することはありません。

v3 (2019-04-03) 非推奨

name、description、images、attributes などのテキストフィールドを削除して、Terminal Hardware SKU (Terminal ハードウェア SKU) オブジェクトと Terminal Hardware Order line item SKU (Ternimal ハードウェア注文ラインアイテム SKU) オブジェクトを更新します。
Hardware Order SKU (ハードウェア注文 SKU) で shipping_country クエリーパラメーターをオプションにして、名前を country に変更します。
API 内で、product_type および country を使用して SKU を照会する機能を追加します。

v2 (2019-12-20) 非推奨

total_tax_amounts.rate.jurisdiction を構造オブジェクトから文字列にして、Terminal Hardware Order を更新します。

v1 (2019-11-20) 非推奨

初期リリース