概要
VibeFox ePayco Payment は、ePayco のチェックアウトによる決済を PrestaShop に追加します。支払いの段階で購入者が ePayco を選ぶと、ePayco のチェックアウトがショップ上のポップアップとして開くか、ePayco の決済ページへのリダイレクトとして開きます。購入者はそこで、ePayco アカウントで有効になっている決済方法（カード、PSE 銀行振込、現金払いのネットワーク、ウォレット）を使って支払います。注文は ePayco が取引を確認した後にのみ作成されるため、途中で放棄された支払いが未払いの注文として残ることはありません。
コロンビアペソ（COP）または米ドル（USD）で販売し、ePayco アカウントを持つコロンビアのショップに適しています。本モジュールは 1 回限りの支払いのみに対応しています。ショップからの返金、保存済みカード、サブスクリプション、分割払いには対応しておらず、保留中の取引について ePayco に定期的な問い合わせは行いません。
主な機能
ePayco Checkout: カートの合計額について、カートの通貨でチェックアウトセッションが作成されます。税金、請求先の氏名、住所、メールアドレス、電話番号を含みます。ポップアップまたはリダイレクトで、ショップの言語に応じてスペイン語または英語で表示されます。
ePayco が確認した場合にのみ支払い済みに: 注文は、署名された ePayco の確認通知を受け取った後、または購入者がショップに戻った際にサーバー側で取引を確認した後に作成されます。有効な署名のない確認通知は拒否されます。
保留中の支払い: PSE 振込や現金払いは Awaiting ePayco payment で待機し、ePayco が承認すると支払い済みになります。
金額と通貨の確認: ePayco が承認した金額と通貨がカートと照合されます。一致しない場合、注文はメモ付きで ePayco payment on hold になります。
二重処理の防止: 繰り返される確認通知や購入者の戻りによって、2 件目の注文が作成されたり、支払いが 2 回記録されたりすることはありません。支払い済みの注文に対する 2 回目の承認済み支払いは、確認のためにフラグが立てられます。
テストモード: チェックアウトセッションはテスト取引として作成されます。テスト取引が本番モードで作成された注文を支払うことはありません。
注文ページの ePayco ブロック: ePayco 参照番号、状態、決済方法、承認コード、注文の ePayco メモを表示します。ePayco が報告した取消しは、注文を Refunded に設定します。
ログ: エラーは常に記録され、それ以外はログが有効な場合に記録されます。キーや購入者データは記録されません。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。カートの通貨は COP または USD。4 つのキー（P_CUST_ID_CLIENTE、P_KEY、PUBLIC_KEY、PRIVATE_KEY）を持つ ePayco アカウント。vibefox.net で取得した VibeFox ライセンスキー（ドメインごとに 1 つ）。