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

Windcave Terminalゲートウェイ

Windcave Terminalは、レジからWindcave端末へ販売情報を送信します。お客様が端末で支払い、Windcaveの確認後にレジへ支払いが記録されます。

このページではレジでの操作から説明します。店舗の管理者向けのWindcave Terminalの設定では、認証情報やWP Adminの設定、動作確認の方法を説明します。

Pro機能

Windcave Terminalを使うには、WCPOS Pro 2.0以降と、拡張機能のバージョン1.0以降が必要です。

Windcaveの認証はまだ取得していません

テスト決済のみ:Windcaveでは、まだ実際のお客様のカードを使わないでください。 WindcaveはPOS連携をすべて審査してから実決済を許可しますが、この連携はまだ承認されていません。

まだテストされていない点

この拡張機能は、まだ実機のWindcave端末で動作していません。Windcaveのドキュメントをもとに作成したHITサービスの代替環境で、決済と払い戻しをテストしました。利用を始める前に、少額のUAT販売を行い、払い戻しも試してください。

カード決済を受け付ける​

先にレジを開いてください

レジの開閉が有効な場合、レジが閉じている間は支払いを記録できません。すでに受け付けたカード決済は払い戻しが必要になります。この設定についてはレジをご覧ください。

  1. カートでチェックアウトを押し、PaymentsタブにあるWindcave Terminalのタイルをタップします。端末で署名を求められる場合は、代わりにLegacyタブを使います。端末から質問された場合をご覧ください。
  2. キーパッドの上を確認します。Choose a terminalと表示されている場合は、レジカウンターにある端末のStation IDをタップします。これはWindcaveが各端末に付ける名前で、たとえばDOCS-STATION-1です。Terminal: とIDが表示されていれば、そのレジで使う端末です。別の端末を選ぶにはChangeを押します。レジは選択を記憶します。
  3. カードで残額の一部を支払うには、金額を入力します。残りは別の支払い方法で精算するまで未払いのままです。
  4. Send … to Windcave Terminalを押します。レジには4段階の進行状況、Sent、On terminal、Approved、Capturedが表示されます。Capturedになると決済が完了しています。
  5. お客様は端末でカードをタッチ、挿入、またはスワイプします。決済が完了し、支払う残額がなければレシートが開きます。残額がある場合は、別のタイルで支払いを受け付けます。
45.00ドルの販売でPaymentsタブを開いたCheckout画面:Windcave Terminalタイルが選択され、Choose a terminalの下に2つのStation ID、その下にFull balanceが表示されている。端末を選ぶまでSend $45.00 to Windcave Terminalボタンは無効
  1. Windcave Terminal — タップすると枠線が付くタイルです。
  2. Choose a terminalの下にあるStation IDs — カウンターの端末をタップします。このレジで端末を選択すると、この行にはTerminal: とそのID、Changeが表示されます。
  3. To pay — 今回の支払い金額です。残額の一部だけをカードで支払う場合は、より小さい金額を入力します。
  4. Full balance — 未払いの全額をTo payに戻します。
  5. Send … to Windcave Terminal — 端末で決済を開始します。端末を選ぶまでは無効です。
  6. Legacy — 独自の支払いページを持つゲートウェイ用の別の支払いタブです。端末で署名を求められる場合に使います。

4つのステップの下にあるDetailsを開くと、支払いと送信先のStationのログが表示されます。端末でチップ、追加料金、キャッシュアウトはできません。

端末から質問された場合​

端末が処理を中断して、たとえばお客様の署名が一致するかを尋ねることがあります。このバージョンでは、Paymentsタブに質問が表示されません。Legacyタブには表示されます。

  1. Legacyタブを開き、Windcave Terminalを選択します。Legacyタブをご覧ください。
  2. そこで決済を開始します。注文全額を1回で支払います。
  3. 端末から質問されると、支払いページには端末固有のボタン(YESやNOなど)とともに質問が表示されます。回答を押してください。

決済をキャンセルする​

お客様が支払う前にCancel on terminalを押します。端末自体にCANCELが表示されている間だけ操作できます。表示されていない場合、レジには*現在、端末からキャンセルできません。端末でキャンセルしてください。*と表示されます。

キャンセルは要求を送る操作です。カード情報がすでに読み取られている場合、決済が完了することがあります。レジにはCancelling — waiting for the terminal to confirmと表示され、結果が出るまで確認が続きます。別の方法で支払いを受け付ける前に、結果を待ってください。

レジが応答を受け取れない場合、Release this paymentが表示されます。解放してもキャンセルされたことにはなりません。管理者がWindcaveポータルを確認し、注文に対する承認済み決済がないと確認した後にだけ押してください。その後、別の方法で注文の支払いを受け付けられますが、店舗は端末の確認を続けます。

問題が発生した場合​

お客様が支払った可能性がある場合​

決済をもう一度受け付けないでください

次の2つのケースでは、カードに請求済みの可能性があります。管理者はまずWindcaveポータルで、注文番号から販売を確認してください。

端末の結果を確認できませんでした。再度支払いを受け付ける前にWindcaveを確認してください。 レジがすでに送信した決済を再確認しましたが、Windcaveから明確な回答を得られませんでした。管理者がポータルで販売を検索し、見つからなかった場合にだけ、もう一度支払いを受け付けてください。

決済に失敗しました:端末で確認された金額が異なります。 端末がレジから送られた金額とは異なる金額を承認したため、レジには記録されていませんが、カードに請求された可能性があります。別の決済を受け付けないでください。管理者にポータルで注文番号から販売を探し、端末で受け付けた金額と注文金額を比較してもらってください。

その他のメッセージ​

決済に失敗しました:カードが拒否されました

Try againを押して端末に再送信するか、Choose another wayを押して別のタイルで支払います。

端末は前の取引をまだ処理中です

Stationは別の決済で使用中です。端末でその決済を完了またはキャンセルしてから、Try againを押してください。

送信直後に決済に失敗する

拡張機能は、新しい決済がWindcaveに登録されるまで30秒待ちます。その時点でWindcaveに記録がなければ、拡張機能は未送信として扱い、決済は失敗します。端末の電源とネット接続、設定にStation IDが入力されていることを確認してから、Try againを押してください。

端末が質問している間、レジが待ち続ける

Paymentsタブには端末からの質問が表示されないため、決済が終了するまで待機します。Cancel on terminalを押すか、端末でキャンセルしてから、Legacyタブで決済を受け付けます。端末から質問された場合をご覧ください。

タイムアウト — 決済はキャンセルされました

5分以内に支払いがありませんでした。端末を確認してから、Try againを押してください。

Windcave Terminalのタイルがグレー表示または表示されない

レジにはタイルの下に理由が表示されます。理由の一覧はタイルを使用できない場合をご覧ください。

  • 注文 #… で使用中 — Stationは別の注文の決済で使用中です。その決済を完了またはキャンセルするか、Changeを押して別のStationを選択してください。
  • 接続が必要です — レジがオフラインです。端末決済は店舗経由で行うため、別の支払い方法を使うか、接続が戻るまで待ってください。
  • タイルが表示されない — ゲートウェイにHIT username、HIT key、またはStation IDsが設定されていないか、WCPOSで有効になっていません。管理者に設定を確認してもらってください。

Windcave決済を払い戻す​

払い戻しは、販売を受け付けたStationを通じてWindcaveへ送信されます。全額または一部を払い戻せます。

  1. POSで注文の払い戻しを開きます。払い戻しをご覧ください。
  2. Refund to Windcave Terminalを選び、Process Refundを押します。
  3. 店舗はWindcaveの応答を最大20秒待ち、その結果を注文メモに追加します。

WooCommerceのRefund … via Windcave Terminalボタンを使ったWP Adminからの払い戻しも、同じように処理されます。

払い戻しがpendingのままの場合は、もう一度払い戻す前にWindcaveポータルで確認してください。

払い戻しが保留中のままになる

Windcaveが20秒以内に応答しなかったか、要求と異なる金額を承認しました。店舗は再試行しません。Windcaveポータルで払い戻しを確認してください。処理済みならお客様に返金されています。未処理なら、もう一度払い戻してください。

バージョン0.1で受け付けた販売を払い戻せない

払い戻しが停止し、*この販売を払い戻す前にPOS設定で既定のStationを設定してください。*と表示されます。拡張機能のバージョン0.1は販売を受け付けたStationを記録しなかったため、バージョン1.0では店舗全体の既定Stationを使って払い戻します。現在、各レジはSettings > Card readersでStationを選びますが、WCPOS 2.0には店舗全体の既定値がまだありません。Windcaveポータルまたは端末で販売を払い戻し、WooCommerceではRefund … manuallyを使って記録してください。

Windcave Terminalを設定する​

管理者が店舗ごとにWP Adminで一度設定し、その後、各レジでStationを選びます。店舗から各端末にはインターネット経由でWindcaveを通じて接続するため、ペアリングは不要です。どのレジからでも任意の端末を使えます。

要件​

HIT認証情報(HIT usernameとHIT key)と、各端末のStation IDが必要です。これらはすべてWindcaveが発行し、WP Adminから検索したり作成したりすることはできません。Windcaveに連絡して、UAT用HIT認証情報と各端末のStation IDを依頼するか、開発用アカウントにはWindcaveのIntegration Requirementsフォームを利用してください。UATと本番環境にはそれぞれ別のユーザー名とキーが必要です。連携の認証後、WindcaveからVendor IDが発行されます。

Windcaveアカウント: HIT認証情報と端末ごとのStation ID。Windcaveが連携を認証するまではUAT認証情報を使用
端末: HIT決済に対応するWindcave端末
WCPOS: WCPOS Pro 2.0以降と、拡張機能のバージョン1.0以降
サーバー: WooCommerce、およびDOM拡張機能(php-xml)を備えたPHP 7.4以降

拡張機能をインストールする​

WP Admin > POS > 設定 > 拡張機能を開き、Windcave Terminal for WooCommerceを探してインストールし、有効化します。バージョン1.0以降が必要です。バージョン0.1はWCPOS 2.0より前のバージョン用です。拡張機能をご覧ください。

GitHubリリースページからプラグインzip(ソースコードzipではありません)をダウンロードし、プラグイン > Add Plugin > プラグインのアップロードからアップロードすることもできます。

WCPOS Pro 2.0がない場合、WP Adminには*Windcave Terminal requires WooCommerce POS Pro 2.0 or newer.*と表示され、ゲートウェイは追加されません。PHP 7.4未満、またはDOM拡張機能がない場合は有効化できません。ホスティング会社にphp-xmlを有効にするよう依頼してください。

HIT認証情報を入力する​

WP Admin > WooCommerce > 設定 > 支払いに移動し、Windcave Terminalを開きます。

WP AdminのWindcave Terminal設定:環境はUAT(テスト)、HIT username、HIT key、Station IDs、Vendor IDは空欄、POS nameはWCPOS
  1. Environment — 既定のUAT (testing) のままにします。Productionは、Windcaveによる連携認証後に本番用認証情報とともに使います。
  2. HIT username — 選択した環境用にWindcaveから発行されたものです。
  3. HIT key — Windcaveから発行されます。保存後はこの欄が空になります。保存済みのキーを保持する場合は、空欄のままにしてください。
  4. Station IDs — 端末ごとに1つ、1行に1つ入力します。Windcaveが発行するもので、自動検出はされません。
  5. Vendor ID — Windcaveから発行されるまでは空欄にします。
  6. POS name — Windcave側で使われるPOSの名前です。既定値はWCPOSです。

その下にあるResult notifications (FPRN) は任意です。有効にすると、レジによる確認を補うため、結果が確定したときにWindcaveからも店舗へ通知されます。利用するには、サイトがインターネットからアクセス可能である必要があります。

Save changesをクリックします。

WCPOSで有効にする​

WP Admin > POS > 設定 > 支払いを開き、GatewaysテーブルからWindcave Terminalを探し、Enabledをオンにします。この画面では変更が随時保存されるため、保存ボタンはありません。

WooCommerce設定ページのEnable/Disableはオフのままにします。ここでEnabledをオンにすれば、そのチェックボックスの状態にかかわらず、POSでゲートウェイを使えます。チェックアウト設定をご覧ください。

WP AdminのPOS設定、Checkout画面:Gatewaysテーブルの2行。Vipps MobilePayはオン、Windcave Terminalはオフ
  1. Windcave Terminal — Gatewaysテーブルにある拡張機能の行です。
  2. Enabled — ゲートウェイIDの横にあるスイッチです。オンにすると、レジを再読み込みした後にWindcave Terminalタイルが表示されます。

各レジのStationを選ぶ​

各レジでSettings > Card readersを開きます。入力したStation IDはすべてSmart readersの下にリーダーとして一覧表示され、状態はOnlineです。拡張機能はWindcaveに端末の電源状態を問い合わせません。カウンターにあるStationのUse this readerを押します。その行にSelectedと表示されます。レジ係はチェックアウト時にChangeを押して変更することもできます。

Stationが1つだけの場合、選択は不要です。すべてのレジですでにSelectedになっています。スマートリーダーを選ぶをご覧ください。

動作を確認する​

  1. Windcave Terminalの設定ページに戻ると、設定の下にuat: HIT credentials configured (not verified).と表示されます。ユーザー名とキーが保存されていることを示しますが、Windcaveがそれらを受け付けたことを意味しません。HIT credentials missing.は、どちらかが未入力であることを示します。
  2. レジでPOSを再読み込みし、チェックアウトを押します。支払い方法の1つとしてWindcave Terminalタイルが表示されます。タップすると、キーパッドの上にStation IDが表示されます。Choose a terminalの下、またはTerminal: とそのレジで使う端末として表示されます。
  3. UAT端末で少額の販売を行い、払い戻してください。接続テスト用のボタンはありません。この最初の販売で認証情報とStation IDを確認します。

バージョン0.1からアップグレードする​

  • まずWCPOS、WCPOS Pro、アプリを2.0に更新し、その後に拡張機能を更新します。
  • アップグレード中の決済は引き継がれます。二重に請求されることはありません。
  • バージョン0.1で保留にした決済は、注文が未払いのままであれば引き継がれます。それ以外の場合、注文には*Windcave TxnRef … was set aside before the 1.0.0 upgrade and is no longer followed automatically.*というメモが追加されます。Windcaveポータルで決済を確認してください。承認済みなら、ポータルで払い戻すか、注文に手動で記録してください。
  • バージョン0.1の次の設定は削除されました:Default Station ID、Lock terminal selection、Checkout logs、Log level。現在、各レジはSettings > Card readersでStationを選びます。
  • 保留機能も削除され、端末のレシートテキストは注文の非公開メモに追加されなくなりました。
  • バージョン0.1で受け付けた販売の払い戻しについては、Windcave決済を払い戻すをご覧ください。

設定リファレンス​

WP Admin > WooCommerce > 設定 > 支払い > Windcave Terminalを開きます。

設定機能
Enable/Disableオンラインストアのチェックアウトでゲートウェイを利用可能にします。オフのままにしてください。POSにはPOS > 設定 > 支払いに専用のスイッチがあります
Titleレジに表示されるタイル名です。既定値はWindcave Terminalです
Description既定値はPay in person on the Windcave terminal.です
EnvironmentUAT (testing)(既定)またはProductionです。それぞれに専用のHIT認証情報があり、本番環境にはWindcaveの認証が必要です。決済は開始時の環境で常に確認されます
HITユーザー名選択した環境用にWindcaveから発行されます
HIT keyWindcaveが発行します。保存後は表示されません。保持する場合は空欄のままにしてください
Station IDs端末ごとに1つ、1行に1つ入力します。重複は削除されます
Vendor ID認証時にWindcaveと取り決めます。それまでは空欄にしてください
POS名Windcave側で使われるPOSの名前です。既定値はWCPOSです
結果通知(FPRN)レジ側の確認を補うため、結果が確定した際にWindcaveからも店舗へ通知します。既定ではオフです

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

設定ページの下部には、サポートバンドル、認証情報の状態、ログへのリンクがあります。

まだ設定されていない店舗のWindcave Terminal設定ページ下部にあるWP Admin画面:Download support bundleボタン付きのSupport bundle、uat: HIT credentials missingの表示、View logs
  1. Credentials line — この未設定の店舗ではHIT credentials missing.と表示されます。設定済みの場合はHIT credentials configured (not verified).と表示されます。
  2. View logs — WooCommerce > Status > ログを開きます。ソースはwindcave-terminalです。
  3. Download support bundle — WCPOSサポートに送るファイルです。

ログにはWindcaveへの各リクエストと応答が記録されます。HITキーとカード番号はマスキングされます。

決済に問題が起きた場合は、Download support bundleをクリックしてファイルをorder numberとともにWCPOSサポートへ送ってください。このボタンはWCPOS Proで追加されます。バンドルにはサイト上のすべてのPOS決済プロバイダーが含まれ、秘密情報とカード番号は削除されます。

対応していない機能​

  • Windcaveが連携を認証するまでの実決済。
  • チップ、追加料金、キャッシュアウト、またはオーソリ後に後から売上を確定する処理。
  • Paymentsタブで端末からの質問に回答すること。Legacyタブを使ってください。
  • 端末の自動検出。ステーションIDは1つずつ入力します。
  • 最初の決済前にHIT認証情報を確認すること。
開発者向けの仕組み

このゲートウェイはHTTPS経由でWindcaveのHIT(Host Initiated Transaction) を使用します。UATにはuat.windcave.com、本番環境にはsec.windcave.comを使います。各端末はStation IDで指定します。

決済では、レジの金額と、加盟店参照としてのOrder #および注文番号を含むPurchaseが送信されます。その後、WCPOS Proは完了まで状態を確認します。レジが再度要求した場合、拡張機能は別のPurchaseを開始せず、同じ取引参照を先に照会します。Windcaveに30秒以内に登録されないPurchaseは、未送信として扱われます。

Result notifications (FPRN) を有効にすると、各PurchaseでWindcaveに店舗のWCPOS決済Webhookを呼び出すよう要求します。Webhookはwp-json/wcpos/v2/payments/webhookで、provider=windcaveと取引参照を含みます。この呼び出しは通知にすぎず、その後、店舗がWindcaveに結果を直接問い合わせます。

払い戻しは、入力した金額について元のWindcave取引に照合するHIT matched Refundです。店舗は最大20秒間、2秒ごとに状態を確認します。