Stripe Terminal 決済ゲートウェイ
Stripe Terminal を使うと、レジに Stripe のカードリーダーを導入できます。レジからリーダーに金額を送信し、お客様がカードをタッチ、挿入、またはスワイプします。Stripe が売上を確定し、未払い額がなくなると販売が完了します。このページでは、初回の設定、各レジへのリーダーの接続、最初の決済までを説明します。
設定済みの場合は、このレジにリーダーを接続するか、決済を受け付けるに進んでください。
Stripe Terminal には WCPOS Pro 2.0.0 以降が必要です。これがないと拡張機能は動作しません。
リーダーを選ぶ
Stripe は 3 種類のリーダーを提供しています。レジで使える種類は、POS を実行する環境によって異なります。
- スマートリーダー — ブラウザー、デスクトップアプリ、iPhone、iPad、Android のどのレジでも使えます。対象機種は Stripe Reader S700、S710、BBPOS WisePOS E です。ネットワークに接続し、店舗から決済を送信します。
- Bluetooth リーダー — iOS および Android アプリ専用です。対象機種は Stripe Reader M2、BBPOS WisePad 3 です。スマートフォンやタブレットとペアリングします。
- Tap to Pay — iOS および Android アプリのアップデートで対応予定です。リーダーは不要で、お客様がスマートフォン本体にカードをタッチします。
ブラウザーやデスクトップアプリからは Bluetooth リーダーやスマートフォンの非接触チップにアクセスできないため、これらのレジではスマートリーダーを使います。リーダーは Stripe ダッシュボードの Terminal ショップで購入してください。
Stripe は米国では Stripe Reader M2 を、英国、ヨーロッパ、カナダ、オーストラリアなど米国外では BBPOS WisePad 3 を販売しています。お住まいの地域で購入できる機種は Terminal ショップで確認してください。
決済ゲートウェイを設定する
管理者が WP Admin で店舗ごとに一度だけ行います。
- 拡張機能をインストールします。 GitHub のリリースアセットからプラグインの zip ファイル
stripe-terminal-for-woocommerce.zipをダウンロードし、プラグイン > Add Plugin、プラグインのアップロード の順に選んでアップロードします。GitHub の「Source code」の zip ファイルはインストールできません。 - キーを追加します。
WP Admin > WooCommerce > 設定 > 支払いで Stripe Terminal を開き、本番環境のシークレットキー を貼り付けます。先に試す場合は テスト環境のシークレットキー も貼り付けます。どちらも Stripe ダッシュボードから取得できます。保存後、キーはドットで表示され、(保存済み。変更しない場合は空欄のままにしてください) と表示されます。 - Bluetooth リーダーと Tap to Pay 用の Terminal のロケーションを選択します。Stripe ダッシュボードの Terminal → ロケーション でテストモード用と本番モード用のロケーションをそれぞれ作成し、Terminal のロケーション(テスト) と Terminal のロケーション(本番) に指定します。
- POS 接続 で、この店舗で許可するリーダーにチェックを入れます。スマートリーダー、Bluetooth リーダーと Tap to Pay、または両方を選べます。アプリで Bluetooth リーダーや Tap to Pay を使う場合は、Bluetooth リーダーと Tap to Pay にチェックを入れ、スマートリーダー のチェックを外します。スマートリーダー、Bluetooth、または両方を参照してください。
- 設定を保存し、その下の Webhook の行に 署名シークレットを保存しました。 と表示されていることを確認します。
- POS で有効にします。
WP Admin > POS > 設定 > 支払いで Stripe Terminal を有効にして保存します。WooCommerce 自体の決済方法一覧で有効にする必要はありません。レジ設定を参照してください。
ロケーションを選択していないと Bluetooth リーダーや Tap to Pay は接続できず、レジに モバイルリーダーを接続する前に、Stripe Terminal の設定で Terminal のロケーションを選択してください。 と表示されます。
決済ゲートウェイのページにあるすべての設定
- タイトル と 説明 — お客様に表示される名前と説明文です。レジのタイルにはタイトルが表示されます。
- 本番環境のシークレットキー と テスト環境のシークレットキー — Stripe ダッシュボードから取得します。
- デフォルトの端末 — レジで別のリーダーを選ぶまで、決済に使用するスマートリーダーです。
- 有効な端末 — レジで使えるスマートリーダーを、選択したものに限定します。空欄にすると、アカウント内のすべてのリーダーを使用できます。
- 端末の選択を固定 — レジ係は POS の会計時に端末を変更できません。 デフォルトの端末 の指定が必要です。
- POS 接続 — レジで使用できるリーダーの種類です。スマートリーダー(店舗がネットワーク経由でリーダーを制御) と Bluetooth リーダーと Tap to Pay(POS アプリがリーダーを制御) があります。スマートリーダー、Bluetooth、または両方を参照してください。
- Terminal のロケーション(テスト) と Terminal のロケーション(本番) — アプリが Bluetooth リーダーや Tap to Pay に接続するときの登録先です。
- テストモード — テストモードを有効にする。HTTPS を使用していないサイトではテストモードのままになります。Stripe Terminal の本番決済には HTTPS が必要です。
- 電話注文(MOTO) — Stripe Terminal での電話注文決済を有効にします。電話注文(MOTO)を参照してください。
- リーダーの待機状態を維持(試験的機能) — リーダーに定期的に通信し、しばらく使わなかった後の最初の決済が遅くなるのを防ぎます。複数のレジで 1 台のリーダーを共有する場合は推奨しません。
入力欄の下には、Stripe Terminal のロケーション の一覧と Webhook の行が表示されます。
スマートリーダー、Bluetooth、または両方
POS 接続 は店舗単位の設定で、すべてのレジが使用するリーダーの種類を決めます。
- スマートリーダー のみ:すべてのレジでスマートリーダーを使って決済します。
- Bluetooth リーダーと Tap to Pay のみ:iOS および Android アプリでは Bluetooth リーダーかスマートフォンを使って決済します。ブラウザーやデスクトップのレジでは、Stripe のタイルが … 現在利用できません の下に折りたたまれ、この決済方法ではアプリのリーダーのみが許可されています。このレジで決済するには、WooCommerce の設定ページでスマートリーダーを許可してください。 と表示されます。
- 両方:レジではスマートリーダーを使用します。 スマートリーダー のチェックを外すまで、Bluetooth リーダーと Tap to Pay は使用されません。
リーダーの種類の変更とアップグレード
リーダーの種類のチェックを外しても、変わるのはレジが次の決済に使うリーダーだけです。払い戻しはすべて、スマートリーダーかアプリかを問わず、元の決済時の接続を使って行われ、Stripe の Webhook も引き続き動作します。旧バージョンからのアップグレードでは、保存済みの接続が維持されます。デフォルトの端末 だけが保存されていた場合は、スマートリーダーが選択されます。新規インストール時は両方にチェックが入っているため、スマートリーダー のチェックを外すまで、アプリはスマートリーダーを使用します。
このレジにリーダーを接続する
使用するリーダーはレジごとに保存されます。POS のサイドメニュー下部にある 設定 をタップし、カードリーダー をタップします。

- この店舗にはカードリーダーが設定されていません — このレジで使用できる種類のリーダーで決済ゲートウェイを設定するまでは、このメッセージが表示されます。設定後は、以下のリーダーセクションのうち、このレジで使用できるものが代わりに表示されます(ブラウザーやデスクトップのレジでは スマートリーダー のみ)。
スマートリーダー
各スマートリーダーに表示されるコードを使って、Stripe ダッシュボードで登録します。登録するまで、デフォルトの端末、有効な端末、レジのいずれにも表示されません。
スマートリーダー セクションには、店舗が許可しているリーダーごとに 1 行ずつ表示されます。リーダー名の横に決済ゲートウェイ名、その下に Terminal のロケーション、そして オンライン または オフライン が表示されます。レジは 選択中 と表示された行のリーダーで決済します。切り替えるには、オンラインの別のリーダーで このリーダーを使用 をタップします。以後の会計ではそのリーダーを使います。
自動的に使われるリーダーはどれですか?
- まだ何も選択していない場合:デフォルトの端末 がオンラインで、ほかの販売に使用されていなければ、レジはその端末を使います。
- 店舗にスマートリーダーが 1 台だけの場合:選択は不要です。オンラインで、ほかの販売に使用中でなければ、レジはそのリーダーで決済します。
- 店舗が指定している場合:端末の選択を固定 が有効なときの デフォルトの端末 です。オンラインの間はすべてのレジで 選択中 となり、どの行にも このリーダーを使用 は表示されません。
Bluetooth リーダー
iOS または Android アプリで以下を行います。
- リーダーの電源を入れ、スマートフォンやタブレットの近くに置きます。
- 設定 → カードリーダー で リーダーを接続 をタップします。店舗にリーダー用の決済ゲートウェイが複数ある場合は、選択を求められます。接続に使用する決済ゲートウェイ で Stripe Terminal を選びます。
- 行に リーダーを検索中… リーダーの電源を入れ、このデバイスの近くに置いてください。 と表示され、その後 リーダーが 1 台見つかりました。このリーダーですか? または リーダーが 3 台見つかりました。どれを使いますか? と表示されます。使用するリーダーの横の 接続 をタップします。
- 初回接続時にリーダーのソフトウェア更新がインストールされます。 行に リーダーのソフトウェアをインストール中 と進行状況バーが表示され、リーダーの電源を入れたまま、充電してください。初回の更新には約 10 分かかります。 と表示されます。開始前にバッテリーを半分以上まで充電し、この画面を開いたままにしてください。
- 行に 接続済み とリーダーのバッテリー残量が表示されます。例:接続済み · 80%。
2 回目以降は数秒で接続でき、次の販売時にはレジが同じリーダーに再接続します。リーダーが接続されていない間、Bluetooth リーダー セクションには リーダーはまだ接続されていません。リーダーの電源を入れ、このスマートフォンの近くに置いてください。 と表示されます。
Tap to Pay
Tap to Pay は iOS および Android アプリのアップデートで対応予定です。アプリが対応した後は、次のように利用できます。 iOS または Android アプリを使用しているスマートフォンでは、このスマートフォン セクションに iPhone の Tap to Pay または Android の Tap to Pay の行が表示されます。ショップマネージャーか管理者が Tap to Pay を設定 をタップします。それ以外のユーザーには 未設定 · 管理者にお問い合わせください と表示されます。
初回は、スマートフォンでサービス提供元の規約への同意を求められます。iPhone では、Apple から Apple ID の連携と Tap to Pay 利用規約への同意を求められます。設定が完了すると、行に 準備完了 と表示されます。Tap to Pay で決済するにはネットワーク接続が必要です。
リーダーの行に表示される状態
各リーダーの行には、リーダー名、シリアル番号、Terminal のロケーション、および状態を示す 1 行が表示されます。
- 接続済み · 80% — 決済可能な状態で、バッテリー残量も表示されます。Tap to Pay では 準備完了 と表示されます。
- 未接続 — レジにこのリーダーは保存されていますが、現在は接続されていません。接続 をタップしてください。
- … に接続中 — そのままお待ちください。ボタンには 接続中… と表示されます。
- リーダーのソフトウェアをインストール中 — 更新中です。Bluetooth リーダーの手順 4 を参照してください。
- リーダーが見つかりません。リーダーの電源を入れて、もう一度お試しください。 — 再試行 をタップするか、リーダーが表示されませんか? をタップしてリーダーのガイドを開きます。
- 接続できませんでした:… — 続けて Stripe からの理由が表示されます。再試行 または ヘルプ をタップしてください。
- リーダーを接続するには Bluetooth をオンにしてください。 — このデバイスの Bluetooth がオフになっています。
- アプリの設定でリーダーへのアクセスを許可してください。 — アプリに Bluetooth の使用が許可されていません。スマートフォンの設定で許可してください。
行の横の ⋮ メニューにある 登録を解除 を選ぶと、次の販売時にレジがそのリーダーへ再接続しなくなります。このページから再度接続できます。接続済みの行にある 切断 ボタンは、現在の接続を切断します。アプリがリーダーを占有したままになっている場合は、メニューに リーダーを解放 も表示されます。
本番運用の前にテストする
決済ゲートウェイの設定ページ(WP Admin > WooCommerce > 設定 > 支払い > Stripe Terminal)で テストモード にチェックを入れて保存します。以後の決済は Stripe のテストアカウントに送られ、実際の金銭の移動はありません。決済を受け付けるの手順でテスト販売を行ってください。
- スマートリーダー:Stripe のテストアカウントに登録したシミュレーション用リーダーが実機と一緒に表示されるため、ハードウェアがなくても販売を試せます。
- Bluetooth リーダー と実機のスマートリーダー:Stripe ダッシュボードの Terminal ショップで注文できる Stripe の物理テストカードで決済します。金額の末尾 2 桁によって結果が決まります。
.00は承認、.05は拒否、.02は PIN1234の入力を求めます。
テストが終わったら、実際の決済を受け付ける前に テストモード のチェックを外して保存してください。
決済を受け付ける
レジの開閉 が有効な場合、レジが閉じている間は支払いを記録できず、すでに受け付けたカード決済を払い戻す必要があります。レジを開くを参照してください。
-
カートに商品を追加し、チェックアウト を押します。
-
支払いパネルで Stripe Terminal のタイルをタップします。
-
リーダーを確認します。スマートリーダーでは 端末:… と表示され、店舗が許可していれば 変更 で別のリーダーを選べます。Bluetooth リーダーでは 接続済み · 80%、または リーダーが接続されていません と 設定 → カードリーダー へのリンクが表示されます。
-
… を Stripe Terminal に送信 を押し、お客様に支払っていただきます。
- スマートリーダー:お客様がリーダーでカードをタッチ、挿入、またはスワイプする間、レジには 端末でのお客様の操作を待っています と表示されます。
- Bluetooth リーダー:レジに リーダーにカードをかざしてください と表示されます。
- Tap to Pay:スマートフォンに専用の Tap to Pay 画面が表示され、お客様がカードやスマートフォンをこちらのスマートフォンにタッチします。
レジでは 送信済み、端末で処理中、承認済み、売上確定済み の順にチェックが付きます。
-
未払い額がなくなるとレシート画面が開きます。レシートを印刷するかメールで送信し、新しい販売 を押します。支払い完了を確認するを参照してください。合計額の一部が未払いの場合は、残額を別の方法で受け付けます。分割払いを参照してください。
中止するには 端末でキャンセル を押します。カードが拒否されると、決済に失敗しました:… と 再試行、別の支払い方法を選択 が表示されます。カードリーダーでの支払いを参照してください。
このタイルではカード情報を入力できません。電話注文については、電話注文(MOTO)を参照してください。
お客様がリーダーで追加したチップは、注文に チップ という手数料項目として追加されます。WisePad 3、WisePOS E、S700、S710 はチップの入力を求めることができますが、M2 は対応していません。Stripe ダッシュボードでリーダーのチップ機能を有効にしてください。
電話注文(MOTO)
MOTO(メール注文、電話注文)では、来店していないお客様のカードを受け付けます。カードをタッチする代わりに、リーダーの画面でカード番号、有効期限、セキュリティコードを入力します。電話注文はチェックアウトのレガシー タブにある Stripe 独自のパネルでのみ処理できます。支払い タブの Stripe Terminal タイルでは、カード情報を入力できません。
次の 3 つすべてを満たすと、電話注文スイッチが表示されます:
- Stripe でアカウントの MOTO を有効にしてもらいます。 デフォルトでは無効です。Stripe サポートにお問い合わせください。
- 電話注文(MOTO)にチェックを入れます。
WP Admin > WooCommerce > 設定 > 支払い > Stripe Terminalに移動し、電話注文(MOTO) にチェックを入れて保存します。 - S700、S710、または WisePOS E スマートリーダーを使用します。 Stripe のパネルでこれらのいずれかを接続すると、スイッチが表示されます。P400、M2、WisePad 3、Tap to Pay、シミュレーション用リーダーでは表示されません。
電話注文(MOTO) にチェックが入っている間は、レガシータブでのすべての Stripe Terminal 決済に対して、通常のパネルの代わりに Stripe 独自のパネルが表示されます。電話注文だけに限定されません。チェックを外すと、レガシータブに 端末 選択欄と 端末に送信、キャンセル、再試行 が表示され、支払い方法パネルからの決済と同様に記録されます。
電話注文を受け付けるには:

- レガシー — 店舗独自の決済ページをレジ内に表示するタブです。
- 店舗の決済ページ — ここで Stripe Terminal を選び、下にスクロールして 利用可能なリーダー、接続、電話注文 を表示します。
- 支払いを処理 — ほかのレガシー決済と同様に、ページの下にあるレジのボタンです。電話注文は、ページ内の 端末で支払う から開始します。
- チェックアウトを押し、レガシータブを開いて Stripe Terminal を選びます。
- 利用可能なリーダー で、使用するリーダーの 接続 を押します。
- 電話注文 を有効にします。
- 端末で支払う を押します。リーダーには、タッチを求める表示の代わりにカード情報の入力画面が表示されます。
- リーダーでカード番号、有効期限、セキュリティコードを入力します。
Stripe は電話注文をカード非対面決済として扱うため、対面カード決済の料金体系や、不正利用時の責任移転は適用されません。
問題が発生した場合
リーダーが接続できない。 スマートリーダーは Wi-Fi または Ethernet に接続し、Stripe ダッシュボードに登録済みでオンラインになっている必要があります。Bluetooth リーダーには iOS または Android アプリが必要です。Bluetooth をオンにし、アプリに Bluetooth の使用を許可してください。
「Terminal のロケーションを選択してください…」。 決済ゲートウェイで現在使用しているモード(テストまたは本番)の Terminal のロケーションが設定されていません。決済ゲートウェイを設定するの手順 3 を参照してください。
初回接続に時間がかかる。 リーダーのソフトウェア更新のため、約 10 分かかります。リーダーの電源を入れたまま充電し、この画面を開いたままにしてください。次回からは数秒で接続できます。
Stripe のタイルに利用できないと表示される。 ブラウザーやデスクトップのレジでこの表示が出る場合、店舗でアプリのリーダーのみが許可されています。スマートリーダー、Bluetooth、または両方を参照してください。オフラインの場合、カードリーダーは接続の復旧を待ちます。オフラインモードを参照してください。
カードリーダーに この店舗ではアプリのリーダーのみが許可されています。 と表示される。 ブラウザーやデスクトップのレジでは、これも同じ原因です。POS 接続 で スマートリーダー を許可するか、iOS または Android アプリを使用してください。スマートリーダー、Bluetooth、または両方を参照してください。
カードが拒否される。 別のカードか別の支払い方法をお客様にお願いしてください。テストモードの場合は、金額の末尾 2 桁を確認します。
電話注文のスイッチが表示されない場合。 電話注文は Stripe Terminal タイルではなく、レガシータブでのみ処理できます。電話注文(MOTO) にチェックが入っていること、S700、S710、または WisePOS E に接続していること、シミュレーション用リーダーではないことを確認してください。
電話注文が失敗する。 Stripe がアカウントで MOTO をまだ有効にしていないか、入力したカード情報に誤りがあります。
解決しない場合は? GitHub で不具合を報告するか、リーダーについては Stripe の Terminal ドキュメントを確認してください。アカウントについては Stripe サポートにお問い合わせください。