ハードウェアを注文する
リーダーのハードウェアおよびアクセサリーの注文方法をご紹介します。
ダッシュボードから、または Stripe API (ベータ) を使用して、Stripe Terminal と互換性のある事前認証済みのリーダーを注文します。Stripe から直接リーダーを購入することにより、Stripe の決済アプリケーションと安全な暗号化キーがリーダーに読み込まれます。
使用を開始するには、ダッシュボードのリーダーセクションに移動します。購入をクリックして提供されている商品を表示します。
購入する商品![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
最初に、物理ハードウェアで組み込み全体をテストするため、リーダーとテストカードを注文します。組み込みの準備が整ったら、必要な個数のリーダーを注文します。
必要なリーダーが不明な場合は、導入方法の設計を参照して、導入に適したいずれかのリーダーを選択してください。
1 回の注文で各アイテムを 10000 個まで注文できます。ボリュームディスカウントの情報をご希望の場合は、お問い合わせください。
料金体系![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
各リーダーの価格は国によって異なります。ダッシュボードで最新価格を確認できます。
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 |
今すぐ購入 アメリカのみ | 今すぐ購入 | 今すぐ購入 アメリカ以外 | 今すぐ購入 |
注文を追跡してキャンセルする![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
注文後は、ダッシュボードでステータスを確認できます。
ステータス | 定義 |
---|---|
保留中 | 注文を受け付けました。まもなくフルフィルメントを開始します。必要に応じて、ダッシュボードでこの注文をキャンセルできます。注文は 30 分以上保留状態になります。 |
配送可能 | 注文の配送準備をしており、キャンセルはもうできません。注文が配送された後、注文をキャンセルするには返品を開始する必要があります。追跡番号が利用可能になると、注文は配送済みになります。 |
配送済み | 販売業者が指定された注文。追跡情報は、注文の詳細ページで確認できます。 |
配達済み | 商品は配送されています。 |
キャンセル済み | 注文はキャンセルされました。 |
セルフサービスでの返品![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
セルフサービスでの返品は、特定の国 (以下の国を参照) で注文され、出荷された商品を対象としています。その他すべての注文については、セルフサービスでの返品に対応していない国での返品をご覧ください。
セルフサービスでの返品に対応可能な国で Stripe ダッシュボードを使用して注文し、注文したアイテムの一部または全部を返品する必要がある場合、 十分な権限が付与されているユーザーは、Stripe ダッシュボードで返品を開始できます。元の梱包のままである (すべてのアクセサリーを含む) 場合、Stripe は購入日から 30 日間はその注文に対する返金を承諾できます。30 日を超えた返品については、Stripe サポートにお問い合わせください。
ダッシュボードでフローを進めると、返品配送ラベルが作成されます。返品配送ラベルを作成した後、現地の配送業者で荷物を引き渡すことができます。
Stripe は、流通機関で返品を受け取ったときに支払いを返金します。クレジットカードの場合、このプロセスには、資金が銀行口座に返金されるまでに最大 10 日かかることがあります。
セルフサービスでの返品に対応可能な国![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
アイテムを返品ボタンを選択する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
ダッシュボードでの返品を開始するには、ハードウェアの注文に進み、返品する注文を選択します。注文を選択した後、アイテムを返品をクリックして、プロセスを開始します。アイテムを返品ボタンは、ハードウェアの注文のステータスが Shipped
または Delivered
の場合に Terminal の注文詳細ページで使用できます。
![セルフサービスでの返品: ステップ 1](https://b.stripecdn.com/docs-statics-srv/assets/returns-step1.9346efe2a1f1a81856654b99566f5a0b.png)
返品するユニット数を確認する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
ポップアップが開いたら、注文の商品ごとに返品するアイテムの数を選択します (複数のアイテムがある場合)。返品の対象となるアイテムの数のみが表示されます。そのため、以前に 3 個のアイテムを購入して、1 個を返品した場合は、返品するユニットを最大 2 個までしか選択できません。
![セルフサービスでの返品: ステップ 2](https://b.stripecdn.com/docs-statics-srv/assets/returns-step2.18d56b1b58d3126dc3174bc2583d3d7b.png)
返品の金額を計算する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
希望するアイテムの数を選択した後、返金される金額がポップアップに表示されます。
配送手数料は、Terminal ハードウェアの注文の最初に開始された返品で返金されます。たとえば、3 台のリーダーを購入した後、一部返金によって 1 ユニットを返品してから、もう 1 ユニットを返品する場合、2 番目のダッシュボードでの返品では、返金される配送手数料は $0 と示されます。この手数料は最初の返品で返金されているためです。
返品の理由を選択する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
次に、返品の理由をドロップダウンメニューから選択する必要があります。
![セルフサービスでの返品: ステップ 4](https://b.stripecdn.com/docs-statics-srv/assets/returns-step4.d3e033266dc193ff0b4c666ad6fe48cf.png)
- 届いた商品に欠陥がある、または破損している: 受け取った商品のいずれかに損傷または欠陥があった場合には、このオプションを選択します。
- 注文しすぎた: デバイスを注文しすぎた場合は、このオプションを選択します。
- デバイスの設定が複雑すぎる: Stripe Terminal の使用を開始する手順が複雑すぎるか、商品が期待に沿わなかった場合は、このオプションを選択します。
- その他: 上記のどのオプションもユースケースに合致しない場合は、このオプションを選択してください。理由は必須です。
配送ラベルを確認してエクスポートする![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
情報が正確であることを確認したら、返品を送信を選択します。選択した後、配送ラベルをダウンロードするためのオプションが表示されます。UPS の場所を表示を選択して、最寄りの引き渡し場所を見つけることができます。
![セルフサービスでの返品: ステップ 5](https://b.stripecdn.com/docs-statics-srv/assets/returns-step5.bd0eff6b670cad01b97216f4a32ad627.png)
返金![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
返品が処理された後、注文詳細ページにリダイレクトされます。必要に応じて、配送ラベルを再びダウンロードすることができます。Stripe は、返品を受け取ったときに指定された支払い方法に対して返金を発行します。
セルフサービスでの返品に対応できない国![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
セルフサービスでの返品を利用できない国でデバイスを返品するには、サポートにお問い合わせください。ダッシュボードで注文に移動し、サポートに問い合わせるをクリックすると、注文詳細が自動的に Stripe に送信されます。元の梱包のままである (すべてのアクセサリーを含む) 場合、購入日から 30 日間はその注文に対する返金を受け付けることができます。
配送![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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 | – |
ユーザーの役割と権限![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
次の表は、どのユーザーの役割がアカウントを代表してダッシュボードから発注できるかを示しています。
管理者 | 開発者 | アナリスト | サポートスペシャリスト | 表示のみ | |
---|---|---|---|---|---|
新規に注文する | |||||
注文のリストを表示する | |||||
注文をキャンセルする | |||||
セルフサービスでの返品 |
Hardware Orders API を使用する ベータ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Hardware Orders API は、下記のような目的で使用できます。Terminal の Hardware Orders API では、プログラムを使用して Terminal リーダーおよびアクセサリーを購入して、ユーザーに直接送付できます。注文のフルフィルメントは Stripe の配送パートナーによって行われるため、複雑な物流管理を行う必要がなくなり、対面支払いのビジネスの構築に集中できます。
- 店長などの従業員がハードウェアの注文を行うための社内ツールを構築する
- 顧客が Terminal リーダーとアクセサリーを注文するための E-コマース注文システムを構築する
API を使用してハードウェアの注文を作成するには、以下のステップを使用します。
- 利用可能な SKU を取得する
- 利用可能な配送方法を取得する
- 「(オプション)」注文をプレビューする
- 注文を作成する
ベータ
API リクエストのヘッダーに API バージョンと Terminal ハードウェアの注文 (ベータ) の現行バージョンを含める必要があります。Stripe-Version: 2024-06-20;terminal_
SKU を取得する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
ユーザーに適切な商品ページを表示するには、Stripe から提供されるアイテムをシステムからリクエストする必要があります。各アイテムは SKU として表示され、商品のトークンおよび価格などの商品の詳細が含まれます。
各 SKU は国に関連付けられています。アメリカで提供されているリーダーは、同じリーダーがカナダで提供されていても SKU が異なります。SKU は、ハードウェアの注文 SKU エンドポイントへのリクエストを行う際にオプションとして country
パラメーターを指定することで、取得できます。
curl https://api.stripe.com/v1/terminal/hardware_skus?country=US \ -u
: \ -H "Stripe-Version: 2024-06-20;terminal_hardware_orders_beta=v4"sk_test_4eC39HqLyjWDarjtT1zdp7dc
各 SKU は、ハードウェア商品にも関連付けられています。商品は、デバイスのさまざまなカテゴリーを表します。顧客向けの E コマース注文システムを構築している場合、ご使用の Terminal のシステムに適用される商品の SKU のみを表示するようにしてください。たとえば、Terminal の実装が BBPOS WisePOS E のみを使用する場合、BBPOS Chipper 2X BT リーダーを購入可能な商品にすることはできません。国に関係なく、すべての BBPOS WisePOS E SKU を取得するには、ハードウェアの注文 SKU エンドポイントに対するリクエストを作成するときにオプションの product
パラメーターを指定できます。
curl https://api.stripe.com/v1/terminal/hardware_skus?product=
\ -u{{TERMINAL_HARDWARE_PRODUCT_ID}}: \ -H "Stripe-Version: 2024-06-20;terminal_hardware_orders_beta=v4"sk_test_4eC39HqLyjWDarjtT1zdp7dc
country
パラメーターと product
パラメーターを組み合わせて、特定の国の特定の商品のみを取得することができます。
SKU の提供状況![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
SKU と商品は、新しいハードウェアに置き換えられると廃番になる場合があります。廃盤予定に対応するには、SKU と商品のステータスをご覧になり、現在 available
のものと unavailable
のものを把握してください。SKU のステータスが unavailable
の場合、注文を作成することはできません。
また、それぞれの SKU と商品には、オプションの unavailable_after フィールドがあり、いつ unavailable
になる可能性があるかを確認できます。オブジェクトの提供状況は時間経過に伴い変わるため、動的にクエリを実行することをお勧めします。方法としては、ユーザーに available
のオブジェクトを表示する前にクエリを作成するか、定期的に (毎日など) クエリを実行して、ユーザーに提示する結果をキャッシュしておきます。
オブジェクトのトークンをハードコード化することはお勧めしません。そのような実装では、配送方法が unavailable
になった場合にコード変更が必要になるからです。コード変更をタイミングよく行わないと、unavailable
のオブジェクトに注文を試みようとしてエラーが生じる恐れがあります。
配送方法を取得する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
注文を作成する際の入力として必須のオブジェクトには、Hardware Shipping Method (ハードウェア配送方法) もあります。このオブジェクトによって、注文の予定配送日時と価格の一部が決まります。注文を作成する際に配送先住所の国で使用可能な配送方法を使用する必要があります。
SKU と同様に、配送方法は国に関連付けられています。アメリカで利用可能な配送方法は、カナダで利用可能な配送方法と異なる場合があります。各配送方法には name
があり、その配送方法の基本カテゴリーを示すものです。配送方法を取得するには、Hardware Shipping Methods (ハードウェアの配送方法) エンドポイントへのリクエストを行う際にオプションとして country
または name
パラメーターを指定します。
curl https://api.stripe.com/v1/terminal/hardware_shipping_methods?country=US \ -u
: \ -H "Stripe-Version: 2024-06-20;terminal_hardware_orders_beta=v4"sk_test_4eC39HqLyjWDarjtT1zdp7dc
SKU と商品と同様に、配送方法も時間経過とともに変わる可能性があります。この変更に対応できるように、各配送方法には、それが現在 available
か unavailable
かを示す status があります。このメカニズムは、前述の SKU と商品と同様に機能します。SKU と商品のように、実装が古くならないように配送方法も定期的に取得することをお勧めします。
ハードウェアの注文をプレビューする![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
ハードウェアの注文をプレビューするには、注文の SKU、数量、配送先住所、および配送方法を含めて Stripe にリクエストします。
curl https://api.stripe.com/v1/terminal/hardware_orders/preview \ -u
: \ -H "Stripe-Version: 2024-06-20;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 \ -Gsk_test_4eC39HqLyjWDarjtT1zdp7dc
注文をプレビューすると、注文を確認したり、実際に発注しなくてもその注文に付随する税金の全体的なコストを確認できます。これは、顧客向けの E-コマースの決済ページの設計に利用できます。プレビューのエンドポイントを呼び出しても、注文は実際には作成されません。
ハードウェア注文のプレビューとハードウェア注文の作成のリクエストの間の時間をできる限り短くすることで、(確率は非常に低いですが) その間に価格が変更される余地を減らすようにしてください。この問題が懸念される場合は、プレビューを保存し、同じパラメーターを使用して注文を作成できます。保存したプレビューを注文と比較し、変更があった場合には注文をキャンセルできます。
ハードウェアの注文を作成する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Terminal のハードウェア注文を作成するために、ハードウェア注文のプレビューリクエストによく似たハードウェア注文の作成リクエストを Stripe に対して行うことができます。リクエストには、注文の SKU、数量、配送先住所、配送方法を含めてください。
curl https://api.stripe.com/v1/terminal/hardware_orders \ -u
: \ -H "Stripe-Version: 2024-06-20;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"sk_test_4eC39HqLyjWDarjtT1zdp7dc
下記の例は、アメリカの電話番号を示しています。shipping.
パラメーターで指定された電話番号が国際電話番号の場合は、+ 記号をエスケープして先頭に付加します (例: shipping[phone]="+358131234567"
ではなく shipping[phone]="%2B358131234567"
)。
注文のステータスが変化したときに 、shipping.
パラメーターで指定されたメールアドレスに Stripe のブランド名が入った更新メールが届きます。Stripe ブランドのメールを受信しても差し支えないメールアドレスを使用してください。
ハードウェア注文を取得してクエリする![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
注文を作成した後、以下のリクエストを使用して Terminal のハードウェア注文を取得することができます。
curl https://api.stripe.com/v1/terminal/hardware_orders/
\ -u{{TERMINAL_HARDWARE_ORDER_ID}}: \ -H "Stripe-Version: 2024-06-20;terminal_hardware_orders_beta=v4"sk_test_4eC39HqLyjWDarjtT1zdp7dc
すべての Terminal のハードウェア注文をリストアップすることもできます。
curl https://api.stripe.com/v1/terminal/hardware_orders \ -u
: \ -H "Stripe-Version: 2024-06-20;terminal_hardware_orders_beta=v4"sk_test_4eC39HqLyjWDarjtT1zdp7dc
Webhook![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
注文のステータスの移行が更新されるように Webhook イベントを設定できます。イベントを正しく受信するには、Webhook エンドポイントにヘッダーバージョン (例: Stripe-Version: 2024-06-20;terminal_
) を追加する必要があります。以下の 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
テスト環境の注文ステータスを更新する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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
端末ハードウェアの注文のステータスはテスト環境でのみ更新できます
税金![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
注文を作成すると、Stripe はその注文に付随する税額を返します。Stripe はその購入で Stripe に支払うべき税金に基づいてこの金額を計算します。API を使用して行われた注文の税をエンドユーザーに請求する場合、支払うべき金額を計算し、その金額をユーザーに伝えることができます。お客様への支払い金額は、Stripe への支払い金額とは異なることがあります。
イタリアのタックス請求書については、イタリアの税金ポータルにアクセスして請求書をご覧ください。
請求書![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
ベータ期間は、この API を介して作成された注文に対して、Stripe から請求書が毎月送付されます。請求書を受信するメールアドレスは、ダッシュボードで変更できます。
配送の追跡![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
配送セクションの説明にあるように、Stripe では、配送パートナーと連携して Terminal の注文のフルフィルメントを実行します。配送パートナーが注文の追跡情報を取得すると、注文は shipped
ステータスに移行します。terminal_
に Webhook エンドポイントを設定して、注文に追跡番号が設定されたときに 通知が送られるようにすることができます。
変更ログ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
新しい配送業者![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
- Carrier (配送業者) 列挙フィールドに、新しい値 (
canada_
、post dhl
、dpd
、usps
) を追加します。
v4 (2023-01-23)![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
- 新しいハードウェア注文のプレビューエンドポイントを追加します。
draft
とexpired
の注文ステータスを削除します。 ハードウェア注文の作成エンドポイントで/v1/terminal/hardware_
エンドポイントとorders/confirm confirm
パラメーターを削除します。 ready_
と呼ばれる新しい TerminalHardwareOrder ステータスを追加します。これは、注文のキャンセルができなくなった発送前の状態を表します。to_ ship - 新しい API エンドポイントを追加し、テスト環境の端末ハードウェアの注文のステータスを、ready_to_ship、出荷済み、配送済み、配送不能に更新します。
- 新しい Hardware Shipping Method (ハードウェア配送方法) オブジェクトを追加して、
shipping_
フィールドの以前のオブジェクトと、これらの新しいオブジェクトをクエリして取得するための API エンドポイントを置き換えます。method - 新しい Hardware Product (ハードウェア商品) オブジェクトを追加して、以前の
product_
フィールドと、これらの新しいオブジェクトをクエリして取得するための API エンドポイントを置き換えます。type - TerminalHardwareSku オブジェクトに新しい動的な
orderable
フィールドを追加して、以前のmax_
フィールドを置き換えます。per_ order - TerminalHardwareSku に
status
フィールドとunavailable_
フィールドを追加することで、SKU が注文に利用できなくなった時期を確認できます。これらのフィールドは、新しい Hardware Shipping Method (ハードウェア配送方法) と Hardware Product (ハードウェア商品) オブジェクトにも含まれています。after - 同じ環境 (両方ともテスト環境であるか、両方とも本番環境である) で v3 と v4 に対して同時に有効になっている Webhook が存在すると、Stripe は、
terminal_
Webhook を 2 回送信します。hardware_ order. shipped terminal_
Webhook は、注文がhardware_ order. shipped shipped
に移行した場合にのみ送信されるのではなく、注文がready_
およびto_ ship shipped
に移行した場合に送信されます。v3 を本番環境で使用していて、v4 をテスト環境で使用していても、Webhook は重複しません。v3 と v4 の両方を同じ環境で同時に有効にする必要がある場合は、まず、重複するterminal_
Webhook を処理できるようににシステムを更新してください。hardware_ order. shipped - v4 で
ready_
になっている注文は、v3 ではto_ ship shipped
と表示されます。移行の更新中は、注文が v3 ではステータスshipped
、v4 ではready_
と表示される場合があります。このようになるのは、to_ ship ready_
の概念が v3 にはないためです。これらの注文のステータスが実際に逆行することはありません。to_ ship
v3 (2019-04-03) 非推奨![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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) 非推奨![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
total_
を構造オブジェクトから文字列にして、Terminal Hardware Order を更新します。tax_ amounts. rate. jurisdiction
v1 (2019-11-20) 非推奨![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
- 初期リリース