# ハードウェアを注文する リーダーのハードウェアおよびアクセサリーの注文方法をご紹介します。 ご購入をご希望の場合には、[入手可能なリーダーとアクセサリー](https://dashboard.stripe.com/terminal/shop)をご覧ください。 ダッシュボードから、または [Stripe API](https://docs.stripe.com/terminal/fleet/order-and-return-readers.md#use-the-hardware-orders-api) を使用して、Stripe Terminal と互換性のある事前認証済みのリーダーを注文します。Stripe から直接リーダーを購入することにより、Stripe の決済アプリケーションと安全な暗号化キーがリーダーに読み込まれます。 使用を始めるには、ダッシュボードの [リーダー](https://dashboard.stripe.com/terminal) セクションに移動します。**購入**をクリックして提供されている商品を表示します。 ## 購入する商品 最初に、物理ハードウェアで組み込み全体をテストするため、[リーダー](https://dashboard.stripe.com/terminal/shop)と[テストカード](https://dashboard.stripe.com/terminal/shop)を注文します。組み込みの準備が整ったら、必要な個数のリーダーを注文します。 必要なリーダーが不明な場合は、[導入方法の設計](https://docs.stripe.com/terminal/designing-integration.md)を参照して、導入に適したいずれかのリーダーを選択してください。 1 回の注文で各アイテムを 10000 個まで注文できます。ボリュームディスカウントの情報をご希望の場合は、[お問い合わせください](https://stripe.com/contact/sales)。 ### 料金体系 各リーダーの価格は国によって異なります。[ダッシュボード](https://dashboard.stripe.com/terminal/shop)またはデバイスの[料金体系ページ](https://stripe.com/terminal/devices)で最新価格を確認できます。 ## 注文を追跡してキャンセルする 注文後は、ダッシュボードでステータスを確認できます。 | ステータス | 定義 | | ----------- | ----------------------------------------------------------------------------------------------- | | **保留中** | 注文を受け付けました。まもなくフルフィルメントを開始します。必要に応じて、ダッシュボードでこの注文をキャンセルできます。注文は 30 分以上保留状態になります。 | | **配送可能** | 注文の配送準備をしており、キャンセルはもうできません。注文が配送された後、注文をキャンセルするには返品を開始する必要があります。追跡番号が利用可能になると、注文は**配送済み**になります。 | | **配送済み** | 販売業者が指定された注文。追跡情報は、注文の詳細ページで確認できます。 | | **配達済み** | 商品は配送されています。 | | **キャンセル済み** | 注文はキャンセルされました。 | | **配送不可** | 注文の 1 つ以上のアイテムを配送できませんでした。 | v4 の注文ステータスの図 (See full diagram at https://docs.stripe.com/terminal/fleet/order-and-return-readers) ## セルフサービスでの返品 セルフサービスでの返品は、特定の国 (以下の国を参照) で注文され、出荷された商品を対象としています。その他すべての注文については、[セルフサービスでの返品に対応していない国での返品](https://docs.stripe.com/terminal/fleet/order-and-return-readers.md#returns-outside-of-supported-self-service-countries)をご覧ください。 セルフサービスに対応している国で Stripe ダッシュボードで注文し、注文したアイテムの一部または全部を返品する必要がある場合、[十分な権限を持つユーザー](https://docs.stripe.com/terminal/fleet/order-and-return-readers.md#self-service-return-permissions)は Stripe ダッシュボード内で返品を開始できます。購入日から 30 日以内であれば、元の梱包材 (およびすべてのアクセサリー) で注文の返金を受け付けることができます。30 日を経過した返品については、[Stripe サポート](https://support.stripe.com/contact/login)にお問い合わせください。 ダッシュボードでフローを進めると、返品配送ラベルが作成されます。返品配送ラベルを作成した後、現地の配送業者で荷物を引き渡すことができます。 Stripe は、流通機関で返品を受け取ったときに支払いを返金します。クレジットカードの場合、このプロセスには、資金が銀行口座に返金されるまでに最大 10 日かかることがあります。 ### セルフサービスでの返品に対応可能な国 - AT - AU - BE - BG - CA - CY - CZ - DE - DK - EE - ES - FI - FR - GB - GI - GR - HR - HU - IE - IT - LI - LT - LU - LV - MT - NL - PL - PT - RO - SE - SI - SK - US ## アイテムを返品ボタンを選択する ダッシュボードでの返品を開始するには、ハードウェアの注文に進み、返品する注文を選択します。注文を選択した後、**アイテムを返品**をクリックして、プロセスを開始します。**アイテムを返品**ボタンは、ハードウェアの注文のステータスが `Shipped` または `Delivered` の場合に Terminal の注文詳細ページで使用できます。 ![セルフサービスでの返品: ステップ 1](https://b.stripecdn.com/docs-statics-srv/assets/returns-step1.9346efe2a1f1a81856654b99566f5a0b.png) ## 返品するユニット数を確認する ポップアップが開いたら、注文の商品ごとに返品するアイテムの数を選択します (複数のアイテムがある場合)。返品の対象となるアイテムの数のみが表示されます。そのため、以前に 3 個のアイテムを購入して、1 個を返品した場合は、返品するユニットを最大 2 個までしか選択できません。 ![セルフサービスでの返品: ステップ 2](https://b.stripecdn.com/docs-statics-srv/assets/returns-step2.18d56b1b58d3126dc3174bc2583d3d7b.png) ## 返品の金額を計算する 希望するアイテムの数を選択した後、返金される金額がポップアップに表示されます。 配送手数料は、Terminal ハードウェアの注文の最初に開始された返品で返金されます。たとえば、3 台のリーダーを購入した後、一部返金によって 1 ユニットを返品してから、もう 1 ユニットを返品する場合、2 番目のダッシュボードでの返品では、返金される配送手数料は $0 と示されます。この手数料は最初の返品で返金されているためです。 ## 返品の理由を選択する 次に、返品の理由をドロップダウンメニューから選択する必要があります。 ![セルフサービスでの返品: ステップ 4](https://b.stripecdn.com/docs-statics-srv/assets/returns-step4.d3e033266dc193ff0b4c666ad6fe48cf.png) - **届いた商品に欠陥がある、または破損している**: 受け取った商品のいずれかに損傷または欠陥があった場合には、このオプションを選択します。 - **注文しすぎた**: デバイスを注文しすぎた場合は、このオプションを選択します。 - **デバイスの設定が複雑すぎる**: Stripe Terminal の使用を開始する手順が複雑すぎるか、商品が期待に沿わなかった場合は、このオプションを選択します。 - **その他**: 上記のどのオプションもユースケースに合致しない場合は、このオプションを選択してください。理由は必須です。 ## 配送ラベルを確認してエクスポートする 情報が正確であることを確認したら、**返品を送信**を選択します。選択した後、配送ラベルをダウンロードするためのオプションが表示されます。**UPS の店舗を表示**を選択して、最寄りの引き渡し店舗を見つけることができます。 ![セルフサービスでの返品: ステップ 5](https://b.stripecdn.com/docs-statics-srv/assets/returns-step5.bd0eff6b670cad01b97216f4a32ad627.png) ## 返金 返品が処理された後、注文詳細ページにリダイレクトされます。必要に応じて、配送ラベルを再びダウンロードすることができます。Stripe は、返品を受け取ったときに指定された支払い方法に対して返金を発行します。 ## セルフサービスでの返品に対応できない国 セルフサービスでの返品を利用できない国でデバイスを返品するには、サポートにお問い合わせください。ダッシュボードで注文に移動し、**サポートに問い合わせる**をクリックすると、注文詳細が自動的に Stripe に送信されます。元の梱包のままである (すべてのアクセサリーを含む) 場合、購入日から 30 日間はその注文に対する返金を受け付けることができます。 ## 配送 Stripe は配送パートナーと連携して Terminal の注文のフルフィルメントを行います。配送先の国に応じて、標準配送、エクスプレス配送、または優先配送を選択できます。ハードウェアは (私書箱ではなく) 実在住所に配送する必要があります。 > #### 大口注文 > > Stripe は、大口注文に対して自動的に貨物輸送を選択します。 [Connect プラットフォームで Terminal を使用](https://docs.stripe.com/terminal/features/connect.md)している場合は、決済時に配送先住所を指定することにより、連結アカウントに直接リーダーを配送できます。 | 配送先の国 | 注文の締め時間 | 署名が必要になる注文額 | 配送除外地域 (私書箱はすべて除外対象) | | ----- | ----------------------- | ----------- | -------------------------------------------------------------- | | US | 午前 11:00 (東部標準時) | 500 USD | ヴァージン諸島、および軍郵便サービスの住所 | | CA | 午後 1:00 (太平洋標準時) | 400 CAD | – | | AT | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | BE | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | BG | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | HR | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | CY | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | CZ | 午前 11:00 (中央ヨーロッパ標準時) | 9900 CZK | – | | DK | 午前 11:00 (中央ヨーロッパ標準時) | 2975 DKK | – | | EE | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | FI | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | FR | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | サンピエール島・ミクロン島、サンパルテルミー島、フランス領南方地域、ウォリス・フツナ、フランス領ポリネシア、ニューカレドニア | | DE | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | GI | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | GR | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | HU | 午前 11:00 (中央ヨーロッパ標準時) | 155908 HUF | – | | IE | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | IT | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | LV | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | LI | 午前 11:00 (中央ヨーロッパ標準時) | 415 CHF | – | | LT | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | LU | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | MT | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | NL | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | アルバ、キュラソー島、シントマールテン島、ボネール島、シント・ユースタティウス島、サバ島 | | NO | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | スヴァールバル諸島およびヤンマイエン島 | | PT | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | RO | 午前 11:00 (中央ヨーロッパ標準時) | 1930 RON | – | | SK | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | SI | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | ES | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | SE | 午前 11:00 (中央ヨーロッパ標準時) | 4315 SEK | – | | CH | 午前 11:00 (中央ヨーロッパ標準時) | 400 EUR | – | | GB | 午前 11:00 (中央ヨーロッパ標準時) | 400 GBP | ジャージー島、ガーンジー、マン島、英領ヴァージン諸島 | | AU | 午前 11:00 (オーストラリア東部標準時) | 400 AUD | – | | HK | 午前 11:00 (オーストラリア東部標準時) | 2,200 HKD | – | | MY | 午前 11:00 (オーストラリア東部標準時) | 1,200 MYR | – | | NZ | 午前 11:00 (オーストラリア東部標準時) | 400 NZD | – | | SG | 午前 11:00 (オーストラリア東部標準時) | 400 SGD | – | | PL | 11:30 (中央ヨーロッパ標準時) | 2100 PLN | – | | JP | 15:30 (日本標準時) | 7 万 9,000 円 | – | ## 納税者番号を追加する [Terminal の設定](https://dashboard.stripe.com/settings/terminal)で納税番号を追加することができます。Stripe は指定された納税番号を使用してハードウェアの注文に税金を適用し、タックス請求書とクレジットノートに含めます。タックス請求書はアメリカ以外の注文ごとに作成されます。タックス請求書を確認するには、[ハードウェアの注文](https://dashboard.stripe.com/terminal/hardware_orders)にリスト表示されている注文をクリックします。 ## ユーザーの役割と権限 次の表は、どの[ユーザーの役割](https://docs.stripe.com/get-started/account/teams/roles.md)がアカウントを代表してダッシュボードから発注できるかを示しています。 | | 管理者 | 開発者 | アナリスト | Terminal 担当者 | サポートスペシャリスト | 表示のみ | | ----------- | ------------- | ------------- | ------------- | ------------- | ------------- | ------------- | | 新規に注文する | :check: Check | :check: Check | :check: Check | :check: Check | ❌ Cancel | ❌ Cancel | | 注文のリストを表示する | :check: Check | :check: Check | :check: Check | :check: Check | :check: Check | :check: Check | | 注文をキャンセルする | :check: Check | :check: Check | :check: Check | :check: Check | ❌ Cancel | ❌ Cancel | | セルフサービスでの返品 | :check: Check | :check: Check | :check: Check | :check: Check | :check: Check | ❌ Cancel | ## Hardware Orders API を使用する(Preview) Terminal Hardware Ordering API は現在プレビュー版です。ご利用を希望される場合は、[営業担当者にお問い合わせ](https://stripe.com/contact/sales)ください。ご利用いただけるかどうかを審査いたします。 プレビューをご利用いただくためには、次の条件を満たす必要があります。 - Stripe アカウントマネージャーがある - 月次の請求書による請求に同意する - これはプレビュー版であり、適時の更新が必要であることを理解している Terminal の Hardware Orders API では、プログラムを使用して Terminal リーダーおよびアクセサリーを購入して、ユーザーに直接送付できます。注文のフルフィルメントは Stripe の配送パートナーによって行われるため、複雑な物流管理を行う必要がなくなり、対面支払いのビジネスの構築に集中できます。 - 店長などの従業員がハードウェアの注文を行うための社内ツールを構築する - 顧客が Terminal リーダーとアクセサリーを注文するための E-コマース注文システムを構築する API を使用してハードウェアの注文を作成するには、以下のステップを使用します。 1. 利用可能な SKU を取得する 1. 利用可能な配送方法を取得する 1. (任意) 注文をプレビューします 1. 注文を作成する > API リクエストには、お使いの API バージョンと Terminal ハードウェアの注文プレビューの現行バージョンを含むベータヘッダーを指定する必要がある`Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5` ### SKU を取得する ユーザーに適切な商品ページを表示するには、Stripe から提供されるアイテムをシステムからリクエストする必要があります。各アイテムは SKU として表示され、商品のトークンおよび価格などの商品の詳細が含まれます。 各 SKU は国に関連付けられており、アメリカで利用できるリーダーには、カナダで利用できる同じリーダーとは異なる SKU が付けられています。SKU を取得するには、[Hardware Order SKUs](https://docs.stripe.com/api/terminal/hardware_skus/list.md) エンドポイントにリクエストする際に `country` パラメーターを指定する必要があります。 ```bash curl https://api.stripe.com/v1/terminal/hardware_skus?country=US \ -u <>: \ -H "Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5" ``` 各 SKU は [Hardware Product](https://docs.stripe.com/api/terminal/hardware_products/object.md) にも関連付けられています。Product は、さまざまなカテゴリのデバイスを表します。顧客向けの E コマース注文システムを構築している場合は、貴社が構築した Terminal システムに該当する製品の SKU のみを表示するようにしてください。たとえば、貴社が構築した Terminal システムで [BBPOS WisePOS E](https://docs.stripe.com/terminal/readers/bbpos-wisepos-e.md) のみを使用する場合、[BBPOS Chipper 2X BT](https://docs.stripe.com/terminal/readers/bbpos-chipper2xbt.md) リーダーは購入できないようにしてください。すべての [BBPOS WisePOS E](https://docs.stripe.com/terminal/readers/bbpos-wisepos-e.md) SKU を取得するには、[Hardware Order SKUs](https://docs.stripe.com/api/terminal/hardware_skus/list.md) エンドポイントにリクエストする際に、オプションの `product` パラメーターを指定します。 ```bash curl 'https://api.stripe.com/v1/terminal/hardware_skus?country=US&product={{TERMINAL_HARDWARE_PRODUCT_ID}}' \ -u <>: \ -H "Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5" ``` 最後に、各 SKU は[プロバイダー](https://docs.stripe.com/api/terminal/hardware_skus/object.md#terminal_hardware_sku_object-provider)にも関連付けられています。デフォルトでは、この値は `stripe` に設定されていますが、[Hardware Order SKUs](https://docs.stripe.com/api/terminal/hardware_skus/list.md) エンドポイントにリクエストを行うときにオプションの `provider` パラメーターを指定することで、別のプロバイダーの SKU をフィルターできます。注文内の SKU と配送方法は、同じ `provider` を共有する必要があります。 #### SKU の提供状況 SKU と商品は、新しいハードウェアに置き換えられると廃番になる場合があります。廃盤予定に対応するには、[SKU と商品のステータス](https://docs.stripe.com/api/terminal/hardware_skus/object.md#terminal_hardware_sku_object-status)をご覧になり、現在 `available` のものと `unavailable` のものを把握してください。[SKU のステータス](https://docs.stripe.com/api/terminal/hardware_products/object.md#terminal_hardware_sku_object-status)が `unavailable` の場合、注文を作成することはできません。 また、それぞれの SKU と商品には、オプションの [unavailable_after フィールド](https://docs.stripe.com/api/terminal/hardware_skus/object.md#terminal_hardware_sku_object-unavailable_after)があり、いつ `unavailable` になる可能性があるかを確認できます。オブジェクトの提供状況は時間経過に伴い変わるため、動的にクエリを実行することをお勧めします。方法としては、ユーザーに `available` のオブジェクトを表示する前にクエリを作成するか、定期的に (毎日など) クエリを実行して、ユーザーに提示する結果をキャッシュしておきます。 オブジェクトのトークンをハードコード化することはお勧めしません。そのような実装では、配送方法が `unavailable` になった場合にコード変更が必要になるからです。コード変更をタイミングよく行わないと、`unavailable` のオブジェクトに注文を試みようとしてエラーが生じる恐れがあります。 ### 配送方法を取得する 注文を作成する際の入力として必須のオブジェクトには、[Hardware Shipping Method (ハードウェア配送方法)](https://docs.stripe.com/api/terminal/hardware_shipping_methods/object.md) もあります。このオブジェクトによって、注文の予定配送日時と価格の一部が決まります。注文を作成する際に配送先住所の国で使用可能な配送方法を使用する必要があります。 SKU と同様に、Shipping Method は国に関連付けられているため、アメリカで利用できる配送方法とカナダで利用できる配送方法は異なる場合があります。各 Shipping Method には、この配送方法の基本カテゴリを示す `name` と `provider` もあります。Shipping Method を取得するには、`country` を指定する必要があり、[Hardware Shipping Methods (ハードウェアの配送方法)](https://docs.stripe.com/api/terminal/hardware_shipping_methods/list.md) エンドポイントにリクエストを行う際に、オプションで `name` または `provider` パラメーターを指定できます。 ```bash curl https://api.stripe.com/v1/terminal/hardware_shipping_methods?country=US \ -u <>: \ -H "Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5" ``` SKU と商品と同様に、配送方法も時間経過とともに変わる可能性があります。この変更に対応できるように、各配送方法には、それが現在 `available` か `unavailable` かを示す [status](https://docs.stripe.com/api/terminal/hardware_skus/object.md#terminal_hardware_sku_object-status) があります。このメカニズムは、前述の SKU と商品と同様に機能します。SKU と商品のように、実装が古くならないように配送方法も定期的に取得することをお勧めします。 ### ハードウェアの注文をプレビューする ハードウェアの注文をプレビューするには、注文の SKU、数量、配送先住所、および配送方法を含めて Stripe にリクエストします。 ```bash curl https://api.stripe.com/v1/terminal/hardware_orders/preview \ -u <>: \ -H "Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5" \ --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-コマースの決済ページの設計に利用できます。プレビューのエンドポイントを呼び出しても、注文は実際には作成されません。 [ハードウェア注文のプレビュー](https://docs.stripe.com/api/terminal/hardware_orders/preview.md)と[ハードウェア注文の作成](https://docs.stripe.com/api/terminal/hardware_orders/create.md)のリクエストの間の時間をできる限り短くすることで、(確率は非常に低いですが) その間に価格が変更される余地を減らすようにしてください。この問題が懸念される場合は、プレビューを保存し、同じパラメーターを使用して注文を作成できます。保存したプレビューを注文と比較し、変更があった場合には注文をキャンセルできます。 ### ハードウェアの注文を作成する [Terminal のハードウェア注文](https://docs.stripe.com/api/terminal/hardware_orders/object.md)を作成するために、[ハードウェア注文のプレビュー](https://docs.stripe.com/api/terminal/hardware_orders/preview.md)リクエストによく似た[ハードウェア注文の作成](https://docs.stripe.com/api/terminal/hardware_orders/create.md)リクエストを Stripe に対して行うことができます。リクエストには、注文の SKU、数量、配送先住所、配送方法を含めてください。 ```bash curl https://api.stripe.com/v1/terminal/hardware_orders \ -u <>: \ -H "Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5" \ -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 のハードウェア注文を取得](https://docs.stripe.com/api/terminal/hardware_orders/retrieve.md)することができます。 ```bash curl https://api.stripe.com/v1/terminal/hardware_orders/{{TERMINAL_HARDWARE_ORDER_ID}} \ -u <>: \ -H "Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5" ``` [すべての Terminal のハードウェア注文をリストアップ](https://docs.stripe.com/api/terminal/hardware_orders/list.md)することもできます。 ```bash curl https://api.stripe.com/v1/terminal/hardware_orders \ -u <>: \ -H "Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5" ``` ### Webhook 注文のステータスの移行が更新されるように [Webhook イベントを設定](https://docs.stripe.com/webhooks.md)できます。イベントを正しく受信するには、Webhook エンドポイントにヘッダーバージョン (例: `Stripe-Version: 2026-04-22.dahlia;terminal_hardware_orders_beta=v5`) を追加する必要があります。以下の 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 の次のエンドポイントを使用して、サンドボックス内の Terminal ハードウェア注文のステータスを更新できます。 - `/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` Terminal ハードウェア注文のステータスは、*サンドボックス* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)でのみ更新できます。 ### 税金 注文を作成すると、Stripe はその注文に付随する税額を返します。Stripe はその購入で Stripe に支払うべき税金に基づいてこの金額を計算します。API を使用して行われた注文の税をエンドユーザーに請求する場合、支払うべき金額を計算し、その金額をユーザーに伝えることができます。お客様への支払い金額は、Stripe への支払い金額とは異なることがあります。 イタリアでのタックスインボイスについては、[イタリア税務ポータル](https://www.agenziaentrate.gov.it/portale/area-riservata)にアクセスして請求書をご覧ください。 ### 請求書 プレビュー期間中、この API を介して作成された注文に対して、Stripe から請求書が毎月送付されます。請求書を受信するメールアドレスは、[ダッシュボード](https://dashboard.stripe.com/settings/terminal)で変更できます。 ### 配送の追跡 [配送](https://docs.stripe.com/terminal/fleet/order-and-return-readers.md#shipping)セクションで述べたように、Stripe は配送パートナーと連携して Terminal の注文のフルフィルメントを実行します。配送パートナーが注文の追跡情報を取得すると、注文は `shipped` ステータスに移行します。`terminal.hardware_order.shipped` 通知の Webhook エンドポイントを設定して、注文に追跡番号が設定されたときに通知が送られるようにすることができます。 ### 変更ログ #### 新しい配送業者 - [Carrier (配送業者)](https://docs.stripe.com/api/terminal/hardware_orders/object.md#terminal_hardware_order_object-shipment_tracking-carrier) 列挙フィールドに、新しい値 (`canada_post`、`dhl`、`dpd`、`usps`) を追加します。 #### v5 (2024-11-25) - [List all Terminal Hardware SKUs](https://docs.stripe.com/api/terminal/hardware_skus/list.md)、[List all Terminal Hardware Products](https://docs.stripe.com/api/terminal/hardware_products/list.md)、[List all Terminal Hardware Shipping Methods](https://docs.stripe.com/api/terminal/hardware_shipping_methods/list.md) エンドポイントにページ分割を追加します。 - [List all Terminal Hardware SKUs](https://docs.stripe.com/api/terminal/hardware_skus/list.md) および [List all Terminal Hardware Shipping Methods](https://docs.stripe.com/api/terminal/hardware_shipping_methods/list.md) エンドポイントには `country` フィルターが必要です。 #### v4 (2023-01-23) - 新しい[ハードウェア注文のプレビュー](https://docs.stripe.com/api/terminal/hardware_orders/preview.md)エンドポイントを追加します。`draft` と `expired` の注文ステータスを削除します。 [ハードウェア注文の作成](https://docs.stripe.com/api/terminal/hardware_orders/create.md)エンドポイントで `/v1/terminal/hardware_orders/confirm` エンドポイントと `confirm` パラメーターを削除します。 - `ready_to_ship` と呼ばれる新しい [TerminalHardwareOrder](https://docs.stripe.com/api/terminal/hardware_orders/object.md) ステータスを追加します。これは、注文のキャンセルができなくなった発送前の状態を表します。 - 新しい API エンドポイントを追加して、テスト端末ハードウェアの注文のステータスを [ready_to_ship](https://docs.stripe.com/api/terminal/hardware_orders/test_mode_mark_ready_to_ship.md)、[shipped](https://docs.stripe.com/api/terminal/hardware_orders/test_mode_ship.md)、[delivered](https://docs.stripe.com/api/terminal/hardware_orders/test_mode_deliver.md)、[undeliverable](https://docs.stripe.com/api/terminal/hardware_orders/test_mode_mark_undeliverable.md) に更新します。 - 新しい [Hardware Shipping Method (ハードウェア配送方法)](https://docs.stripe.com/api/terminal/hardware_shipping_methods/object.md) オブジェクトを追加して、`shipping_method` フィールドの以前のオブジェクトと、これらの新しいオブジェクトをクエリして取得するための API エンドポイントを置き換えます。 - 新しい [Hardware Product (ハードウェア商品)](https://docs.stripe.com/api/terminal/hardware_products/object.md) オブジェクトを追加して、以前の `product_type` フィールドと、これらの新しいオブジェクトをクエリして取得するための API エンドポイントを置き換えます。 - [TerminalHardwareSku](https://docs.stripe.com/api/terminal/hardware_skus/object.md) オブジェクトに新しい動的な `orderable` フィールドを追加して、以前の `max_per_order` フィールドを置き換えます。 - [TerminalHardwareSku](https://docs.stripe.com/api/terminal/hardware_skus/object.md) に `status` フィールドと `unavailable_after` フィールドを追加することで、SKU が注文に利用できなくなった時期を確認できます。これらのフィールドは、新しい [Hardware Shipping Method (ハードウェア配送方法)](https://docs.stripe.com/api/terminal/hardware_shipping_methods/object.md) と [Hardware Product (ハードウェア商品)](https://docs.stripe.com/api/terminal/hardware_products/object.md) オブジェクトにも含まれています。 - 同じ環境 (両方がテスト環境または両方が本番環境) で v3 と v4 の Webhook を同時に有効にしている場合、Stripe は `terminal.hardware_order.shipped` Webhook を 2 回送信します。注文が `ready_to_ship` に移行したときと `shipped` に移行したときに `terminal.hardware_order.shipped` Webhook を送信します。これは、注文が `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)](https://docs.stripe.com/api/terminal/hardware_skus/object.md) オブジェクトと [Terminal Hardware Order line item SKU (Ternimal ハードウェア注文ラインアイテム SKU) オブジェクト](https://docs.stripe.com/api/terminal/hardware_orders/object.md#terminal_hardware_order_object-hardware_order_items-terminal_hardware_sku) を更新します。 - [Hardware Order SKU (ハードウェア注文 SKU)](https://docs.stripe.com/api/terminal/hardware_skus/list.md) で `shipping_country` クエリーパラメーターをオプションにして、名前を `country` に変更します。 - API 内で、`product_type` および `country` を使用して SKU を照会する機能を追加します。 #### v2 (2019-12-20) (非推奨) - `total_tax_amounts.rate.jurisdiction` を構造オブジェクトから文字列にして、[Terminal Hardware Order](https://docs.stripe.com/api/terminal/hardware_orders/object.md) を更新します。 #### v1 (2019-11-20) (非推奨) - 初期リリース