メインコンテンツにスキップ
バージョン: 1.x

Stripe Terminal ゲートウェイ

Stripe Terminal ゲートウェイを使用すると、WCPOS 内で Stripe Terminal ハードウェアリーダーを使用して対面での支払いを直接受け付けることができます。このゲートウェイは、物理的なカードリーダーとテスト用のシミュレーターモードの両方をサポートしています。

機能​

ハードウェア統合

インターネット接続を介して物理的な Stripe Terminal リーダーを接続

シミュレーターモード

Stripe のシミュレーターを使用してハードウェアなしで支払いをテスト

リアルタイム処理

即時の支払い処理と確認

安全な取引

Stripe による PCI 準拠の支払い処理

電話注文 (MOTO)

リーダーにカード情報を入力して、電話越しにカード支払いを受け付ける

インストール​

1

Stripe Terminal for WooCommerce をインストール

WP Admin > POS > Settings > Extensions からインストールするか、GitHub リリースページ から最新のプラグイン zip アセット（GitHub のソースコード zip や tarball ではありません）をダウンロードし、Plugins > Add New > Upload Plugin からアップロードします。

2

Stripe 設定の構成

  1. WP Admin > WooCommerce > Settings > Payments に移動します
  2. 支払い方法リストで Stripe Terminal を見つけます
  3. Stripe Terminal をクリックして設定にアクセスします
  4. Stripe Secret Key を入力します（Stripe ダッシュボードから取得できます）
  5. 設定を保存します
ノート

WooCommerce の設定で Stripe Terminal ゲートウェイを有効にする必要はありません。次のステップで POS 専用に有効化されます。

3

WCPOS で有効化

  1. WP Admin > POS > Settings > Checkout に移動します
  2. リストで Stripe Terminal ゲートウェイを見つけます
  3. POS で使用するためにゲートウェイを有効化します
  4. 設定を保存します

使用方法​

リーダーの接続​

POS でのチェックアウト中に Stripe Terminal ゲートウェイを選択すると：

  1. 接続方法の選択: 物理リーダーを接続するか、シミュレーターを使用できます
  2. 物理リーダー: 画面の指示に従って Stripe Terminal デバイスを接続します
  3. シミュレーター: ハードウェアなしでさまざまな支払いシナリオをテストするには、シミュレーターモードを選択します

支払いの処理​

  1. アイテムの追加: POS でカートに商品を追加します
  2. ゲートウェイの選択: 支払い方法として「Stripe Terminal」を選択します
  3. リーダーの接続: リーダーを接続するか、シミュレーターモードを選択します
  4. 支払いの処理: 取引を完了するためのプロンプトに従います
  5. 確認: 支払いが成功すると、注文が自動的に完了します

シミュレーターでのテスト​

シミュレーターを使用すると、さまざまな支払い方法とシナリオをテストできます：

  • カード支払い: 異なるカードタイプ（Visa、Mastercard など）をテスト
  • 非接触型支払い: タップして支払う取引をシミュレート
  • エラーシナリオ: 拒否された支払いやその他のエラー条件をテスト
  • 異なる金額: さまざまな取引金額をテスト

電話注文 (MOTO)​

MOTO（Mail Order/Telephone Order：通信販売／電話注文）を使用すると、その場にいない顧客のカード支払いを処理できます。たとえば、電話越しに注文を受ける場合などです。カードをタップまたは挿入する代わりに、加盟店がカード情報をターミナルリーダーの画面に直接入力します。

セットアップ​

1

Stripe に MOTO アクセスをリクエスト

MOTO はデフォルトでは有効になっていません。Stripe サポートに連絡し、アカウントの MOTO 権限を有効にするよう依頼してください。これは簡単な手続きですが、Stripe による手動承認が必要です。

2

プラグイン設定で有効化

  1. WP Admin > WooCommerce > Settings > Payments > Stripe Terminal に移動します
  2. Phone Orders (MOTO) チェックボックスをオンにします
  3. 設定を保存します
3

対応リーダーを接続

MOTO は、対応ターミナルに記載されている、対応するインターネット接続リーダーでのみ動作します。その他のリーダータイプではトグルが表示されません。

電話注文を受ける​

  1. 対応リーダーを接続します（対応ターミナルを参照）
  2. 支払い画面で Phone Order をオンに切り替えます
  3. Collect Card Payment をクリックします — リーダーはタップ／挿入を促す代わりに、カード番号入力画面を表示します
  4. リーダーに顧客のカード番号、有効期限、CVV を入力します
  5. そこからは通常どおり支払いが処理されます
ヒント

MOTO 支払いは、支払い方法のタイプとして card_present ではなく card を使用します。これは、Stripe の観点ではオンライン取引に近い扱いとなるため、対面料金ではなく標準のオンラインカード処理手数料が適用されることを意味します。

注意

Phone Order トグルは、次の 3 つの条件がすべて満たされた場合にのみ表示されます。プラグイン設定で MOTO 設定が有効になっていること、対応リーダーが接続されていること、そしてリーダーがシミュレーターでないこと。トグルが表示されない場合は、これらの条件を確認してください。

要件​

Stripe アカウント: Terminal が有効化されたアクティブな Stripe アカウント
API キー: ダッシュボードからの Stripe シークレットキー
WCPOS: POS チェックアウトには Pro バージョンが必要
HTTPS: セキュリティのためにサイトは SSL/HTTPS を使用する必要があります

ハードウェアの互換性​

接続要件

この実装は Stripe の JavaScript SDK を使用しており、Web アプリケーションを通じて機能しますが、インターネットに接続されたターミナルのみが必要です。Bluetooth ターミナルは現在サポートされていません。

対応ターミナル（インターネット接続）​

  • Stripe Reader S700/S710 ✅ - イーサネット/WiFi 接続ターミナル
  • WisePOS E ✅ - WiFi 接続ターミナル

非対応ターミナル（Bluetooth）​

  • BBPOS Chipper 2X BT ❌ - Bluetooth 専用
  • BBPOS WisePad 3 ❌ - Bluetooth 専用
  • Verifone P400 ❌ - Bluetooth 専用
今後のサポート

Bluetooth ターミナルのサポートは、今後の iOS および Android アプリのリリースで予定されています。利用可能になると、M2 や WisePad 3 を含むすべての Stripe Terminal 認定リーダーのサポートが可能になります。

一般的な問題​

リーダーが接続できない
  • 対応するインターネット接続ターミナルを使用していることを確認してください
  • ターミナルが WiFi/Ethernet に接続されていてオンラインであることを確認してください
  • Stripe アカウントで Terminal が有効になっていることを確認してください
  • ターミナルが Stripe ダッシュボードに登録されていることを確認してください
支払いが拒否された
  • Stripe アカウントがアクティブで良好な状態であることを確認してください
  • 使用されているカードが有効であることを確認してください
  • 十分な資金があることを確認してください
Phone Order トグルが表示されない
  • WooCommerce > Settings > Payments > Stripe Terminal で Phone Orders (MOTO) 設定が有効になっていることを確認してください
  • 対応リーダーに接続していることを確認してください（対応ターミナルを参照）— その他のリーダータイプではトグルが非表示になります
  • シミュレーターを使用しているときはトグルが表示されません
MOTO 支払いがエラーで失敗する
  • Stripe がアカウントで MOTO 権限を有効にしていることを確認してください — まだの場合は Stripe サポートに連絡してください
  • リーダーにカード情報が正しく入力されたか再確認してください
  • MOTO 支払いは不正検出がより厳格な場合があります — カードが有効で十分な資金があることを確認してください
SSL 証明書エラー
  • Stripe Terminal は HTTPS を必要とします - サイトに有効な SSL 証明書があることを確認してください
  • SSL 証明書が正しく構成されていることを確認してください

ヘルプを得る​

技術サポートについては：

  • 問題を報告するには GitHub リポジトリにアクセスしてください
  • ハードウェア固有のガイダンスについては Stripe Terminal ドキュメントを確認してください
  • アカウント関連の問題については Stripe サポートに連絡してください

スクリーンショット​

スクリーンショットは今後の更新で追加され、次の内容を示します：

  • WooCommerce の支払い設定でのゲートウェイ構成
  • Stripe Terminal 選択のある POS チェックアウトインターフェース
  • さまざまな支払い方法を使用したシミュレーターテストインターフェース