概要
VibeFox Midtrans Payment Gateway は、インドネシアルピア（IDR）による Midtrans Snap 決済を PrestaShop に追加します。決済ステップで購入者は Midtrans を選び、Midtrans Snap の決済ページに移動して、Midtrans アカウントで有効になっている任意の方法で支払えます。GoPay、QRIS、ShopeePay、カード、銀行の仮想口座、コンビニ決済などです。注文は Midtrans が支払いを確認した後にのみ作成されるため、支払いを途中で止めても未払いの注文は残りません。
IDR で販売し、Midtrans のすべての決済方法を 1 つの決済方法にまとめたいインドネシアのショップに適しています。本モジュールは IDR のみに対応し、通貨換算は行いません。Snap ポップアップ、サイト上のカードフォーム、保存済みカード、分割払いやプロモーションの設定、サブスクリプションには対応しておらず、オーソリとキャプチャを分けることもできません。
主な機能
Snap Redirect: Midtrans アカウントのすべての決済方法を表示する 1 つの Midtrans 決済ページ。カート合計を整数のルピア単位で、注文明細、配送料、割引、税金を含めて処理します。
Midtrans が確認した後にのみ支払い済みとする: 各支払い通知の署名を検証し、ステータスを Midtrans のステータス API から再取得したうえで、支払われた金額と通貨をカートと照合します。一致しない場合、注文は備考付きで Midtrans payment on hold になります。
後払い決済: 仮想口座とコンビニ決済では、Awaiting Midtrans payment の注文が作成されます。Midtrans から支払いが報告されると支払い済みになり、支払い期限が切れるとキャンセルされます。
安全な再試行: 同じ金額で未使用または保留中の Snap があれば再利用します。通知の重複や購入者のストアへの戻りによって、注文が二重に作成されたり支払いが二重に記録されたりすることはありません。支払い済み注文への二度目の支払いは、備考で報告されます。
Sandbox と Production: Server Key は環境ごとに別々です。各支払いは自身の環境を記録するため、本番稼働後もサンドボックス支払いの返金と通知は引き続き機能します。
双方向の返金: 注文の Midtrans payment ブロックから、整数のルピア単位で全額返金と一部返金ができます。Midtrans ダッシュボードで行った返金は、自動的に注文に記録されます。
お好みの注文ステータス: 支払いが確認された後は、Payment accepted、Delivered、Midtrans payment on hold から選べます。注文番号の接頭辞を使えば、複数のショップで 1 つの Midtrans アカウントを共有できます。
注文ページの Midtrans ブロック: Midtrans ダッシュボードへのリンク付きの取引、支払い方法、返金履歴、備考を表示します。キーや購入者データを含まない任意のログ機能があります。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。ショップに IDR 通貨があること。サンドボックスと本番の Server Key を持ち、Midtrans ダッシュボードで支払い通知 URL を設定済みの Midtrans アカウント。vibefox.net で取得した VibeFox ライセンスキー（ドメインごとに 1 つ）。