概要
VibeFox ECPay Payment Gateway は、台湾の決済サービスである ECPay（綠界）を PrestaShop に追加します。支払い手続きの段階で購入者は ECPay を選択し、ECPay がホストする決済ページに移動して、クレジットカード、ATM 仮想口座、コンビニ払込番号またはコンビニバーコードで支払います。カード情報がショップのサイトに届くことはありません。注文は、ECPay が署名付きの通知によって支払いを確認した後にのみ作成されるため、途中で放棄された決済によって未払いの注文が残ることはありません。
新台湾ドル（TWD）で販売する台湾のショップに適しています。本モジュールは一回限りの決済のみに対応しています。PrestaShop からの返金には対応していません（返金は ECPay の管理画面で行います）。保存済みカード、定期購入や継続課金、分割払い、Apple Pay、電子インボイス、物流にも対応していません。
主な機能
4 種類の ECPay 決済方法: クレジットカード、ATM 仮想口座、CVS コード（コンビニ）、バーコード。複数の方法を有効にすると、購入者はチェックアウト時に 1 つを選択できます。
ECPay が確認した場合のみ支払済みにします: 注文が作成されるのは、このショップが発行した取引番号に対して有効な CheckMacValue 署名を持つ ECPay サーバー通知が届き、支払われた金額がカートと一致した場合だけです。購入者がサイトに戻っただけでは、注文が作成されることはありません。
オフライン決済方法の支払い案内: ATM、CVS、バーコードの場合、注文は Awaiting ECPay payment のまま待機し、口座番号、コードまたはバーコードと支払期限が注文確認ページと購入者の注文詳細に表示されます。
安全な再試行: 決済を試行するたびに新しい ECPay 取引番号が発行されるため、決済に失敗したりキャンセルしたりした後の再試行が機能します。支払済みの注文に対する 2 回目の決済は、返金対象として記録されます。
予期しない動作がありません: 重複した通知は無視され、ECPay の管理画面からのシミュレーション決済は注文を作成することはなく、金額の不一致、本番切り替え後のサンドボックス決済、キャンセル済み注文の決済は ECPay payment on hold に移されます。
アカウントなしでテストできます: テストモードでは ECPay の公開サンドボックス加盟店を使用するため、ECPay のキーを取得する前にテストできます。
注文ページの ECPay ブロック: 決済の試行を、ECPay の取引番号、ステータス、注文の ECPay メモとともに表示します。キーや購入者データを含まない任意のログ。エラーは常に記録されます。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。ショップに TWD 通貨があること。実際の決済には ECPay の加盟店アカウント（MerchantID、HashKey、HashIV）が必要です。インターネットからポート 80/443 でアクセスできるショップ。vibefox.net で取得する VibeFox ライセンスキー（1 つのキーは 1 つのドメインで使用可能）。