概要
VibeFox Windcave Payment Gateway は、Windcave REST API を使って、Windcave Hosted Payment Page 経由の決済を OpenCart 3 と OpenCart 4 に追加する拡張機能です。購入者は最後のチェックアウト手順で Confirm Order をクリックすると、安全な Windcave のページに移動し、カードまたは Windcave アカウントで有効になっている別の方法で支払い、ストアに戻ります。カード情報がストアのサイトを経由することはありません。OpenCart は決済の前に注文を作成しますが、注文にステータスが付与されるのは Windcave が支払いを承認した後です。そのため、未払いの試行は未完了の注文として残ります。
この拡張機能は、Windcave の加盟店アカウントを持ち、自店のサイトにカードフォームを置かずにカード決済を受け付けたいストアに適しています。代金をすぐに請求するか、承認のみを行って後から売上を確定するかを選べます。定期購読や定期支払い、保存されたカード、サイトに埋め込まれたカードフォームには対応しておらず、旧式の PxPay 2.0 API でも動作しません。
主な機能
Hosted Payment Page: 注文通貨で注文合計に対応する Windcave の決済セッションが作成されます。各通貨の正しい小数桁数が適用されます（NZD 25.50、JPY 3000、KWD 1.250）。
Windcave が確認した場合にのみ支払い済み: 購入者の戻りと Windcave の通知はどちらも、Windcave REST API を通じてサーバー側で確認されます。支払いは正確に 1 回だけ適用され、1 つのカートは 1 回だけ支払われます。
注文の確認: Windcave が報告した金額、通貨、加盟店参照番号、取引の種類が注文と照合されます。不一致があった場合、注文は選択した確認用ステータスになり、メモが残されます。
Purchase または Auth: 代金をすぐに請求するか、今すぐ承認して後で注文タブの Capture Windcave payment で売上を確定します。
注文ページからの返金: 注文の VibeFox Windcave Payment Gateway タブから、Windcave が実際に承認した金額までの全額返金および一部返金ができます。売上未確定の承認に対して全額返金を行うと、その承認が解放されます。
テストモード: 独自の認証情報を持つ Windcave の UAT テスト環境です。本番の認証情報と並べて保存されます。返金と売上確定は、常に注文が支払われた環境で処理されます。
二重請求の防止: 新しい支払い試行の前に、以前の試行が確認されます。すでに支払い済みの注文に対して承認された 2 回目の支払いは、注文を変更せずにメモで報告されます。
OpenCart の設定: 注文ステータス、ジオゾーン、最低注文金額、並び順を独自に設定できます。ログにはキー、カード情報、購入者データは記録されません。
要件
OpenCart 3.0.x（3.0.5.0 で動作確認済み）または OpenCart 4.0.2 以降（4.1.0.3 で動作確認済み）、PHP 8.0 以降。1 つのダウンロードに両方のバージョン用のパッケージが含まれています。UAT テスト環境および/または本番環境の REST API 認証情報（ユーザー名と API キー）を持つ Windcave の加盟店アカウント。vibefox.net で取得した VibeFox ライセンスキー（ドメインごとに 1 つ）。