概要
VibeFox Hubtel Pay Gateway は、ガーナでの Hubtel 決済を OpenCart 3 および OpenCart 4 に追加します。購入者は最後のチェックアウトステップで Confirm Order をクリックし、安全な Hubtel Online Checkout のページに移動します。そこで MTN MoMo、Telecel Cash、AirtelTigo Money、Visa または Mastercard のカード、もしくは GhQR で支払い、貴店に戻ります。OpenCart は決済の前に注文を作成しますが、注文が状態を受け取るのは Hubtel が支払いを確認した後だけです。そのため、未払いの試行は欠落した注文のままになります。
ガーナセディ（GHS）で販売し、Hubtel のビジネスアカウントを持つガーナの店舗に適しています。貴店の Web サーバーの IP アドレスを、Hubtel の Transaction Status API のホワイトリストに登録してもらう必要があります。Hubtel には公開のテスト環境がないため、すべての支払いは実際の取引になります。本拡張機能には、OpenCart からの返金、定期購読、保存済みカード、店舗内での決済チャネルの選択はありません。
主な機能
Hubtel のホスト型チェックアウト：Hubtel のページでモバイルマネーとカード決済を行います。購入者はそこで決済チャネルを選びます。
Hubtel が確認した場合にのみ支払い済み：Hubtel のコールバックは署名されていないため、本拡張機能はそれを信頼しません。認証済みの Hubtel Transaction Status API に問い合わせ、Hubtel が GHS 建ての注文総額について Paid と報告した場合にのみ、注文を支払い済みにします。その後 OpenCart は通常の注文メールを送信します。
金額の確認：金額が異なる場合、注文は選択した審査ステータスに移行し、メモが追加されます。
Hubtel 側での設定は不要：コールバック URL は支払いごとに送信されます。
失われたコールバックへの対応：購入者の戻り時に支払いを確認し、cron URL がバックグラウンドで再確認を行い、注文ページの Check Hubtel payment status をクリックすることもできます。
二重処理の防止：支払いの試行ごとに個別の参照番号があります。繰り返されたコールバックによって同じ支払いが二重に適用されることや、キャンセルされた注文が再び開かれることはありません。新しい試行の前に、同じカートの以前の未確認の試行が Hubtel に照会され、すでに支払い済みの注文に対する二重の支払いは返金対象としてフラグが立てられます。
注文ページの Hubtel タブ：注文のすべての支払い試行を、Hubtel のステータスとトランザクションとともに表示し、Hubtel のメモも表示します。
OpenCart の条件：ジオゾーン、最低注文金額、並び順、独自の注文ステータス。API キーや購入者のデータを含まない任意のログ。
動作環境
OpenCart 3.0.x（3.0.5.0 で動作確認済み）または OpenCart 4.0.2 以降（4.1.0.3 で動作確認済み）、cURL 拡張を備えた PHP 8.0 以降。1 つのダウンロードに両方のバージョン用のパッケージが含まれています。API ID、API Key、加盟店アカウント番号（POS Sales ID）を持つ Hubtel のビジネスアカウントと、Hubtel にホワイトリストへ登録された貴サーバーの IP アドレス。注文通貨はガーナセディ（GHS）。バックグラウンドチェック用にサーバーの cron を使用することを推奨します。vibefox.net で取得した VibeFox ライセンスキー（ドメインごとに 1 つ）。