概要
VibeFox Eupago Gateway は、ポルトガル向けの Eupago 決済を PrestaShop に追加します。チェックアウトでは、Multibanco、MB WAY、クレジットカードの中から 1 つの決済方法を選びます。Multibanco の場合、購入者は ATM またはホームバンキングで支払うためのエンティティ（entity）と参照番号を受け取ります。MB WAY の場合、購入者は MB WAY アプリで支払いリクエストを承認します。クレジットカードの場合、購入者は Eupago のカード決済ページで支払い、ショップに戻ります。
ユーロで販売し、Eupago アカウントを持つショップに適しています。本モジュールは、1 つのインストールにつき Eupago の決済方法を 1 つだけ提供し、単発決済のみに対応します。PrestaShop からの返金（Eupago バックオフィスで返金）、保存済みカード、サブスクリプション、事前承認には対応していません。また、PayShop、Cofidis Pay、Bizum などのほかの Eupago 決済方法、SMS リマインダー、Multibanco の有効期限、ステータスのポーリングにも対応していません。
主な機能
Multibanco、MB WAY、カード: Multibanco の参照番号は、注文確認ページと注文確認メールに表示されます。チェックアウトで MB WAY の電話番号を入力します。ポルトガルの番号は +351 を省略して入力できます。
Eupago が確認した場合のみ支払い済みに: 注文が支払い済みになるのは、検証済みの Eupago 通知を受けた場合だけです。署名付きの Webhook 2.0、または API キーで認証された従来のコールバックが該当します。カード決済の場合、注文は Eupago が支払いを確認した後にのみ作成されます。
厳格なチェック: 金額（1 セント単位まで）と通貨が注文と一致し、支払い参照番号がそのカート用に作成されたものであり、通知が同じ環境（サンドボックスまたは本番）から届いている必要があります。いずれかを満たさない場合、注文は Eupago payment on hold になり、備考が付きます。
二重処理なし: 同じ通知が繰り返し届いても 1 回だけ適用されるため、注文、備考、ステータスメールが重複することはありません。キャンセル済みの注文への遅れた支払いは失われず、確認のため保留になります。
サンドボックスと本番: モードごとに API キーと Webhook キーを分けて設定します。モードを切り替えると、キーと Eupago のホストも切り替わります。
選べる注文ステータス: 支払い後に Payment accepted または Delivered へ変更します。ステータス変更は 1 回だけです。
注文ページの Eupago ブロック: 決済方法、参照番号またはマスクされた電話番号、Eupago のトランザクション ID とステータス、モジュールの備考を含む支払い試行の履歴を表示します。キー、メール、電話番号全体を含まないログを任意で記録できます。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。チャネルの API キーと Webhook 2.0 キーを持つ Eupago アカウント（サンドボックスと本番は別々のアカウントです）。カートの通貨は EUR。vibefox.net で購入する VibeFox ライセンスキー（1 つのキーは 1 つのドメインで使用可能）。