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

Windcave端末ゲートウェイ

Windcave端末ゲートウェイを使うと、Windcave HIT経由でWindcave端末による対面カード決済を受け付けられます。決済はWCPOSから開始し、端末で完了すると、確認結果がWooCommerceの注文に記録されます。

0.1.0の新機能 — Windcaveの認定待ち

0.1.0は初回リリースです。Windcaveでは、本番環境で使用する前に連携機能のQA認定が必要ですが、この連携機能はまだ認定されていません。認定が完了するまでは、WindcaveのUAT（テスト）認証情報を使用してください。Vendor IDは認定時にWindcaveから発行されます。

機能​

クラウドHIT接続

ローカルでのペアリングは不要です。端末ごとにStation IDを1つ使用し、WindcaveのクラウドHITサービス経由で接続します

端末の案内を画面に表示

決済パネルで端末の案内とボタンを確認できます。署名確認のYES/NOやCANCELも表示されます。

検証後に完了

決済参照番号、金額、環境、注文合計、通貨を確認した後にのみ注文が完了します。

決済を保留

タイムアウト後は処理中の決済をいったん保留し、バックグラウンドで状況を確認しながら作業を続けられます。

結果通知

任意の結果通知（FPRN）を有効にすると、ポーリングのバックアップとしてWindcaveからサイトへ通知できます。

仕組み​

このゲートウェイはHTTPS経由でWindcave HIT (Host Initiated Transaction)を使用します。EnvironmentでUATまたは本番のエンドポイントを選択し、各端末にはWindcaveが発行したStation IDで接続します。

決済を開始すると、注文合計と通貨が端末に送信されます。決済ページは1.5秒ごとにWindcaveをポーリングし、端末の案内と使用可能なボタンを表示します。任意の**結果通知（FPRN）**を使うと、ポーリングのバックアップとしてWindcaveからサイトへ通知できます。

設定​

1

Windcave Terminal for WooCommerceをインストール

GitHubリリースページからプラグインのzipファイル（GitHubのソースコードzipではありません）をダウンロードします。プラグイン > 新規追加 > プラグインのアップロードからアップロードし、WooCommerceがインストールされ有効になっている状態でプラグインを有効化してください。

有効化には**PHP 7.4+とPHP DOM拡張機能（php-xml）**が必要です。いずれかがない場合、有効化はメッセージとともに拒否されます。

2

WindcaveからHIT認証情報を取得

WindcaveにHIT username、HIT key、および端末ごとに1つのStation IDを依頼してください。WindcaveのIntegration Requirements formから開発用アカウントを申請します。

UATと本番の認証情報は別々です。この連携機能が認定待ちの間はUAT認証情報を使用してください。

3

ゲートウェイを設定

  1. WP Admin > WooCommerce > 設定 > 支払いに移動し、Windcave Terminalを開きます。
  2. EnvironmentをUAT (testing)（デフォルト）に設定します。ProductionはWindcaveの認定後に本番認証情報で使用します。
  3. Windcaveから発行されたHIT usernameとHIT keyを入力します。
  4. Station IDsを1行に1つずつ入力します
  5. （任意） Default Station IDを設定します。Lock terminal selectionを有効にすると、常にそのデフォルトが使われ、レジ係は変更できなくなります。
  6. Windcaveが認定時に発行するまで、Vendor IDは空欄にしておきます。
  7. 設定を保存します。
4

結果通知を有効化（任意）

**Result notifications (FPRN)**を有効にして保存すると、取引結果の準備ができたときにWindcaveからサイトへ通知されます。これはポーリングのバックアップです。

5

WCPOSで有効化

  1. WP Admin > POS > 設定 > 支払いに移動します。
  2. Windcave Terminalゲートウェイを見つけ、POSで有効にします。
  3. 設定を保存します。
ノート

WooCommerceの設定画面にあるEnable/Disableチェックボックスは、オンラインストアのチェックアウトのみを制御します。このゲートウェイは、チェックボックスの状態にかかわらず、設定済みであればWCPOSで使用されます。

設定リファレンス​

設定機能
Enable/Disableオンラインストアのチェックアウトでゲートウェイを有効にします。POSでの有効化はPOS > 設定 > 支払いで行います。
Titleチェックアウトに表示するラベルです。デフォルトはWindcave Terminalです。
Descriptionチェックアウトに表示する説明です。デフォルトはPay in person on the Windcave terminal.です。
EnvironmentUAT (testing)（デフォルト）またはProductionを選択します。それぞれHIT認証情報が別に必要です。本番環境にはWindcaveの認定が必要です。
HIT username選択した環境用にWindcaveが発行したHIT usernameです。
HIT key選択した環境用にWindcaveが発行したHIT keyです。
Station IDsWindcaveが発行したStation IDを1行に1つずつ入力します。端末ごとに1つ必要です
Default Station IDあらかじめ選択されるStationです。Stationが選択されていない場合にも使用されます。
Lock terminal selection常にデフォルトのStationを使用し、レジ係が変更できないようにします。デフォルトが設定されている場合のみ有効です。
Vendor IDWindcaveが認定時に発行します。Windcaveから受け取るまで空欄にしてください。
POS namePOSを識別するためWindcaveに送信される名前です。デフォルトはWCPOSです。
Result notifications (FPRN)ポーリングのバックアップとして、取引結果の準備ができたときにWindcaveからサイトへ通知するよう要求します。デフォルトではオフです。
Checkout logs決済パネルにログツールを表示します。デフォルトではオフです。
Log levelOff、Errors only、Debugから選択します。デフォルトはDebugで、キーとカード情報をマスクしてリクエストとレスポンスを記録します。
SupportDownload support bundleと、WooCommerce > Status > ログでログを表示するためのリンクを提供します。

接続テストボタンはありません。認証情報とStation IDは、最初の決済時に確認されます。

使い方​

決済処理​

  1. Add Items：POSのカートに商品を追加します。
  2. Select Gateway：支払い方法としてWindcave Terminalを選択します。
  3. Choose Terminal：Stationを選択するか、ロックされた既定値を使用します。Stationが2つ以上あり、既定値がない場合は選択が必要です
  4. Start Payment：Start Terminal Paymentをクリックして、注文合計を端末に送信します。
  5. Follow Prompts：署名確認のYES/NOや、表示された場合のCANCELなど、端末の案内と使用可能なボタンが画面に表示されます。
  6. Automatic Completion：承認と検証が完了すると、注文が完了し、POSにレシートが表示されます。

決済操作​

  • Start Terminal Payment：選択したStationに新しい決済リクエストを送信します。
  • Cancel Terminal Payment：端末で操作できる場合はCANCELボタンを押します。操作できない場合は端末上でキャンセルするか、選択肢が表示されたときに決済を保留します。
  • Set payment aside：5分のタイムアウト後に表示されます。試行を10分間のバックグラウンド確認に引き継ぎ、別の方法で決済を受け付けられるようにします。Windcaveでの決済はキャンセルされません。
  • ページの再読み込み：進行中の決済を再開します。

レシート​

Windcaveから端末レシートのテキストが返された場合、WooCommerceの非公開注文メモとして保存されます。

返金​

WooCommerceからの返金は0.1.0ではサポートされていません。Windcaveポータル（Payline）または端末で返金し、その後WooCommerceに返金を手動で記録してください。

ログとサポートバンドル​

ログはWooCommerce > Status > ログのwindcave-terminalソースにあります。ログレベルのデフォルトはDebugで、キーとカード情報をマスクしてWindcaveへのリクエストとレスポンスを記録します。

ゲートウェイ設定画面でサポートバンドルをダウンロードをクリックして.jsonファイルをダウンロードし、注文番号とともに送信してください。環境の詳細、HIT keyとusernameをマスクした設定、レシートを除いた直近20件までの注文の決済試行、最新2件のログファイルから取得した末尾1,000行が含まれます。ログ行には、カード番号をマスクした端末レシートのテキストが含まれる場合があります。

WooCommerceでデータベースログハンドラーを使用している場合、バンドルにログ行は含まれません。代わりにWooCommerce > Status > ログからログをエクスポートしてください。

決済パネルにログツールを表示するには、Checkout logsを有効にします。

要件​

Windcaveアカウント: HIT username、HIT key、端末ごとのStation IDが必要です。本番環境で使用するにはWindcaveの認定が必要です。
対応ハードウェア: HITを使用するWindcave端末
WCPOS: POSでのチェックアウトにはWCPOS Proが必要です。
サーバー: WordPress 5.2+、WooCommerce、およびDOM拡張機能（php-xml）付きのPHP 7.4+
通貨: 小数点以下2桁の通貨
安定した接続: API通信に必要な安定したインターネット接続

対象範囲と制限​

認定が必要です

この連携機能はWindcaveの認定をまだ受けていません。WindcaveのQA認定が完了するまでUAT認証情報を使用してください。認定前に本番環境で使用しないでください。

  • WooCommerceからの返金は0.1.0ではサポートされていません。
  • チップ、追加料金、キャッシュアウトはサポートされていません。
  • 小数点以下2桁の通貨のみ対応しています
  • 端末には注文合計全額が請求されます。端末で注文の一部のみを支払うことはできません。
  • Station IDsは手動で入力します。端末は自動検出されません。
  • このゲートウェイはPOS向けです。オンラインストアでは注文支払いページでのみ動作します。

トラブルシューティング​

よくある問題​

有効化が拒否される：PHP DOM拡張機能（php-xml）が必要です
  • サーバーにPHP DOM拡張機能がありません。
  • ホスティング事業者にphp-xmlを有効にするよう依頼してください。有効化には**PHP 7.4+**も必要です。
Station IDが設定されていない
  • Station IDs設定が空です。
  • ゲートウェイ設定でWindcaveから発行されたStation IDを1行に1つずつ追加し、保存します
Windcave HIT認証情報が設定されていない
  • HIT usernameまたはHIT keyが空です。
  • ゲートウェイ設定に両方を入力して保存してください。Environmentがその認証情報に一致していることを確認してください。
端末で前の取引をまだ処理中です
  • そのStationでは前の取引がまだ進行中です。
  • 端末で完了またはキャンセルしてから、もう一度お試しください。
Windcaveにこの取引の記録がありません
  • 最初の30秒の猶予期間が過ぎても、Windcaveに記録がありません。
  • 決済をもう一度開始してください。
Windcaveは決済を承認しましたが、適用できませんでした
  • 承認結果が、この注文を完了するための確認条件を満たしませんでした。
  • Windcaveポータルを確認し、再度請求する前に注文メモを確認してください。
この決済は別の環境で開始されました
  • 決済の進行中にEnvironmentが変更されました。
  • 決済を開始した環境に戻すか、Windcaveポータルを確認してください。

サポートを受ける​

  • ゲートウェイ設定画面から注文番号とともにサポートバンドルを送信してください。
  • 問題を報告するにはGitHubリポジトリをご覧ください。
  • アカウント、認証情報、ハードウェアに関するお問い合わせはWindcaveサポートにご連絡ください。