VibeFox Worldline for OpenCart — ヘルプ

要件

OpenCart: 3.0.x（3.0.5.0 で検証済み）または 4.0.2 以降（4.1.0.3 で検証済み）。

PHP: 8.0 以降。

Worldline アカウント: Worldline Direct（旧 Ingenico Direct）の加盟店アカウント。テストアカウントとライブアカウントは別々で、認証情報も異なります。各アカウントには、加盟店 ID（PSPID）、API Key ID とその Secret API Key、および Webhook キーとそのシークレットが必要です。これらはすべて Worldline Merchant Portal で作成します（「設定」を参照）。

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

インストール

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

OpenCart 3

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

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

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

4. テスト用の認証情報を入力し、Save をクリックしてから Test credentials をクリックします。

5. テストアカウントの Merchant Portal に Webhook URL を追加し、Webhook キーとシークレットを入力します（「設定」を参照）。

6. Enable/Disable をオンにして保存し、テストの決済を行います。その後、ライブ用の認証情報を入力し、本番アカウントで Webhook の設定を繰り返し、Live credentials をクリックして、Test Mode をオフにします。

OpenCart 4

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

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

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

4. OpenCart 3 の手順 3 から 6 と同じように、ライセンスキー、認証情報、Webhook を入力します。設定ページとそのフィールドは両方のバージョンで同じです。Webhook URL のみが異なります（Webhook を参照）。

新規インストール時は、決済方法がオフ、テストモードがオンの状態で始まります。

設定

すべての設定は拡張機能のページにあります：Extensions > Extensions > Payments > VibeFox Worldline Gateway > Edit。セクションは左側に一覧表示されます。一覧の下にある Save ボタンで、ページ全体を保存します。設定の上では、現在のモードの認証情報（加盟店 ID、API Key ID、Secret API Key）が不完全な場合に警告が表示されます。その場合、決済方法はチェックアウトで非表示になります。テストモードがオンの間は、Test mode is on (pre-production environment): no real money is charged. と表示されます。拡張機能を変更する権限がない場合、ページには設定が表示されますが、保存はできません。

保存時には、Title を空にできません（128 文字以内）。Sort Order は整数である必要があります（負の数も使用できます）。Total は 0 以上の数値である必要があります。また、ジオゾーンと注文ステータスが存在している必要があります。そうでない場合は何も保存されず、ページに該当するフィールドが表示されます。認証情報が不完全でも保存はできます。

Worldline（Ingenico）

Enable/Disable: Enable Worldline Gateway は決済方法をオンまたはオフにします。デフォルト：オフ。

Title: チェックアウトで購入者に表示される決済方法の名前です。注文にも決済方法名として保存されます。デフォルト：Worldline。必須、128 文字以内。

Description: Confirm Order の手順で、確認ボタンの上に購入者に表示されるテキストです。デフォルト：Pay securely via Worldline.

Sort Order: チェックアウトの決済方法の中で Worldline が表示される位置です。空欄にするか整数を入力します。

Geo Zone: 選択したジオゾーン内の支払い先住所に対してのみ Worldline を提供します。デフォルト：All zones。ジオゾーンは System > Localisation > Geo Zones で設定します。

Total: Worldline を提供するために注文が達している必要があるチェックアウト合計金額です。ストアのデフォルト通貨で指定します。空欄にすると、どの合計金額でも Worldline が提供されます。

Worldline Direct API

認証情報は、テストアカウントとライブアカウントそれぞれの Worldline Merchant Portal で確認できます。PSPID が加盟店 ID です。Developer > Payment API で API Key ID と Secret API Key を作成し、Developer > Webhooks で Webhook キーとシークレットを作成します。このセクションには、両方のポータルと Worldline のドキュメントへのリンクがあります。

Test Mode: API のエンドポイントと認証情報を同時に切り替えます。テストモードはプレプロダクション環境とテスト用の認証情報を使用し、ライブモードは本番環境とライブ用の認証情報を使用します。デフォルト：オン。実際の決済を受け付けるにはオフにします。テストモードがオンの間、購入者は Confirm Order の手順で Test mode — no real money is charged. と表示されます。

テストアカウント（プレプロダクション）

Test Merchant ID (PSPID): テストアカウントの PSPID です。

Test API Key ID: テストアカウントの Developer > Payment API で作成された API Key ID です。

Test Secret API Key: その API Key ID に属する Secret API Key です。

Test Webhook Key ID: 任意です。設定すると、このキーで送信された Webhook のみが受け付けられます。

Test Webhook Secret: テストアカウントの Webhook シークレットです。各 Webhook の署名を検証するために使用されます。

ライブアカウント（本番）

Live Merchant ID (PSPID): ライブアカウントの PSPID です。

Live API Key ID: ライブアカウントの Developer > Payment API で作成された API Key ID です。

Live Secret API Key: その API Key ID に属する Secret API Key です。

Live Webhook Key ID: 任意です。設定すると、このキーで送信された Webhook のみが受け付けられます。

Live Webhook Secret: ライブアカウントの Webhook シークレットです。

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

認証情報の確認: Test credentials と Live credentials のボタンは、Worldline へのテスト呼び出しによって、各アカウントの保存済み認証情報を確認します。先に変更を保存してください。結果はボタンの下に表示されます。例えば、Test credentials: connection successful.、API credentials are not configured.、または Worldline から返されたエラーです。

Webhook

Webhook は、購入者がストアに戻らなかった場合でも、決済に関する情報をストアに伝えます。例えば、ブラウザを閉じた場合や、決済が後で確定した場合です。Merchant Portal で、テストアカウントの Developer > Webhooks を開き、このセクションの Endpoint URL に表示されている URL を追加します。OpenCart 3 では URL は https://your-store/index.php?route=extension/payment/wcp_worldline_gateway/webhook のような形式、OpenCart 4 では https://your-store/index.php?route=extension/wcp_worldline_gateway/payment/wcp_worldline_gateway.webhook のような形式です。URL は OpenCart インストールのストアアドレスから作成されます。設定に表示されたとおりに URL をコピーしてください。URL はリダイレクトなしで応答し、インターネットから到達可能である必要があります。次に、Webhook キー ID とシークレットを Test Webhook Key ID と Test Webhook Secret に入力します。ライブアカウントでも、ライブ用のフィールドに同じ操作を行ってください。

拡張機能は、Worldline からのエンドポイント検証リクエストに自動的に応答します。決済イベント（決済ステータスの変更）と返金イベント（返金ステータスの変更）を処理します。その他のイベントは受け付けられますが、無視されます。有効な署名のない Webhook は拒否されます。イベントは、決済が行われたアカウントのシークレットで署名されている必要があるため、テスト用の Webhook がライブの決済を確定することはありません。また、署名したシークレットを持つアカウントとは別の加盟店 ID から届いた Webhook も無視されます。Webhook がない場合、注文は購入者が決済後にストアに戻った時にのみ確定されます。

決済ページと注文

Payment page template: Merchant Portal にアップロードされたホスト型チェックアウトのテンプレート（バリアント）の名前（任意）です。例えば、SimplifiedCustomPaymentPage。デフォルトの Worldline ページを使用する場合は空欄にします。

Order Status After Payment: キャプチャされた決済に設定されるステータスです。決済は常に直接販売（承認とキャプチャ）として要求されます。

OpenCart は Confirm Order の手順で、ステータスのない注文（欠落注文）を作成します。注文にステータスが付くのは、Worldline が決済を確認した後だけです。以下の各フィールドには、お使いの OpenCart の注文ステータスが一覧表示されます。

Paid Order Status: Payment accepted (processing) でキャプチャされた決済の後のステータスです。デフォルト：Processing。

Complete Order Status: Delivered (completed) でキャプチャされた決済の後のステータスです。デフォルト：Complete。

Awaiting Capture Status: 決済は承認済み、またはキャプチャが要求されています。キャプチャの Webhook が注文を支払い済みにします。デフォルト：Pending。

On Hold (Review) Status: 支払われた金額または通貨が注文と一致しません。理由はメモに説明されます。デフォルト：Pending。OpenCart には On hold ステータスがないためです。System > Localisation > Order Statuses で独自のステータスを作成し、ここで選択できます。

Payment Error Status: キャプチャ待ちの注文の決済が、Worldline によって拒否またはキャンセルされました。デフォルト：Failed。

Refunded Status: 注文ページから決済が全額返金されました。デフォルト：Refunded。

詳細設定

Logging: すべての API リクエストと Webhook を、OpenCart のログフォルダ（storage/logs）にある wlg_debug.log.php に書き込みます。このファイルは Web から開くことはできず、5 MB に達すると wlg_debug.old.log.php に移動されます。このオプションがオフの場合でも、エラーと警告は常に記録されます。キー、カード情報、個人情報はマスクされます。デフォルト：オフ。

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

Delete Data: オンにすると、拡張機能をアンインストールした際に、ゲートウェイの設定とログが削除されます。Worldline の取引と返金は常に保持されます。既存の注文が返金のためにそれらを必要とするためです。デフォルト：オフ。

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

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

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

チェックアウト

Payment Method の手順で、購入者は決済方法を選択します（デフォルトは Worldline）。Confirm Order の手順で、購入者は貴店の説明を確認します。OpenCart は、この手順でまだステータスのない注文を作成します。購入者が Confirm Order をクリックすると、拡張機能は注文通貨での注文合計を対象とした Worldline のホスト型チェックアウトを作成し、購入者を Worldline の決済ページに移動させます。そこで購入者は、カード、ウォレット、またはお使いの Worldline アカウントで有効になっている他の決済方法で支払います。請求先の氏名、住所、メールアドレス、電話番号が Worldline に渡され、Worldline がサポートしている場合は、決済ページが購入者の言語で開きます。各決済の試行には、注文番号とランダムな部分から成る独自の参照番号が割り当てられます。OpenCart 4 では、購入者は決済方法ブロックの Choose ボタンから、Payment method options のウィンドウで決済方法を選択し、チェックアウトページの下部で Confirm Order をクリックします。

決済後、購入者は貴店に戻ります。拡張機能は、保存された試行と照らし合わせてその戻りを確認し、サーバー側で Worldline から決済ステータスを読み取ります。注文が支払い済みになるのは、Worldline がこのステータスの確認または署名付きの Webhook によって確定した後だけです。その後、注文は OpenCart の標準的な方法でステータスを受け取り、通常の注文メールと在庫の更新が行われます。購入者には、Your payment with Worldline has been received. と表示された OpenCart の注文完了ページが表示されます。決済が承認済みでまだキャプチャされていない場合、ページには Your payment is authorized. The order is confirmed as soon as Worldline confirms the capture. と表示されます。そのような注文の決済が失敗した場合、ページには Your Worldline payment was not completed. Please contact us about this order. と表示されます。

決済が完了しなかった場合、注文はステータスを持たず、カートは保持され、購入者はメッセージとともにチェックアウトに戻ります。

ステータスをまだ確認できない場合、Payment confirmation のページに We could not confirm your payment yet. If you completed the payment, please do not pay again — you will receive a confirmation as soon as Worldline confirms it. と表示され、Check again と Back to checkout のボタンが表示されます。Webhook が届き次第、注文ステータスが設定されます。

OpenCart 4 では、これらのメッセージはチェックアウトページの上部に表示されます。

OpenCart 3 は、Confirm Order の手順が表示されるたびに新しい注文を作成します。OpenCart 4 はチェックアウトの注文を 1 つ保持して更新するため、キャンセルや拒否の後、購入者は新しい Worldline の決済ページで同じ注文を支払います。新しい決済の前に、拡張機能はカートを確認します。同じカートの別の注文がすでに支払い済みである場合、または前回の試行がその間に支払い済みになった場合、購入者は成功ページに直接案内され、二重に請求されることはありません。同じ注文の前回の決済ページが、同じ金額とモードでまだ開いており、作成から 30 分以内であれば、購入者はそのページに戻されます。

OpenCart 4 では、チェックアウトの注文に対する決済が承認後に拒否またはキャンセルされた場合、次の Confirm Order で、購入者は成功ページではなく、拒否された決済のメッセージとともにチェックアウトに戻されます。ストアがその注文を閉じた場合（たとえばキャンセルまたは返金した場合）、メッセージは Your previous order was closed by the shop (cancelled / refunded). Please confirm the order again to pay with a new order. です。いずれの場合も、次の Confirm Order で新しい注文が支払われます。チェックアウトの注文がすでに支払い済みでも、その後カートが変更された場合（数量の変更を含む）、購入者はチェックアウトに戻され、新しいカートは新しい注文で支払われます。

Worldline が決済を開始できない場合、購入者はボタンの上に Payment error: Could not create checkout session. Please try again. と表示された Confirm Order の手順にとどまります。理由はログに記録されます。現在のモードの認証情報がない場合、購入者には This payment method is not available at the moment. Please choose another payment method. と表示されます。

Webhook と購入者の戻りも、ストアがメンテナンスモードの間に動作します。OpenCart 3 は決済拡張機能へのリクエストを通過させ、OpenCart 4 では拡張機能がそのためのスタートアップアクションを追加します。

この拡張機能は、Worldline のページでの 1 回限りの決済を直接販売として受け付けます。保存済みカードやトークン化、サブスクリプション、埋め込み型のカードフォーム、OpenCart からのキャプチャまたは取り消しを伴う承認のみのモード、サーチャージ、Webhook の自動登録には対応していません。

注文と返金

注文ステータス

ステータスなし（欠落注文）: 購入者は Worldline に移動しましたが、支払っていない、または Worldline がまだ決済を確認していない状態です。Sales > Orders では、このような注文は Order Status フィルターを Missing Orders に設定した場合にのみ表示されます。

Paid Order Status または Complete Order Status（デフォルト Processing または Complete）: 決済がキャプチャされました。ステータスは Order Status After Payment に従います。メモには、金額、Worldline の決済 ID、および確認方法（署名付きの Webhook またはステータス確認）が表示されます。

Awaiting Capture Status（デフォルト Pending）: Worldline は、決済が承認済みであるか、キャプチャが要求されているが、まだキャプチャされていないと報告しています。Webhook がキャプチャを確認すると、注文は支払い済みのステータスに移ります。メモに決済がキャプチャされていないと記載されている場合は、Worldline Merchant Portal でキャプチャしてください。

On Hold (Review) Status（デフォルト Pending）: 決済が注文と一致しません。例えば、金額または通貨が異なる、または決済が別の試行に属しています。メモには、支払われた金額、注文合計、参照番号が表示されます。注文を確認して処理するか、決済を返金してください。

Payment Error Status（デフォルト Failed）: キャプチャ待ちの注文の決済が、Worldline によって拒否またはキャンセルされました。

Refunded Status（デフォルト Refunded）: 決済は拡張機能を通じて全額返金されました。

すでに返金済みまたはキャンセル済みの注文に決済が届いた場合、注文は再開されません。メモには、Worldline Merchant Portal で決済をキャンセルまたは返金するか、注文を手動で復元するよう記載されます。戻ってきた購入者には、Your payment was received after this order had been cancelled. Please contact us — we will restore the order or refund the payment. と表示されます。すでに支払い済みの注文、または支払い済みのカートにある別の注文に対して 2 回目の決済が届いた場合、その注文は変更されません。支払い済みの注文のメモには、2 回目の決済を Worldline Merchant Portal で返金するよう記載されます。

メモは、購入者には表示されない注文の History のエントリです。メモは Worldline という単語で始まります。

VibeFox Worldline Gateway タブ

Sales > Orders で、Worldline で支払われた注文を開きます。注文ページの下部、History と Additional の横にある VibeFox Worldline Gateway タブには、Worldline payment のブロックが表示されます。内容は、Payment ID、Merchant reference、Hosted checkout、試行の Status、Amount charged / refunded、テスト決済を示す Test environment のラベル、返金フォーム、返金履歴、注文の Payment notes です。このタブは、拡張機能へのアクセス権を持つユーザーに表示されます。

返金

VibeFox Worldline Gateway タブで金額を入力し（まだ返金されていない金額が自動入力されます）、必要に応じて Reason (optional) を入力して、Refund via Worldline をクリックします。確認の質問 Refund this amount through Worldline? This cannot be undone. に応じてください。全額返金と一部返金に対応しています。決済がキャプチャ済みである必要があります。拡張機能を変更する権限が必要です（System > Users > User Groups で設定します）。返金は Worldline が請求した金額と通貨で行われるため、金額や通貨に不一致があった場合は、注文合計ではなく、購入者が実際に支払った金額までを返金できます。返金は、常に元の決済の環境（テストまたはライブ）に、そのアカウントの認証情報を使って送信されるため、それらの認証情報が設定されている必要があります。タイムアウト後に再試行された返金は二重に実行されず、同じ注文では一度に 1 件の返金だけが実行されます。Worldline が返金を拒否した場合、タブにエラーが表示され、返金は記録されません。承認された返金は、Worldline の返金 ID とステータスとともに、返金履歴とメモに追加されます。全額返金の場合、購入者に通知せず、商品を在庫に戻すこともなく、手動でのステータス変更と同様に、注文が Refunded Status になります。一部返金ではステータスは変わりません。

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

Worldline からの返金ステータスの変更は Webhook で届き、返金履歴が更新され、メモに追加されます。Merchant Portal で行われた返金は、注文ステータスを変更しません。必要に応じて手動で更新してください。

ライセンスキー

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

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

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

有効なキーがない場合、Worldline はチェックアウトで購入者に表示されません。決済が開始された場合、購入者には 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 ジョブは不要です。拡張機能をアンインストールすると、ライセンスキーとライセンスステータスは常に削除されます。

トラブルシューティング

チェックアウトに Worldline が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在のモードに加盟店 ID、API Key ID、Secret API Key が設定されていることを確認してください。テストモードではテスト用のフィールド、ライブモードではライブ用のフィールドです。設定が欠けている場合、設定ページに警告が表示されます。また、決済先の住所が選択した Geo Zone に含まれていること、注文が設定の Total に達していることも確認してください。

決済は完了したが、注文がステータスのないまま: Webhook が機能していません。使用しているアカウント（テストまたはライブ）の Merchant Portal で、エンドポイントが存在すること、その URL が Endpoint URL に表示されているものと完全に一致し、リダイレクトがないことを確認してください。そのアカウントの Webhook シークレットが該当するフィールド（Test Webhook Secret または Live Webhook Secret）にあること、また Webhook キー ID のフィールドが空であるか、キーと一致していることを確認してください。購入者が決済後にストアに戻った場合も、注文はステータスを受け取ります。

Webhook answers Webhook secret not configured: どちらの Webhook シークレットも設定されていません。設定で Webhook シークレットを入力してください。Worldline は Webhook を再送します。

Webhook answers Invalid signature: Webhook シークレットが別のアカウントまたは別のキーに属しているか、Webhook キー ID が Webhook を送信したキーと一致しません。テストとライブのシークレットが入れ替わっていないか確認してください。

Webhook answers Missing signature、Empty body、Invalid JSON: リクエストが期待された形式で Worldline から届いていないか、プロキシやリダイレクトによって変更されています。URL がリダイレクトなしで応答することを確認してください。

Webhook answers Ignored: Webhook が、そのモードの設定とは異なる加盟店 ID から届きました。Test Merchant ID (PSPID) または Live Merchant ID (PSPID) を確認してください。

Webhook answers Retry later: 同じ時点で別のリクエストが注文を確定していたか、注文ステータスを設定できませんでした。Worldline は Webhook を再送します。理由は Log の欄で確認してください。

Webhook URL をブラウザで開くと Method not allowed と表示される: これは正常です。この URL は Worldline からのリクエストのみを受け付けます。

Test credentials または Live credentials がエラーを表示する: まず設定を保存してから、加盟店 ID、API Key ID、Secret API Key が同じアカウントから取得されたものであること、テストの値はテスト用のフィールドに、ライブの値はライブ用のフィールドに入力されていることを確認してください。

Confirm Order の後に購入者がエラーを見る: 拡張機能ページの Log の欄を確認してください。Logging がオフでも、エラーは記録されます。リクエストの詳細をすべて確認するには、Logging をオンにして再度試してください。

テストの決済がライブの決済を確定しない: テストとライブは分けられています。Test Mode を使用したいモードに切り替え、そのアカウントの認証情報と Webhook を使用してください。

決済後に注文が審査中またはキャプチャ待ちのステータスになっている: VibeFox Worldline Gateway タブのメモを確認してください（注文ステータスを参照）。Worldline がまだキャプチャを確認していない（Webhook が注文を完了させる）か、支払われた金額または通貨が注文と異なっていた可能性があります。

タブに返金フォームがない: タブに理由が表示されます。キャプチャ済みの Worldline 決済がない、決済が全額返金されている、ユーザーグループに拡張機能を変更する権限がない、または決済環境の認証情報が設定されていない、のいずれかです。

環境に関するメッセージで返金が失敗する: 決済はテストまたはライブの環境で行われましたが、その環境の認証情報が設定されていません。認証情報を入力してから再度試してください。

開発者向け：ホスト型チェックアウトが作成される前に、拡張機能はリクエストデータと注文を含めて OpenCart イベント wlg_hosted_checkout_data を発火します。例えば、表示される決済方法を制限する場合に使用できます。

アンインストール

Extensions > Extensions に移動し、種類として Payments を選択して、VibeFox Worldline Gateway の横にある Uninstall（赤色の − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは常に削除されます。OpenCart は、この拡張機能自体の設定を常に削除します：Enable/Disable、Sort Order、Geo Zone、Total、そして Payment page and orders セクションの注文ステータスです。これらは再インストール時にデフォルトに戻ります。拡張機能の OpenCart イベントも削除されます（OpenCart 4 では、そのイベントとスタートアップアクションも削除されます。このアクションは、メンテナンスモードで Webhook と購入者の戻りを通過させるものです）。Delete Data がオンの場合、その他のゲートウェイ設定（タイトル、説明、テストモード、認証情報、Webhook シークレット、ページテンプレート、ログ設定）とログが削除されます。オフの場合は、後で再インストールする際に使えるように保持されます。Worldline の取引と返金は常に保持されるため、以前に支払われた注文は、再インストール後も返金できます。既存の注文は決済のメモを保持します。

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

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