概要
VibeFox OpenPay Gateway は、メキシコ、コロンビア、ペルーの OpenPay アカウントを使い、OpenPay（BBVA）によるクレジットカードおよびデビットカード決済を OpenCart 3 に追加します。カードフォームは Confirm Order の手順で表示されますが、カードは openpay.js によってブラウザ内でトークン化されるため、カード番号と CVV がストアに届くことはありません。すべての決済は 3D Secure を経由します。OpenCart は決済前に注文を作成しますが、注文に状態が付くのは OpenPay が請求を確定した後です。
この拡張機能は、即時に請求される一回限りのカード決済を扱います。保存済みカード、定期購入、分割払い（MSI）やインストールメント、カードポイント決済、現金、SPEI、PSE、CoDi 決済には対応しておらず、オーソリとキャプチャを分けることもできません。
主な機能
3D Secure 対応のカードフォーム：Confirm Order の手順でカードフォームを表示します。openpay.js が OpenPay の不正検知によるデバイスチェックとともにカード情報をトークン化します。すべての請求は銀行のページで 3D Secure による認証を受けます。
OpenPay が確定した場合のみ支払い済み：顧客が 3D Secure から戻ったときと Webhook が届いたときに、OpenPay API から請求内容を読み直します。その後、OpenCart は通常どおり注文メールを送信します。
金額と通貨の確認：完了した請求は、注文の合計金額および通貨と完全に一致する必要があります。一致しない場合、注文は備考付きの確認状態になり、支払い済みにはなりません。
二重請求はしない：支払い済みのカートが再度請求されることはなく、新しい試行の前に、そのカートの前回の請求状況を確認します。
サンドボックスと本番：モードごとに、加盟店 ID、秘密鍵、公開鍵を個別に設定します。返金と Webhook は、請求が行われたモードとアカウント所在国のキーを常に使用します。
注文ページからの返金：メキシコとペルーでは、注文の VibeFox OpenPay Gateway タブから全額返金と一部返金を行えます（コロンビアは OpenPay ダッシュボードで実施）。ダッシュボードで行った返金やチャージバックは注文に記録されます。
分かりやすい顧客向けメッセージ：有効期限切れのカード、残高不足、CVV の誤り、3D Secure の失敗、その他の OpenPay エラーには短いメッセージが表示されます。技術的なエラーが顧客に表示されることはありません。
独自の注文状態と OpenCart の条件：支払い済み、保留中、確認中、失敗、返金済みの注文に使う状態を選択できます。ジオゾーン、最低合計金額、並び順も設定できます。キー、カードデータ、顧客データを含まないログを任意で有効にできます。
動作要件
OpenCart 3.0.x（3.0.5.0 で検証）または OpenCart 4.0.2 以降（4.1.0.3 で検証）、PHP 8.0 以降、HTTPS。1 つのダウンロードに両方のバージョン用のパッケージが含まれています。メキシコ、コロンビア、ペルーのいずれかの OpenPay アカウント（加盟店 ID、秘密鍵、公開鍵（サンドボックスと本番の両方）が必要）と、そのアカウントが受け付ける注文通貨。vibefox.net で入手した VibeFox ライセンスキー（ドメインごとに 1 つ）。