概要
VibeFox Hubtel Pay Gateway は、ガーナにおける Hubtel による決済を PrestaShop に追加します。決済ステップで購入者が Hubtel を選択すると、安全な Hubtel Online Checkout ページに転送され、MTN MoMo、Telecel Cash、AirtelTigo Money、Visa または Mastercard カード、GhQR で支払いを行い、ショップに戻ります。注文は Hubtel が決済を確認した後にのみ作成されるため、支払いを途中で止めた場合に未払いの注文が残ることはありません。
ガーナ・セディ（GHS）で販売し、Hubtel ビジネスアカウントを保有するガーナのショップに適しています。Hubtel の Transaction Status API を利用するには、Web サーバーの IP アドレスを Hubtel 側でホワイトリストに登録してもらう必要があります。また Hubtel には公開テスト環境が存在しないため、すべての決済は本番取引となります。本モジュールは PrestaShop からの返金、定期購入、カードの保存、ショップ内での決済チャネルの選択には対応していません。
主な機能
Hubtel ホスト型決済ページ: Hubtel ページ上での Mobile Money およびカード決済。購入者はそこで決済チャネルを選択します。
Hubtel が確認した場合にのみ支払い済みとして処理: Hubtel のコールバックは署名されていないため、モジュールはコールバックを信用しません。認証済みの Hubtel Transaction Status API に照会し、GHS での正確なカート合計に対して Hubtel から "Paid" と報告された場合にのみ、注文を支払い済みとして作成します。
金額照合: 金額が異なる場合、ショップ管理者へのメモを添えて注文を Hubtel payment on hold にします。
Hubtel 側での設定は不要: コールバック URL はすべての決済とともに送信されます。
未着コールバックへの対応: 購入者がショップに戻った際に決済を確認し、cron URL によるバックグラウンド再確認も行われます。ショップ管理者は注文ページで Check Hubtel payment status をクリックすることもできます。
二重処理の防止: 各決済試行には固有のリファレンスが付与されます。重複したコールバックによって注文が二重に作成されたり、キャンセル済みまたは返金済みの注文が再開されたりすることはありません。支払い済みのカートに対する 2 回目の決済は、返金対象としてフラグが付けられます。
Hubtel 上でのキャンセル: 購入者はメッセージとともにチェックアウトに戻り、再度試行することができます。カートは保持されます。
注文ページの Hubtel ブロック: 注文のすべての決済試行について、Hubtel でのステータスとトランザクションを表示し、Hubtel のメモも表示します。API キーや購入者のデータを含まないログを任意で記録できます。
要件
PrestaShop 8.0 ～ 9.x、cURL 拡張を有効にした PHP 8.0 以降。API ID、API Key、加盟店アカウント番号（POS Sales ID）を持つ Hubtel ビジネスアカウント、および Hubtel によりホワイトリスト登録されたサーバー IP。ショップ通貨はガーナ・セディ（GHS）。バックグラウンド確認にはサーバーの cron を設定することを推奨します。vibefox.net の VibeFox ライセンスキー（1 ドメインにつき 1 キー）。