概要
VibeFox Windcave Payment Gateway は、Windcave REST API を使用して、Windcave Hosted Payment Page による決済を PrestaShop に追加します。支払い手続きでは、購入者が Windcave を選ぶと安全な Windcave のページに移動し、カードまたは Windcave アカウントで有効になっている別の方法で支払い、ストアに戻ります。カード情報が貴店のサイトを経由することはなく、注文は Windcave が決済を確認した後にのみ作成されます。
自店のサイトにカードフォームを置かずにカード決済を受け付けたい、Windcave の加盟店アカウントを持つストアに適しています。代金をすぐに請求することも、承認のみを行って後からキャプチャすることもできます。本モジュールには、サブスクリプションや定期決済、保存済みカード、サイト上への埋め込みカードフォームはありません。また、旧 PxPay 2.0 API には対応していません。
主な機能
Hosted Payment Page: カートの合計金額をカートの通貨で Windcave 決済セッションとして作成します。通貨ごとに正しい小数桁数が適用されます（例：NZD 25.50、JPY 3000、KWD 1.250）。
Windcave が確認した場合にのみ支払い済みになります: 購入者の戻りと Windcave からの通知は、いずれも Windcave REST API を通じてサーバー側で確認されます。決済は一度だけ適用されます。
注文チェック: Windcave から報告された金額、通貨、加盟店参照番号、取引タイプをカートと照合します。不一致があった場合は、注文が備考付きで Windcave payment on hold になります。
Purchase または Auth: 代金をすぐに請求するか、今すぐ承認して後から注文のWindcaveブロックにある Capture Windcave payment でキャプチャします。
注文画面からの返金: 注文のWindcaveブロックで全額返金と一部返金ができます。返金額は Windcave が実際に承認した金額が上限です。キャプチャされていない承認に対する全額返金は、承認を解除します。
テストモード: Windcave UAT テスト環境を使用します。専用の認証情報は本番用の認証情報と並べて保存されます。返金とキャプチャは、注文が支払われた環境に対して常に行われます。
二重請求なし: 新しい決済の試行では、まず前回の決済を確認します。支払い済みの注文に対して2回目の承認済み決済があった場合は、注文を変更せず、注文メモに記録されます。
注文画面の Windcave ブロック:取引、カード、キャプチャ、返金、カートのセッション、メモを表示します。ログにはキー、カード情報、顧客情報は記録されません。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。UAT テスト環境および/または本番環境用の REST API 認証情報（ユーザー名と API キー）を持つ Windcave 加盟店アカウント。vibefox.net で入手した VibeFox ライセンスキー（ドメインごとに 1 つのキー）。