Stripe Terminal のネットワーク要件

Terminal のネットワーク要件は、使用するリーダーと、実装の構築方法によって異なります。ネットワークが以下に示す要件を満たさない場合、 Terminal の実装は、予期したとおりに機能しません。

ネットワーク状態がよくわからないか不明なリモートの場所で Terminal リーダーを使用する予定の場合、ネットワーク関連の予期しない問題の処理に備えてください。スマートリーダーを使用する際には、発生する可能性のあるネットワークの問題の数を最小限に抑えるために、サーバー主導型の導入 をお勧めします。

モバイルリーダー

モバイルリーダーは、インターネット接続を POS デバイスに依存し、次のネットワーク要件を持ちます。

• POS デバイスはインターネットに接続され、さらにStripe のインフラストラクチャー に接続可能である必要があります。
• 動作環境に、Bluetooth デバイスが正常に機能するのを妨げる干渉がないことを確認する必要があります (たとえば、電子レンジを過剰に使用すると 2.4GHz 帯域で干渉が発生し、Bluetooth 接続が中断されることがあります)。

スマートリーダー

スマートリーダー は、ネットワークに直接接続し、その接続を使用してインターネットや Stripe にアクセスします。Stripe の Terminal SDK のいずれかを使用する場合、POS デバイスとスマートリーダーは、ローカルネットワークを介して相互に直接通信します。

スマートリーダーには次のネットワーク要件があります。

• ネットワークが IPv4 をサポートしている必要があります。
  • IPv6 のみのネットワークはサポートされていません。
  • 一部のリーダーは DHCP を介して IPV6 ネットワークに接続できますが、IPv4 アドレスも割り当てる必要があります。静的 IP、ルーター、サブネットマスク、DNS などの詳細設定の変更は、IPv6 ではサポートされていません。
• Terminal リーダーには、プライベート IP アドレス を割り当てる必要があります。
• Terminal リーダーと POS デバイスの両方が、Stripe のインフラストラクチャー に接続可能である必要があります。
• Terminal リーダーが WiFi とイーサネットの両方に対応している場合、両方ではなく、一方を使用します。WiFi とイーサネットを同時に使用しようとすると、接続が不安定になり、断続的なダウンタイムが発生します。
  • WiFi を使用する場合は、イーサネットケーブルを接続せずにドックを使用できます (充電またはアクセサリー専用など)。
• WiFi ネットワークは WPA/WPA2/WPA3-Personal または WPA2/WPA3 EAP-PEAP Enterprise の暗号化を使用し、パスワードで保護されている必要があります。
  • Verifone P400 リーダーは、WPA パーソナルまたは WPA2 パーソナルの暗号化のみに対応しています。
• イーサネットネットワークは 10/100 イーサネットデバイスをサポートしている必要があります。
• ネットワークで動的な IP アドレスの割り当てを使用する場合は、DHCP サーバー設定で、 Terminal リーダーが少なくとも 1 営業日の間ずっと同じ IP アドレスを保持できるようにする必要があります。
• ネットワークでネットワークセッション (アイドル状態のセッションを含む) の期間を制限している場合、Terminal リーダーの最小セッション期間は、少なくとも 1 営業日全体でなければなりません。
• Stripe のいずれかのTerminal SDK を別の POS デバイス で使用する場合 (たとえば、Terminal リーダー上で実行しているアプリではない)、次の要件も満たしている必要があります。
  • リーダーは、POS デバイスと同じローカルネットワーク上にある必要があります。
  • リーダーは、ローカルネットワークを介して POS デバイスと直接通信できる必要があります。
  • POS デバイスで使用される DNS サーバーは、インターネットでルーティング可能なホスト名をローカル IP アドレスに解決できる必要があります。

トラブルシューティング

ネットワーク関連の問題が発生した場合は、経験豊富な担当者に実際に問題を診断して修正してもらう必要があります。 Terminal の導入、デプロイ、および保守を計画する際は、この点を考慮してください。

問題が発生した場合は、その原因がネットワークかその他のものかを判断します。1 つ以上の Terminal リーダーと POS デバイスを別のネットワークおよびインターネット接続に一時的に移動し、同じ問題がそこで発生していないかを確認することで、ネットワークを問題の原因から除外できます。このようなテストには、モバイルホットスポットが適しています。

問題が別のネットワークおよびインターネット接続で解決しない場合は、導入のコードについて追加のテストとデバッグを実行します。サポートが必要な場合は、サポートに問い合わせて、技術的な詳細情報 (エラーメッセージ、ログなど) をできるだけ詳しくお知らせください。

お客様のネットワークのみで問題が発生している場合は、以下をお試しください。

• 特に最近ネットワークに関する変更があった場合は、ネットワークが上記のすべての要件を満たしていることを確認してください。
• ファイアウォールやその他のセキュリティ設定を調べて、Stripe のインフラストラクチャー へのアクセスがブロックされていないことを確認してください。
• Terminal リーダーと POS デバイスの両方に、別の接続を試します (WiFi からイーサネットに切り替えるなど)。
• WiFi の場合は、すべてのデバイスの信号強度が十分であることを確認してください。
• イーサネットの場合は、別のネットワークケーブルの使用をお試しください。
• スマートリーダーに、想定される IP とサブネットが割り当てられていることを確認します。
• 別の POS デバイスでスマートリーダーと Terminal SDK を使用している場合、以下を実行してください。
  • POS デバイスで、10-42-42-42.test.device.stripe-terminal-local-reader.net を IP アドレスに解決してみます。このホスト名は IP 10.42.42.42 に解決されるはずです。別の IP に解決される場合、または DNS 解決に失敗した場合は、Cloudflare DNS サーバー (1.1.1.1 および 1.0.0.1) または Google DNS サーバー (8.8.8.8 および 8.8.4.4) を使用するように POS デバイスを設定して、もう一度お試しください。
  • ルーターの設定を確認して、無線 (WiFi) クライアントと有線 (イーサネット) クライアント間の接続がブロックされていないかを確認します。
  • POS デバイスから Terminal リーダーの IP アドレスに ping を送信できることを確認します。