概要
VibeFox Tap Payments は、Tap Payments による決済を OpenCart 3 と OpenCart 4 に追加します。Visa、Mastercard、Amex、mada、KNET、Benefit、Apple Pay、Google Pay に対応しています。最後のチェックアウトの手順で、購入者は Confirm Order をクリックし、Tap の安全な決済ページ、またはストアの決済ページにある Tap のチェックアウトポップアップで支払いを行います。カード情報がストアのサーバーを経由することはありません。OpenCart は決済の前に注文を作成しますが、注文にステータスが設定されるのは Tap が決済を確認した後です。そのため、未払いの試行は欠落した注文として残ります。
クウェート、サウジアラビア、アラブ首長国連邦、バーレーン、カタール、オマーンなど、Tap が利用できる市場のストアで、Tap アカウントを使って国内外の決済手段を受け付けたい場合に適しています。この拡張機能は単発の決済に対応しています。保存済みカード、サブスクリプション、チェックアウトページに組み込まれたカード入力欄はなく、部分的なキャプチャにも対応していません。
主な機能
2 つのチェックアウト方式: Tap の決済ページ（リダイレクト、推奨）、または拡張機能の決済ページで開く Tap のチェックアウトポップアップのいずれかです。Tap の決済ページは代替方式として利用できます。
Tap が確認した場合にのみ支払い済みとなります: 拡張機能は Tap API から決済情報を取得し、その決済が注文に属しているかを確認したうえで、注文にステータスを設定する前に金額と通貨を注文と照合します。その後、OpenCart は通常の注文メールを送信します。
署名付きのウェブフック、設定は不要: ウェブフックの URL は、すべての決済とともに送信されます。有効な署名のない通知は拒否されます。
正しい金額: KWD、BHD、OMR、JOD は小数点以下 3 桁で、SAR、AED、QAR、EUR、USD などのその他の通貨は小数点以下 2 桁で送信されます。
売上の確定または承認のみ: 承認された決済は、注文のタブで Capture Tap payment を使って売上を確定するか、Void Tap authorization を使って資金を解放できます。
注文ページからの返金: 注文の VibeFox Tap Payments タブで、全額返金と一部返金ができます。返金額は Tap が請求した金額までに限られ、決済が行われたモード（テストまたは本番）のキーが常に使用されます。
安全なステータス処理: ウェブフックの重複送信や購入者の戻りによって同じ決済が二重に処理されることはなく、支払い済みのカートが再度請求されることもありません。金額が一致しない場合は確認用のステータスになり、重複または遅延した決済は注文にメモとして記録されます。
独自の注文ステータスと OpenCart の条件: 支払い済み、承認済み、確認中、取り消し、返金済みの各注文のステータスを選べるほか、ジオゾーン、最低注文金額、並び順も設定できます。Tap の決済ページは英語またはアラビア語で表示されます。任意で有効にできるデバッグログには、キーや顧客データは含まれません。
要件
OpenCart 3.0.x（3.0.5.0 で動作確認済み）または OpenCart 4.0.2 以降（4.1.0.3 で動作確認済み）、PHP 8.0 以降。1 つのダウンロードに両方のバージョン用のパッケージが含まれています。テスト用と本番用の API キーを持つ Tap アカウント（シークレットキー。公開可能キーはポップアップ用のみ必要）。注文の通貨は AED、BHD、EGP、EUR、GBP、JOD、KWD、OMR、QAR、SAR、USD のいずれか。vibefox.net で取得した VibeFox ライセンスキー（ドメインごとに 1 つ）。