コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成
サインイン
始める
支払い
財務の自動化
プラットフォームおよびマーケットプレイス
資金管理
開発者向けのツール
始める
支払い
財務の自動化
始める
支払い
財務の自動化
プラットフォームおよびマーケットプレイス
資金管理
概要
Stripe Payments について
構築済みのシステムをアップグレード
支払いの分析
オンライン決済
概要ユースケースを見つけるManaged Payments
Payment Links を使用する
決済ページを構築
高度なシステムを構築
アプリ内実装を構築
決済手段
決済手段を追加
決済手段を管理
Link による購入の迅速化
支払いインターフェイス
Payment Links
Checkout
Web Elements
アプリ内 Elements
決済シナリオ
カスタムの決済フロー
柔軟なアクワイアリング
オーケストレーション
店頭支払い
端末
    概要
    対面支払いを受け付ける
    導入方法の設計
    リーダーを選択
    導入方法の設計
    クイックスタート
    サンプルアプリケーション
    テスト
    Terminal の設定
    実装方法を設定する
    リーダーに接続する
    決済の受け付け
    カード支払いを回収
    追加の支払い方法
    オフライン決済を受け付ける
    通信販売/電話販売の決済
    地域的な考慮事項
    購入時
    チップを回収する
    将来の使用に備えて支払い情報を収集して保存する
    柔軟なオーソリ
    決済後
    返金の取引
    領収書の提供
    Checkout のカスタマイズ
    カートの表示
    画面上の入力を収集
    スワイプで取得されたデータを収集
    NFC 機器のタップによって取得したデータを収集
    Apps on Devices
    リーダーを管理
    リーダーの注文、返品、交換
      保証請求を提出する
    リーダーの登録
    場所とゾーンの管理
    リーダーの設定
    暗号化
    リファレンス
    API リファレンス
    モバイルリーダー
    スマートリーダー
    SDK 移行ガイド
    デプロイのチェックリスト
    Stripe Terminal リーダー製品シート
他の Stripe プロダクト
Financial Connections
仮想通貨
Climate
ホーム支払いTerminal

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

ハードウェアを注文する

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

ページをコピー

今すぐ購入

ご購入をご希望の場合には、入手可能なリーダーとアクセサリーをご覧ください。

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

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

購入する商品

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

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

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

料金体系

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

Stripe リーダー M2BBPOS WisePOS EBBPOS WisePad 3Stripe リーダー S700
Stripe リーダー M2
BBPOS WisePOS E
BBPOS WisePad 3
Stripe リーダー S700
オーストラリア
–329 AUD89 AUD499 AUD
カナダ
–299 CAD79 CAD449 CAD
オーストリア
フランス
ドイツ
アイルランド
ベルギー
スペイン
オランダ
ルクセンブルク
フィンランド
ポルトガル
イタリア
–199 EUR59 EUR299 EUR
チェコ共和国
–4,990 CZK1,490 CZK7250 CZK
マレーシア
–999 MYR279 MYR1499 MYR
ニュージーランド
–349 NZ99 NZ549 NZ
シンガポール
–299 SGD89 SGD449 SGD
イギリス
–179 GBP49 GBP279 GBP
スイス
–199 CHF59 CHF329 CHF
ノルウェー
–1,990 NOK590 NOK3590 NOK
デンマーク
–1,499 DKK449 DKK2400 DKK
スウェーデン
–2,195 SEK645 SEK3490 SEK
アメリカ
59 USD249 USD–349 USD
今すぐ購入 アメリカのみ今すぐ購入今すぐ購入 アメリカ以外今すぐ購入

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

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

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

セルフサービスでの返品

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

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

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

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

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

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

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

セルフサービスでの返品: ステップ 1

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

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

セルフサービスでの返品: ステップ 2

返品の金額を計算する

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

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

返品の理由を選択する

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

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

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

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

セルフサービスでの返品: ステップ 5

返金

返品が処理された後、注文詳細ページにリダイレクトされます。必要に応じて、配送ラベルを再びダウンロードすることができます。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アルバ、キュラソー島、シントマールテン島、ボネール島、シント・ユースタティウス島、サバ島
ノルウェー
午前 11:00 (中央ヨーロッパ標準時)400 EURスヴァールバル諸島およびヤンマイエン島
ポルトガル
午前 11:00 (中央ヨーロッパ標準時)400 EUR–
スペイン
午前 11:00 (中央ヨーロッパ標準時)400 EUR–
スウェーデン
午前 11:00 (中央ヨーロッパ標準時)4315 SEK–
スイス
午前 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–

ユーザーの役割と権限

The following table shows which user roles can place orders on behalf of their account through the dashboard:

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

Hardware Orders API を使用するPreview

アクセスをリクエストする

Terminal Hardware Ordering API は現在プレビュー版です。ご利用を希望される場合は、営業担当者にお問い合わせください。ご利用いただけるかどうかを審査いたします。

プレビューをご利用いただくためには、次の条件を満たす必要があります。

  • Stripe アカウントマネージャーがある
  • 月次の請求書による請求に同意する
  • これはプレビュー版であり、適時の更新が必要であることを理解している

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

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

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

  1. 利用可能な SKU を取得する
  2. 利用可能な配送方法を取得する
  3. (任意) 注文をプレビューします
  4. 注文を作成する

プライベートプレビュー

API リクエストには、お使いの API バージョンと Terminal ハードウェアの注文プレビューの現行バージョンを含むベータヘッダーを指定する必要があるStripe-Version: 2025-04-30.basil;terminal_hardware_orders_beta=v5

SKU を取得する

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

各 SKU は国に関連付けられており、アメリカで利用できるリーダーには、カナダで利用できる同じリーダーとは異なる SKU が付けられています。SKU を取得するには、Hardware Order SKUs エンドポイントにリクエストする際に country パラメーターを指定する必要があります。

Command Line
curl https://api.stripe.com/v1/terminal/hardware_skus?country=US \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -H "Stripe-Version: 2025-04-30.basil;terminal_hardware_orders_beta=v5"

各 SKU は Hardware Product にも関連付けられています。Product は、さまざまなカテゴリのデバイスを表します。顧客向けの E コマース注文システムを構築している場合は、貴社が構築した Terminal システムに該当する製品の SKU のみを表示するようにしてください。たとえば、貴社が構築した Terminal システムで BBPOS WisePOS E のみを使用する場合、BBPOS Chipper 2X BT リーダーは購入できないようにしてください。すべての BBPOS WisePOS E SKU を取得するには、Hardware Order SKUs エンドポイントにリクエストする際に、オプションの product パラメーターを指定します。

Command Line
curl 'https://api.stripe.com/v1/terminal/hardware_skus?country=US&product=
{{TERMINAL_HARDWARE_PRODUCT_ID}}
'
\ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -H "Stripe-Version: 2025-04-30.basil;terminal_hardware_orders_beta=v5"

最後に、各 SKU はプロバイダーにも関連付けられています。デフォルトでは、この値は stripe に設定されていますが、Hardware Order SKUs エンドポイントにリクエストを行うときにオプションの provider パラメーターを指定することで、別のプロバイダーの SKU をフィルターできます。注文内の SKU と配送方法は、同じ provider を共有する必要があります。

SKU の提供状況

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

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

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

配送方法を取得する

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

SKU と同様に、Shipping Method は国に関連付けられているため、アメリカで利用できる配送方法とカナダで利用できる配送方法は異なる場合があります。各 Shipping Method には、この配送方法の基本カテゴリを示す name と provider もあります。Shipping Method を取得するには、country を指定する必要があり、Hardware Shipping Methods (ハードウェアの配送方法) エンドポイントにリクエストを行う際に、オプションで name または provider パラメーターを指定できます。

Command Line
curl https://api.stripe.com/v1/terminal/hardware_shipping_methods?country=US \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -H "Stripe-Version: 2025-04-30.basil;terminal_hardware_orders_beta=v5"

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

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

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

Command Line
curl https://api.stripe.com/v1/terminal/hardware_orders/preview \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -H "Stripe-Version: 2025-04-30.basil;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-コマースの決済ページの設計に利用できます。プレビューのエンドポイントを呼び出しても、注文は実際には作成されません。

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

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

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

Command Line
curl https://api.stripe.com/v1/terminal/hardware_orders \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -H "Stripe-Version: 2025-04-30.basil;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 のハードウェア注文を取得することができます。

Command Line
curl https://api.stripe.com/v1/terminal/hardware_orders/
{{TERMINAL_HARDWARE_ORDER_ID}}
\ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -H "Stripe-Version: 2025-04-30.basil;terminal_hardware_orders_beta=v5"

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

Command Line
curl https://api.stripe.com/v1/terminal/hardware_orders \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -H "Stripe-Version: 2025-04-30.basil;terminal_hardware_orders_beta=v5"

Webhook

注文のステータスの移行が更新されるように Webhook イベントを設定できます。イベントを正しく受信するには、Webhook エンドポイントにヘッダーバージョン (例: Stripe-Version: 2025-04-30.basil;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 ハードウェア注文のステータスは、サンドボックスでのみ更新できます。

税金

注文を作成すると、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)

  • List all Terminal Hardware SKUs、List all Terminal Hardware Products、List all Terminal Hardware Shipping Methods エンドポイントにページ分割を追加します。
  • List all Terminal Hardware SKUs および List all Terminal Hardware Shipping Methods エンドポイントには country フィルターが必要です。

v4 (2023-01-23)

  • 新しいハードウェア注文のプレビューエンドポイントを追加します。draft と expired の注文ステータスを削除します。 ハードウェア注文の作成エンドポイントで /v1/terminal/hardware_orders/confirm エンドポイントと confirm パラメーターを削除します。
  • ready_to_ship と呼ばれる新しい TerminalHardwareOrder ステータスを追加します。これは、注文のキャンセルができなくなった発送前の状態を表します。
  • 新しい API エンドポイントを追加して、テスト端末ハードウェアの注文のステータスを ready_to_ship、shipped、delivered、undeliverable に更新します。
  • 新しい 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) 非推奨

  • 初期リリース
このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
変更ログをご覧ください。
ご不明な点がございましたら、お問い合わせください。
LLM ですか?llms.txt を読んでください。
Powered by Markdoc