ハードウェアを注文する
リーダーのハードウェアおよびアクセサリーの注文方法をご紹介します。
ダッシュボードから、または Stripe API (ベータ) を使用して、Stripe Terminal と互換性のある事前認証済みのリーダーを注文します。Stripe から直接リーダーを購入することにより、Stripe の決済アプリケーションと安全な暗号化キーがリーダーに読み込まれます。
使用を開始するには、ダッシュボードのリーダーセクションに移動します。購入をクリックして提供されている商品を表示します。
購入する商品![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
最初に、物理ハードウェアで組み込み全体をテストするため、リーダーとテストカードを注文します。組み込みの準備が整ったら、必要な個数のリーダーを注文します。
Not sure which reader you need? See Designing an Integration to choose one for your integration.
1 回の注文で各アイテムを 10000 個まで注文できます。ボリュームディスカウントの情報をご希望の場合は、お問い合わせください。
料金体系![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
各リーダーの価格は国によって異なります。ダッシュボードで最新価格を確認できます。
Stripe Reader M2 | BBPOS WisePOS E | BBPOS WisePad 3 | Stripe Reader 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://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
注文後は、ダッシュボードでステータスを確認できます。
ステータス | 定義 |
---|---|
保留中 | 注文を受け付けました。まもなくフルフィルメントを開始します。必要に応じて、ダッシュボードでこの注文をキャンセルできます。注文は 30 分以上保留状態になります。 |
配送可能 | 注文の配送準備をしており、キャンセルはもうできません。注文が配送された後、注文をキャンセルするには返品を開始する必要があります。追跡番号が利用可能になると、注文は配送済みになります。 |
配送済み | 販売業者が指定された注文。追跡情報は、注文の詳細ページで確認できます。 |
配達済み | 商品は配送されています。 |
キャンセル済み | 注文はキャンセルされました。 |
セルフサービスでの返品![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Self service returns are for orders placed and shipped within specific countries (see countries below). See the information about returns outside of supported self service countries for all other orders.
セルフサービスでの返品に対応可能な国で Stripe ダッシュボードを使用して注文し、注文したアイテムの一部または全部を返品する必要がある場合、 十分な権限が付与されているユーザーは、Stripe ダッシュボードで返品を開始できます。元の梱包のままである (すべてのアクセサリーを含む) 場合、Stripe は購入日から 30 日間はその注文に対する返金を承諾できます。30 日を超えた返品については、Stripe サポートにお問い合わせください。
ダッシュボードでフローを進めると、返品配送ラベルが作成されます。返品配送ラベルを作成した後、現地の配送業者で荷物を引き渡すことができます。
Stripe は、流通機関で返品を受け取ったときに支払いを返金します。クレジットカードの場合、このプロセスには、資金が銀行口座に返金されるまでに最大 10 日かかることがあります。
セルフサービスでの返品に対応可能な国![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
アイテムを返品ボタンを選択する![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
ダッシュボードでの返品を開始するには、ハードウェアの注文に進み、返品する注文を選択します。注文を選択した後、アイテムを返品をクリックして、プロセスを開始します。アイテムを返品ボタンは、ハードウェアの注文のステータスが Shipped
または Delivered
の場合に Terminal の注文詳細ページで使用できます。
![セルフサービスでの返品: ステップ 1](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/returns-step1.9346efe2a1f1a81856654b99566f5a0b.png)
返品するユニット数を確認する![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
ポップアップが開いたら、注文の商品ごとに返品するアイテムの数を選択します (複数のアイテムがある場合)。返品の対象となるアイテムの数のみが表示されます。そのため、以前に 3 個のアイテムを購入して、1 個を返品した場合は、返品するユニットを最大 2 個までしか選択できません。
![セルフサービスでの返品: ステップ 2](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/returns-step2.18d56b1b58d3126dc3174bc2583d3d7b.png)
返品の金額を計算する![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
希望するアイテムの数を選択した後、返金される金額がポップアップに表示されます。
配送手数料は、Terminal ハードウェアの注文の最初に開始された返品で返金されます。たとえば、3 台のリーダーを購入した後、一部返金によって 1 ユニットを返品してから、もう 1 ユニットを返品する場合、2 番目のダッシュボードでの返品では、返金される配送手数料は $0 と示されます。この手数料は最初の返品で返金されているためです。
返品の理由を選択する![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
次に、返品の理由をドロップダウンメニューから選択する必要があります。
![セルフサービスでの返品: ステップ 4](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/returns-step4.d3e033266dc193ff0b4c666ad6fe48cf.png)
- 届いた商品に欠陥がある、または破損している: 受け取った商品のいずれかに損傷または欠陥があった場合には、このオプションを選択します。
- 注文しすぎた: デバイスを注文しすぎた場合は、このオプションを選択します。
- デバイスの設定が複雑すぎる: Stripe Terminal の使用を開始する手順が複雑すぎるか、商品が期待に沿わなかった場合は、このオプションを選択します。
- その他: 上記のどのオプションもユースケースに合致しない場合は、このオプションを選択してください。理由は必須です。
配送ラベルを確認してエクスポートする![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
情報が正確であることを確認したら、返品を送信を選択します。選択した後、配送ラベルをダウンロードするためのオプションが表示されます。UPS の場所を表示を選択して、最寄りの引き渡し場所を見つけることができます。
![セルフサービスでの返品: ステップ 5](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/returns-step5.bd0eff6b670cad01b97216f4a32ad627.png)
返金![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
返品が処理された後、注文詳細ページにリダイレクトされます。必要に応じて、配送ラベルを再びダウンロードすることができます。Stripe は、返品を受け取ったときに指定された決済手段に対して返金を発行します。
セルフサービスでの返品に対応できない国![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
セルフサービスでの返品を利用できない国でデバイスを返品するには、サポートにお問い合わせください。ダッシュボードで注文に移動し、サポートに問い合わせるをクリックすると、注文詳細が自動的に Stripe に送信されます。元の梱包のままである (すべてのアクセサリーを含む) 場合、購入日から 30 日間はその注文に対する返金を受け付けることができます。
配送![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Stripe は配送パートナーと連携して Terminal の注文のフルフィルメントを行います。配送先の国に応じて、標準配送、エクスプレス配送、または優先配送を選択できます。ハードウェアは (私書箱ではなく) 実在住所に配送する必要があります。
If you’re a Connect platform using Terminal, you can ship readers directly to your connected accounts by specifying the destination address during checkout.
配送先の国 | 注文の締め時間 | 署名が必要になる注文額 | 配送除外地域 (私書箱はすべて除外対象) |
---|---|---|---|
アメリカ | 午前 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://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
The following table shows which user roles can place orders on behalf of their account via the dashboard:
管理者 | 開発者 | アナリスト | サポートスペシャリスト | 表示のみ | |
---|---|---|---|---|---|
新規に注文する | |||||
注文のリストを表示する | |||||
注文をキャンセルする | |||||
セルフサービスでの返品 |
Hardware Orders API を使用する ベータ![](https://cdn.statically.io/img/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_hardware_orders_beta=v4
SKU を取得する![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
ユーザーに適切な商品ページを表示するには、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 can optionally specify the country
parameter when making a request to the Hardware Order SKUs endpoint:
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
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 regardless of country, you can specify the optional product
parameter when making a request to the Hardware Order SKUs endpoint:
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://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
SKUs and Products might become obsolete as we replace them with newer hardware. To help you manage planned obsolescence, see the SKU and Product status that indicates which are currently available
or unavailable
. You can’t create an Order if the SKU status is unavailable
.
Additionally, each SKU and Product has an optional unavailable_after field that indicates when it might become unavailable
. Because the availabilities of these objects change over time, we recommend using an approach to query them dynamically. You can do this either by making a query before displaying the available
objects to your users, or periodically (every day, for example) and caching the results you present to your users.
オブジェクトのトークンをハードコード化することはお勧めしません。そのような実装では、配送方法が unavailable
になった場合にコード変更が必要になるからです。コード変更をタイミングよく行わないと、unavailable
のオブジェクトに注文を試みようとしてエラーが生じる恐れがあります。
配送方法を取得する![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Another required object used as an input for creating an order is the Hardware Shipping Method. This object determines the estimated shipping time for your order as well as a portion of the price. You must use a Shipping Method available in country of the shipping address when creating an order.
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 can optionally specify the country
and/or name
parameter when making a request to the Hardware Shipping Methods endpoint:
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
Like SKUs and Products, Shipping Methods might change over time. To help you manage these changes, each Shipping Method has a status that indicates whether it’s currently available
or unavailable
. This mechanism works the same way as it does for SKUs and Products, as described above. As with SKUs and Products, we recommend fetching Shipping Methods periodically so your integration doesn’t become out of date.
ハードウェアの注文をプレビューする![](https://cdn.statically.io/img/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-コマースの決済ページの設計に利用できます。プレビューのエンドポイントを呼び出しても、注文は実際には作成されません。
Try to minimize the time between making a request to Preview Hardware Order and Create Hardware Order to reduce the (very unlikely) chance that prices change in the interim. If you’re concerned about this issue you can save the preview and create an order using the same parameters. Then you can compare the saved preview with the order and cancel the order in the event of any changes.
ハードウェアの注文を作成する![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
To create a Terminal Hardware Order, you can make a Create Hardware Order request to Stripe that looks very similar to the Preview Hardware Order request. Include the SKUs, quantities, shipping address, and Shipping Method for the order in your request.
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.phone
パラメーターで指定された電話番号が国際電話番号の場合は、+ 記号をエスケープして先頭に付加します (例: shipping[phone]="+358131234567"
ではなく shipping[phone]="%2B358131234567"
)。
注文のステータスが変化したときに 、shipping.email
パラメーターで指定されたメールアドレスに Stripe のブランド名が入った更新メールが届きます。Stripe ブランドのメールを受信しても差し支えないメールアドレスを使用してください。
ハードウェア注文を取得してクエリする![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
After creating an order, you can Retrieve a Terminal Hardware Order using the following request.
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
You can also List all Terminal Hardware Orders.
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://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
You can set up webhook events to be updated about order state transitions. You must add a header version (for example, Stripe-Version: 2024-06-20;terminal_hardware_orders_beta=v4
) to your webhook endpoints to receive events properly. We support the following webhook events:
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://cdn.statically.io/img/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
You can only update the status for terminal hardware orders in test mode.
税金![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
注文を作成すると、Stripe はその注文に付随する税額を返します。Stripe はその購入で Stripe に支払うべき税金に基づいてこの金額を計算します。API を使用して行われた注文の税をエンドユーザーに請求する場合、支払うべき金額を計算し、その金額をユーザーに伝えることができます。お客様への支払い金額は、Stripe への支払い金額とは異なることがあります。
イタリアのタックスインボイスについては、イタリアの税金ポータルにアクセスして請求書をご覧ください。
請求書![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
ベータ期間は、この API を介して作成された注文に対して、Stripe から請求書が毎月送付されます。請求書を受信するメールアドレスは、ダッシュボードで変更できます。
配送の追跡![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
配送セクションの説明にあるように、Stripe では、配送パートナーと連携して Terminal の注文のフルフィルメントを実行します。配送パートナーが注文の追跡情報を取得すると、注文は shipped
ステータスに移行します。terminal_hardware_order.shipped
に Webhook エンドポイントを設定して、注文に追跡番号が設定されたときに 通知が送られるようにすることができます。
変更ログ![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
新しい配送業者![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
- Add new values (
canada_post
,dhl
,dpd
, andusps
) to the Carrier enum field.
v4 (2023-01-23)![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
- Add a new Preview Hardware Order endpoint. Remove
draft
andexpired
order statuses. Remove the/v1/terminal/hardware_orders/confirm
endpoint and theconfirm
parameter in the Create Hardware Order endpoint. - Add a new TerminalHardwareOrder status called
ready_to_ship
, which represents a state in which the order is no longer cancelable, but hasn’t yet shipped. - Add new API endpoints to update the status of test mode terminal hardware orders to ready_to_ship, shipped, delivered, and undeliverable.
- Add a new Hardware Shipping Method object to replace the former object in the
shipping_method
field, as well as API endpoints for querying and retrieving these new objects. - Add a new Hardware Product object to replace the former
product_type
field, as well as API endpoints for querying and retrieving these new objects. - Add a new, dynamic
orderable
field to the TerminalHardwareSku object, replacing the oldermax_per_order
field. - Add
status
andunavailable_after
fields to TerminalHardwareSku, which allow you to determine if and when a SKU becomes unavailable to order. These fields also exist on the new Hardware Shipping Method and Hardware Product objects. - 同じ環境 (両方ともテスト環境であるか、両方とも本番環境である) で 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) 非推奨![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
- Update Terminal Hardware SKU and the Terminal Hardware Order line item SKU object by removing text fields such as
name
,description
,images
, andattributes
. - Make the
shipping_country
query parameter in Hardware Order SKUs optional and rename it tocountry
. - API 内で、
product_type
およびcountry
を使用して SKU を照会する機能を追加します。
v2 (2019-12-20) 非推奨![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
- Update Terminal Hardware Order by turning
total_tax_amounts.rate.jurisdiction
from a structured object into a string.
v1 (2019-11-20) 非推奨![](https://cdn.statically.io/img/b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
- 初期リリース