VibeFox OpenPay for OpenCart — ヘルプ

要件

OpenCart: 3.0.x（3.0.5.0 で動作確認済み）または 4.0.2 以降（4.1.0.3 で動作確認済み）。

PHP: 8.0 以降。

HTTPS: カードフォームはチェックアウトページに表示されるため、ストアで HTTPS を使用する必要があります。

OpenPay account: メキシコ、コロンビア、またはペルーの OpenPay アカウント。その Merchant ID、秘密キー（sk_...）、公開キー（pk_...）が必要です。サンドボックスと本番のダッシュボードでは Merchant ID とキーが異なり、拡張機能はそれらを分けて管理します。

Currency: お客様は、アカウントの国で受け付けている通貨で支払う必要があります。メキシコ — MXN または USD、コロンビア — COP または USD、ペルー — PEN または USD。その他の通貨の場合、チェックアウトでこの支払い方法は表示されません。

VibeFox license key: vibefox.net で購入します。1 つのキーは 1 つのドメインでのみ使用できます。

カード情報はチェックアウトページで入力されますが、読み取りとトークン化はブラウザー内で openpay.js が行います。カードフィールドには名前がなく、サーバーに送信されることもありません。カードフォームはご自身のページに表示されるため、PCI DSS の対象範囲は SAQ A-EP となります。詳細はアクワイアラーにご確認ください。

インストール

このダウンロードは、両方の OpenCart バージョン用のパッケージを含む 1 つの zip ファイルです。コンピューターで展開してください。中には README.txt、OpenCart 3 用パッケージ wcp_openpay_gateway-oc3-(version).ocmod.zip、OpenCart 4 用パッケージ wcp_openpay_gateway.ocmod.zip が含まれています。お使いの OpenCart のバージョンに対応するパッケージだけをインストールしてください。ライセンスキーは両方のバージョンで同じです。

OpenCart 3

1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル wcp_openpay_gateway-oc3-(version).ocmod.zip を選択します。この拡張機能には OCMOD の変更がないため、Extensions > Modifications を更新する必要はありません。インストーラーを使う代わりに、このパッケージの upload フォルダーの内容をストアのルートフォルダーにコピーすることもできます。

2. Extensions > Extensions に移動し、種類として Payments を選択します。VibeFox OpenPay Gateway を見つけて、Install（緑色の + ボタン）をクリックします。管理者ユーザーに、支払い拡張機能の一覧を変更する権限が必要です。

3. Edit（鉛筆のボタン）をクリックして設定ページを開きます。ページ上部のライセンスブロックにある License key に VibeFox のライセンスキーを貼り付け、Activate をクリックします（ライセンスキーを参照）。

4. Account country を選択し、サンドボックスと本番のキーを入力します（設定を参照）。

5. 推奨：OpenPay のダッシュボードでウェブフックの URL を追加します（設定を参照）。

6. Enable / Disable をオンにして Save をクリックします。OpenPay サンドボックスのテストカードで支払いをテストし、その後 Sandbox mode をオフにして実際の支払いを受け付けます。サンドボックスの注文をまだ返金する可能性がある間は、サンドボックスのキーを保管しておいてください。

OpenCart 4

1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル wcp_openpay_gateway.ocmod.zip を選択します。ファイル名は変更しないでください。OpenCart 4 はファイル名から拡張機能のコードを取得するため、名前を変更したパッケージは動作しません。

2. インストール済みの拡張機能の一覧が同じページに表示されます。その横の Install（緑色の + ボタン）をクリックします。

3. Extensions > Extensions に移動し、種類として Payments を選択します。VibeFox OpenPay Gateway を見つけて、Install（緑色の + ボタン）をクリックし、次に Edit（鉛筆のボタン）をクリックします。

4. OpenCart 3 の手順 3 から 6 と同様に、ライセンスキー、OpenPay のキー、ウェブフックを入力します。設定ページとそのフィールドは両方のバージョンで同じです。ウェブフックの URL のみ異なります（Webhook を参照）。

新規インストール時は、支払い方法がオフ、サンドボックスモードがオンの状態になっています。

設定

すべての設定は拡張機能のページにあります：Extensions > Extensions > Payments > VibeFox OpenPay Gateway > Edit。セクションは左側に一覧表示されており、一覧の下にある Save ボタンでページ全体を保存します。設定の上部では、現在のモードのキーが不完全な場合（この場合、支払い方法はチェックアウトで非表示になります）や、ストアの既定通貨が選択したアカウントの国で受け付けられていない場合に警告が表示されます。サンドボックスモードがオンの間は、Sandbox mode is enabled — no real charges are made. と表示されます。拡張機能を変更する権限がない場合、ページには設定が表示されますが、保存はできません。

保存時には、キーが検証されます。Merchant ID には英字と数字のみを使用できます。秘密キーは sk_ で、公開キーは pk_ で始まる必要があります。無効な値は保存されず、以前の値が保持されてエラーが表示されます（例：Sandbox: The private key must start with sk_.）。整数ではない Sort Order（Sort Order must be a whole number — the previous value was kept.）や、0 以上の数値ではない Total についても同様です。その他のフィールドは保存されます。支払い方法がオンでも現在のモードのキーが不完全な場合は、ゲートウェイがチェックアウトで非表示のままであることを示すメッセージも表示されます。Title が空である場合や 128 文字を超える場合は、Enter a title for the payment method (1 to 128 characters). と表示されて拒否され、何も保存されません。

OpenPay

Enable / Disable: Enable OpenPay card payments は、支払い方法のオン／オフを切り替えます。既定値：オフ。

Title: チェックアウトで顧客に表示される支払い方法の名前です。注文にも、この名前が支払い方法として保存されます。既定値：Credit or debit card (OpenPay)。必須、128 文字まで。

Description: Confirm Order ステップでカードフォームの上に表示されるテキストです。既定値：Pay securely with your credit or debit card. 銀行から支払いの確認を求められる場合があります（3D Secure）。

Sort Order: チェックアウトにおける支払い方法の中での OpenPay の表示順です。空欄のままにするか、整数を入力します（負の数も使用できます）。

Geo Zone: 選択したジオゾーン内の支払い先住所に対してのみ OpenPay を提供します。既定値：All zones。ジオゾーンは System > Localisation > Geo Zones で設定します。OpenCart 4 では、ストアが支払い先住所を求めない場合、配送先住所が使用されます。

Total: OpenPay を提供するために注文が達している必要がある、ストアの既定通貨でのチェックアウト金額です。空欄にすると、どの金額でも OpenPay を提供します。

OpenPay アカウント

Merchant ID、秘密キー（sk_）、公開キー（pk_）は、OpenPay のダッシュボードの Settings (Configuración) にあります。このセクションには、メキシコ、コロンビア、ペルーのサンドボックスと本番のダッシュボードへのリンクがあります。

Account country: OpenPay アカウントの国です。OpenPay API、その国の openpay.js ライブラリ、および受け付ける通貨が決まります。既定値：Mexico。

Sandbox mode: OpenPay のサンドボックス（テスト用キー、実際の請求は発生しません）を使用し、キーと API の両方をサンドボックスに切り替えます。オンの間は、チェックアウトに SANDBOX MODE のバッジが表示されます。既定値：オン。実際の支払いを受け付けるにはオフにします。

Sandbox Merchant ID: サンドボックスのダッシュボードの Settings (Configuración)、API キーにある Merchant ID です。

Sandbox Private Key: サンドボックスの秘密キーです。sk_ で始まります。サーバー側でのみ使用され、決して共有しないでください。

Sandbox Public Key: サンドボックスの公開キーです。pk_ で始まります。openpay.js がブラウザーでカードをトークン化するために使用します。

Live Merchant ID: 本番のダッシュボードの Settings (Configuración)、API キーにある Merchant ID です。

Live Private Key: 本番の秘密キー（sk_...）です。

Live Public Key: 本番の公開キー（pk_...）です。

保存済みの秘密キーは再表示されません。フィールドは空のままで、Saved — leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。保存済みの秘密キーを削除するには、フィールドの下にある Clear the saved key on save にチェックを入れてから、Save をクリックします。

Webhook

ウェブフックは必須ではありませんが、設定を推奨します。顧客が（ブラウザーを閉じた後などに）3D Secure ページから戻らなかった場合でも、支払いを確認できます。OpenPay のダッシュボードで Settings > Webhooks に移動し、このセクションの Webhook URL に表示される URL を追加します。OpenCart 3 の場合は https://your-store/index.php?route=extension/payment/wcp_openpay_gateway/webhook のような形式、OpenCart 4 の場合は https://your-store/index.php?route=extension/wcp_openpay_gateway/payment/wcp_openpay_gateway.webhook のような形式です。URL は OpenCart インストールのストアフロントのアドレスから作成されます。設定に表示されたとおりに、正確にコピーしてください。使用している各モード（サンドボックスと本番）のダッシュボードで、ウェブフックを追加してください。

ウェブフックを追加すると、OpenPay はこの URL に確認コードを送信します。コードは受信日とともにこのセクションに表示されるので、OpenPay のダッシュボードでウェブフックを確認できます。それまでは、このセクションに No verification code received yet. と表示されます。

この拡張機能は次のイベントを処理します：

OpenPay はウェブフックに署名しないため、この拡張機能は通知そのものを信頼することはありません。通知は請求を見つけるためだけに使用され、その後、支払いが行われたモードとアカウントの国の秘密キーを使って、OpenPay API から請求情報を読み取ります。このストアで作成されていない請求に関する通知は無視されます。ストアがメンテナンスモードであっても、ウェブフックは機能します。OpenCart 3 では OpenCart が支払い拡張機能へのリクエストを通し、OpenCart 4 では拡張機能が、ウェブフックと顧客の 3D Secure からの戻りを通す起動アクションを追加します。

注文

OpenCart は Confirm Order ステップで、ステータスのない注文（欠落注文）を作成します。注文にステータスが付くのは、OpenPay が請求を確認した後のみです。カードが拒否された場合や 3D Secure の確認に失敗した場合、注文はステータスなしのままになり、メモに理由が記録され、顧客は再度支払うことができます。以下の各フィールドには、OpenCart の注文ステータスが一覧表示されます。独自のステータスは System > Localisation > Order Statuses で作成できます。

Order Status After Payment: OpenPay が請求を確認し、その金額と通貨が注文と一致しています。既定値：Processing。

Awaiting OpenPay Payment: 請求は処理中です（まだ売上確定されていません）。ウェブフックが後で完了させるか、失敗させます。既定値：Pending。

OpenPay Payment On Hold: OpenPay が注文と異なる金額または通貨で請求したか、注文がキャンセルされた後に請求が完了しました。既定値：Pending。

Payment Error Status: OpenPay の確認待ちの注文、または保留中の注文の請求が失敗、キャンセル、または期限切れになりました。既定値：Failed。

Refunded Status: 注文ページから請求が全額返金されました。一部返金の場合はメモが追加されるだけです。既定値：Refunded。

詳細設定

Debug log: 支払いの各ステップを、OpenCart のログフォルダー（storage/logs）内の wc_opy_debug.log.php に記録します。このファイルは Web から開くことはできず、5 MB に達すると wc_opy_debug.old.log.php に移動されます。オフの場合でも、エラーと警告は記録されます。キー、カード情報、顧客の詳細は決して記録されません。既定値：オフ。

Log: ログのサイズと最新のエントリーを表示します。Clear log をクリックすると、ログを空にできます。

Delete data on uninstall: オンの場合、拡張機能をアンインストールすると、ゲートウェイの設定、保存されているウェブフックの確認コード、ログが削除されます。注文の OpenPay 請求記録は支払い履歴の一部であり、常に保持されるため、再インストール後も注文を返金できます。既定値：オフ。

インポート / エクスポート

Export: Download JSON で、設定を JSON ファイルとして保存します。秘密キーはエクスポートされません。

Import: 以前にエクスポートした JSON を貼り付け、Import をクリックして設定を復元します。保存済みの秘密キーは保持されます。

チェックアウト

Payment Method ステップで、顧客は支払い方法を選択します（既定では Credit or debit card (OpenPay)）。Confirm Order ステップでは、顧客に、あなたの説明文とカードフォームが表示されます：Cardholder name、Card number、Expiry (MM/YY)、Card code (CVV)。サンドボックスモードでは、フォームに SANDBOX MODE — Test environment. No real charges will be made. と表示されます。OpenCart は、このステップでまだステータスのない注文を作成します。OpenCart 4 では、顧客は支払い方法ブロックの Choose ボタンを使い、Payment method options ウィンドウで支払い方法を選択します。カードフォームは、チェックアウトページ下部の確認セクションにあり、Confirm Order の上に表示されます。顧客が Confirm Order をクリックすると、openpay.js がブラウザー内でカードを使い捨てのトークンに変換し、不正検知ライブラリがデバイスセッション ID を追加します。ストアに送信されるのは、これら 2 つの値のみです。カードフォームの入力が不完全な場合は、フォームの下に Please fill in all card fields. と表示されます。

その後、拡張機能は注文金額を注文通貨で、3D Secure 付きの請求として作成し、顧客を OpenPay が提供する顧客の銀行の 3D Secure ページに移動させます。各試行には、それぞれ固有の OpenPay 注文参照番号が割り当てられます。請求の説明は Order #、注文番号、ストア名です。支払い先住所にある顧客の名前、メールアドレス、電話番号は OpenPay に渡されます。OpenPay に顧客アカウントは作成されません。

顧客が戻ると、拡張機能は OpenPay API から請求を読み取ります。OpenPay が確認した後にのみ、注文は支払い済みとしてマークされます。請求がこの注文に属しており、完了しており、注文金額および通貨と正確に一致している必要があります。その後、注文は OpenCart の標準的な方法でステータスを取得し、通常の注文メールが送信され、在庫が更新されます。顧客には、OpenCart の注文完了ページに Your card payment has been received. と表示されます。OpenPay が請求は処理中であると報告した場合、注文には Awaiting OpenPay Payment のステータスが付与され、ページには We are confirming your card payment with OpenPay. The order will be updated automatically — please do not pay again. と表示されます。結果がまだ判明していない場合は、Payment confirmation ページに同じ文言が表示され、Check again ボタンと Back to checkout ボタンが表示されます。ウェブフックが届き次第、注文ステータスが設定されます。処理中の請求がその後失敗した場合、完了ページには Your OpenPay card payment was not completed. Please contact us about this order. と表示されます。

カードが拒否された場合、または 3D Secure が失敗した場合、注文はステータスなしのままになり、メモが追加されます。顧客は The card payment was not completed (declined or 3-D Secure failed). Please try again or use another card. と表示されたチェックアウトに戻ります。カートは保持されます。OpenCart 4 では、このメッセージはチェックアウトページの上部に表示されます。OpenCart 3 では、Confirm Order ステップが表示されるたびに新しい注文が作成されます。OpenCart 4 はチェックアウトで 1 つの注文を保持して更新するため、顧客は新しい試行で同じ注文を再度支払います。新しい試行の前に、拡張機能はカートの以前の請求を確認します。実際に支払い済みであれば、その注文は 2 回目の請求なしでステータスが付与されます。まだ処理中であれば、顧客には A previous payment for this order is still being processed. Please do not pay again — the order will be updated automatically. と表示されます。状態を確認できない場合は、新たな請求は行われず、顧客には We could not confirm the status of your previous payment attempt. Please try again in a few minutes. と表示されます。支払い済みのカートが再度請求されることは決してありません。

OpenCart 4 は、成功ページが表示されるまで注文をチェックアウトに保持します。その間に注文が閉じられた場合（例：支払い待ちの後で請求が失敗した、またはキャンセルや返金された場合）、顧客は This order can no longer be paid. Please reload the checkout page and confirm the order again. と表示されたチェックアウトに戻され、次の Confirm Order で新しい注文が支払われます。その注文にすでにステータスが付いており、カートに別の商品や数量が含まれている場合も、顧客はチェックアウトに戻され、新しいカートには新しい注文が作成されます。

拒否されたカードには、明確なメッセージが表示されます。例：The card has insufficient funds. Please use another card.、The card has expired. Please use another card.、The security code (CVV) is not valid. Please check it and try again. OpenPay の技術的なエラーが顧客に表示されることはありません。それらはログと注文メモに記録されます。

支払い方法がオフの場合、現在のモードのキーが不完全な場合、または顧客がアカウントの国で受け付けられていない通貨で支払おうとした場合は、チェックアウトで支払い方法が非表示になります。

この拡張機能はカード支払いのみを受け付け、即時に請求します。保存済みカード、サブスクリプション、無利息分割払い（MSI）または分割払い、カードポイントによる支払い、現金、SPEI、PSE、CoDi による支払いには対応しておらず、個別の承認と売上確定も行えません。

注文と返金

注文ステータス

No status (missing order): 顧客は 3D Secure ページにいるか、支払いを完了していないか、カードが拒否されています。Sales > Orders では、Order Status フィルターを Missing Orders に設定した場合にのみ、このような注文が表示されます。

OpenCart 4 では、チェックアウトの未払い注文に Voided ステータスが付くことがあります。これは、顧客が Confirm Order ステップに戻ったときに OpenCart 4 が設定するものです。拡張機能はこのような注文をステータスのない注文として扱い、その後の支払いでも注文を確認します。

Order Status After Payment (default Processing): 支払いが確認されました。メモには、OpenPay の請求 ID とモード（本番またはサンドボックス）が表示されます。

Awaiting OpenPay Payment (default Pending): OpenPay は請求が処理中であると報告しています（まだ売上確定されていません）。請求が完了すると注文は Order Status After Payment に移動し、失敗した場合は Payment Error Status に移動します。

OpenPay Payment On Hold (default Pending): OpenPay が、注文と異なる金額または通貨で完了した請求を報告しています（注文は支払い済みとしてマークされず、メモに差額が表示されます）。または、すでにキャンセルまたは返金された注文に対して支払いが届きました。注文を確認して処理するか、支払いを返金してください。

Payment Error Status (default Failed): 処理中の請求が失敗、キャンセル、または期限切れになりました。

Refunded Status (default Refunded): 請求は拡張機能を通じて全額返金されました。

すでに支払い済みの注文またはカードに対して 2 件目の請求完了が届いた場合、注文は変更されません。支払い済みの注文に OpenPay WARNING で始まるメモが表示され、OpenPay のダッシュボードで重複分を返金するよう促されます。

メモは、注文の History に記録される、顧客からは見えない項目です。

VibeFox OpenPay Gateway タブ

Sales > Orders で、OpenPay で支払われた注文を開きます。注文ページの下部、History と Additional の隣にある VibeFox OpenPay Gateway タブには、請求 ID、請求ステータス、環境、アカウントの国（サンドボックスの支払いには Sandbox ラベル付き）、Charged / order の金額、返金済み金額、返金フォーム、返金履歴、注文の OpenPay notes が表示されます。このタブは、拡張機能へのアクセス権があるユーザーに表示されます。

返金

メキシコとペルーのアカウントの場合：タブで Amount を入力します（まだ返金されていない金額が自動入力されます）。必要に応じて Reason (optional) を入力し、Refund via OpenPay をクリックします。確認の質問 Refund this amount through OpenPay? This cannot be undone. に同意してください。全額返金と一部返金に対応しており、OpenPay が請求した金額までが対象です。拡張機能を変更する権限が必要です（System > Users > User Groups で設定）。返金は、請求が行われたモードとアカウントの国のキーを使って送信されるため、そのモードのキーが設定されている必要があります。OpenPay が返金を受け付けない場合、タブにはエラー（例：OpenPay refund failed: ...）が表示され、返金は記録されません。返金が成功すると、OpenPay の返金 ID とともに返金履歴とメモに追加されます。全額返金の場合、注文は顧客に通知されず、商品も在庫に戻されずに Refunded Status に設定されます。これは手動でのステータス変更と同じです。一部返金ではステータスは変更されません。返金は OpenPay が支払いを確認した後に利用できます。金額の不一致により保留された注文は、拡張機能を通じて返金できません。

OpenPay コロンビアは、公式の OpenPay 連携と同様に、API経由のカード返金に対応していません。コロンビアの請求では、タブに返金フォームは表示されず、その理由が説明されます。OpenPay のダッシュボードで請求を返金してください。

Sales > Returns での商品返品では、OpenPay を通じて返金は行われません。

OpenPay のダッシュボードで行った返金やチャージバックは、ウェブフックで届き、メモに一度だけ追加されます。注文ステータスは自動的には変更されません。必要に応じて手動で更新してください。

ライセンスキー

この拡張機能は、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox OpenPay Gateway は、Extensions > Extensions > Payments > VibeFox OpenPay Gateway > Edit の最初のブロックで、設定の上にあります。キーを License key に貼り付け、Activate をクリックします。その後、ブロックにはキーがマスクされた状態で表示され、ステータス（ライセンスの有効期限の日付やドメインなど）と、ボタン類が表示されます。ボタンは、ステータスを再確認する Check now、別のキーを入力する Change key、このストアからキーを削除する Remove key です。その下には、Product: opencart-payment-openpay という行と、アカウントを開くリンク Manage licenses and domains in your account があります。キーを変更できるのは、この拡張機能に対する Modify 権限を持つ管理者ユーザーのみです。ブロックの文言は管理画面の言語に従います（英語とロシア語が含まれています）。

キーが受け付けられない場合、ブロックに理由が表示されます。例：Key not found、This key belongs to another product、Domain limit reached、または日付付きの License expired on。ストアのアドレスを変更した後、またはアカウントでドメインの枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、拡張機能は最後に確認されたステータスで動作を続けます。

1 つのキーは 1 つのドメインでのみ使用できます。そのドメインは、OpenCart の設定にあるストアのアドレスです。ストアからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。

有効なキーがない場合、OpenPay はチェックアウトで顧客に表示されません。それでも支払いが開始された場合、顧客には This payment method is not available. Please choose another one. と表示されます。同じブラウザーで管理画面にログインしている管理者ユーザーには、支払い方法がストアに表示され、(unlicensed — visible to admins only) と表示されます。これにより、キーを購入する前に拡張機能を設定してテストできます。OpenCart 4 では、このプレビューは利用できません。ストアは管理画面へのログインを認識しないため、有効なキーがない場合、支払い方法はすべてのユーザーに対して非表示になります。Edit ページを一度開くと、管理画面の Dashboard にリマインダーが表示されます。× をクリックすると、7 日間非表示にできます。既存の注文には影響しません。すでに開始された支払いは引き続き確認され、返金も機能します。

ライセンスの期限が切れた場合も、拡張機能は動作を続けますが、アップデートとサポートには更新が必要です。ステータスは、管理画面の Dashboard または Edit ページを開いたときに自動的に再確認されます。キーを入力してから最初の 14 日間は 1 日に 1 回、その後は週に 1 回です。cron ジョブは不要です。拡張機能をアンインストールすると、ライセンスキーとライセンスステータスは常に削除されます。

トラブルシューティング

OpenPay がチェックアウトに表示されない：ライセンスが有効であること、Enable / Disable がオンであること、現在のモードに 3 つのキーすべてがあることを確認してください。サンドボックスモードではサンドボックスのキー、ライブモードでは本番のキーです。顧客が Account country で受け付けられている通貨で支払うことを確認してください（メキシコ：MXN、USD。コロンビア：COP、USD。ペルー：PEN、USD）。設定ページには、各ケースに対して警告が表示されます。また、支払い先住所が選択した Geo Zone に含まれていること、注文が設定された Total に達していることも確認してください。

支払いは完了したが、注文がステータスなしのまま：顧客が 3D Secure ページから戻らず、ウェブフックが機能していません。使用しているモードの OpenPay ダッシュボードに、設定に表示されたとおりの正確な Webhook URL が、上記のイベントとともに追加されていることを確認してください。支払いが行われたモードのキーが入力されていることを確認してください。キーがない場合、ウェブフックは not configured と応答し、OpenPay は後で再試行します。顧客がストアに戻った場合、または同じカートを再度支払おうとした場合にも、注文にはステータスが付与されます。

ウェブフックが ignored (unknown order) と応答する：請求はこのストアで作成されたものではありません。例えば、同じ OpenPay アカウント上の別のストアの請求です。何も変更されません。

ウェブフックが verification failed と応答する：請求を読み取るための OpenPay API に接続できませんでした。OpenPay はウェブフックを再試行します。

ウェブフックが busy と応答する：カートが同時に別のリクエストによって更新されていたか、注文ステータスを設定できませんでした。OpenPay はウェブフックを再試行します。理由を確認するには Debug log をオンにしてください。

ブラウザーでウェブフックの URL に invalid body と表示される：これは正常です。この URL は OpenPay からの通知のみを受け付けます。

顧客に The secure card form could not be loaded と表示される：OpenPay の openpay.js または不正検知ライブラリがブラウザーで読み込まれなかったか、デバイスセッション ID を作成できませんでした。顧客にページを再読み込みしてもう一度試すよう依頼してください。

顧客に The payment could not be processed right now と表示される：OpenPay がリクエストを拒否したか、応答しませんでした。理由はログと注文メモに記録されています。Merchant ID または秘密キーの誤りが典型的な原因です。OpenPay から応答がなかった場合は、顧客が再度支払う前に、OpenPay のダッシュボードで請求を確認してください。

顧客に This test card cannot be used for real payments と表示される：サンドボックスモードがオフの間に、サンドボックスのテストカードが使用されました。

顧客に Billing email is required for OpenPay と表示される：注文に有効なメールアドレスがありません。

支払い後、注文が OpenPay Payment On Hold ステータスになっている：タブの OpenPay notes を確認し（注文ステータスを参照）、注文を処理するか、支払いを返金してください。

モードに関するメッセージで返金に失敗する：注文はサンドボックスモードまたはライブモードで支払われており、そのモードのキーが設定されていません。キーを入力してから、もう一度試してください。

The order is being updated right now で返金に失敗する：ウェブフックまたは別のリクエストが、同時に注文を更新していました。しばらくしてから再試行してください。

アンインストール

Extensions > Extensions に移動し、種類として Payments を選択して、VibeFox OpenPay Gateway の横にある Uninstall（赤色の − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは、常に削除されます。OpenCart は、拡張機能自身の設定を常に削除します：Enable / Disable、Sort Order、Geo Zone、Total、および Orders セクションの注文ステータス（再インストール時に既定値に戻ります）。拡張機能の OpenCart イベントも削除されます（OpenCart 4 では、イベントとメンテナンスモード中にウェブフックと 3D Secure からの戻りを通す起動アクションも削除されます）。Delete data on uninstall がオンの場合は、その他のゲートウェイ設定（タイトル、説明、アカウントの国、サンドボックスモード、キー、ログ記録）、保存されているウェブフックの確認コード、およびログも削除されます。オフの場合は、後で再インストールするために保持されます。OpenPay の請求と返金の記録は常に保持されるため、以前に支払われた注文は再インストール後も返金できます。既存の注文は支払いメモを保持します。

OpenCart 4 では、拡張機能のファイルも削除するには、アンインストール後に Extensions > Installer に移動し、インストール済みの拡張機能の一覧で VibeFox OpenPay Gateway の横にある Uninstall（オレンジ色の − ボタン）をクリックします。その後、アップロードしたパッケージを削除するために Delete（赤いゴミ箱のボタン）をクリックします。

OpenPay は、それぞれの所有者の商標です。この拡張機能は、OpenPay とは提携しておらず、OpenPay による承認も受けていません。