VibeFox Viva Wallet for OpenCart — ヘルプ

要件

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

PHP: 8.0 以降。

Viva アカウント: Viva の加盟店アカウント。テストにはデモアカウント（demo.vivapayments.com）、実際の支払いには本番アカウント（www.vivapayments.com）を使用できます。アカウントごとに認証情報が異なります。支払いには Smart Checkout の認証情報（Client ID と Client Secret）と、支払いソースの Source Code が必要です。Merchant ID と API Key は任意です。これらは Viva による Webhook URL の確認に応答する目的でのみ使用されます。

通貨: EUR、GBP、PLN、RON、BGN、CZK、HUF、DKK、SEK、NOK、CHF のいずれか。ストアで購入者が選択した通貨がこのいずれかに含まれている必要があります。それ以外の通貨の場合、チェックアウトで支払い方法は表示されません。

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

インストール

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

OpenCart 3

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

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

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

4. Viva のデモアカウントおよび/または本番アカウントの認証情報を入力し、Viva アカウントで支払いソースと Webhook を設定します（Configuration を参照）。

5. Enable/Disable をオンにして Save をクリックします。Test Mode がオンの状態で Viva のデモカードを使ってデモ支払いを行い、その後 Test Mode をオフにすると本番運用になります。

OpenCart 4

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

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

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

4. OpenCart 3 の手順 3 から 5 と同じように、ライセンスキー、Viva の認証情報、支払いソース、Webhook を入力します。設定ページとそのフィールドは両方のバージョンで同じです。Viva アカウント用のアドレスのみが異なります（Configuration を参照）。

新規インストールでは、支払い方法はオフ、テストモードはオンの状態で開始されます。

設定

すべての設定は拡張機能のページにあります：Extensions > Extensions > Payments > VibeFox Viva Wallet Gateway > Edit。セクションは左側に一覧表示されます。一覧の下にある Save ボタンでページ全体を保存します。設定の上には、現在のモードに Client ID、Client Secret、Source Code がない場合（Viva Wallet is hidden at checkout until the Demo Client ID, Client Secret and Source Code are entered.、本番モードでは Live）や、ストアの既定の通貨がサポートされていない場合に警告が表示されます。テストモードがオンの間は Test mode is on: payments go to the Viva demo environment. と表示されます。拡張機能を変更する権限がない場合、ページは設定を表示しますが保存はできません。

保存時には、Title を空にすることはできず、128 文字以内である必要があります（Enter a title for the payment method (at most 128 characters).）。Sort Order は整数でなければなりません（Sort Order must be a whole number.）。Total は 0 以上の数値でなければなりません（Total: enter a number, 0 or greater.）。選択したジオゾーンと注文ステータスも存在している必要があります。条件を満たさない場合は何も保存されず、ページにエラーが表示されます。設定を保存すると、キャッシュされた Viva のアクセストークンが削除されるため、新しい認証情報がすぐに使用されます。

Viva Wallet

Enable/Disable: Enable Viva Wallet payment gateway で支払い方法のオン・オフを切り替えます。初期値: off。

Title: 購入者がチェックアウトで目にする支払い方法の名前です。注文にも、この名前が支払い方法として保存されます。初期値: Viva Wallet。必須、128 文字以内。

Description: Confirm Order の手順で、確認ボタンの上に購入者に表示されるテキストです。初期値: Pay securely with Viva Wallet — cards, Apple Pay, Google Pay and more.

Test Mode: Viva のデモ環境（demo.vivapayments.com）を使用します。新しい支払いと API 呼び出しには、デモアカウントの認証情報が使われます。実際の料金は請求されず、Confirm Order の手順で購入者には (Test mode: use Viva demo cards, no real money is charged.) と表示されます。初期値: on。実際の支払いを受け付けるには、オフにして本番アカウントを使用します。すでに行われた支払いは、行われた環境で引き続き確認・返金されます。

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

Geo Zone: 選択したジオゾーン内の支払い先住所に対してのみ Viva Wallet を提供します。初期値: All zones。ジオゾーンは System > Localisation > Geo Zones で設定します。

Total: Viva Wallet を提供するために注文が達している必要がある、ストアの既定の通貨でのチェックアウト合計金額です。0 以上の数値。空欄にすると、どの金額でも提供されます。

Demo account (test mode) and Live account

両方のセクションには同じ項目があります。一方はデモアカウント用、もう一方は本番アカウント用です。Viva アカウントで Settings > API Access を開き、Smart Checkout の認証情報（Client ID、Client Secret）、Merchant ID、API Key をコピーします。Source Code は Sales > Online payments > Websites / apps にあります。

Client ID (Demo) / Client ID (Live): アカウントの Smart Checkout OAuth 2.0 Client ID です。支払いに必要です。

Client Secret (Demo) / Client Secret (Live): アカウントの Smart Checkout OAuth 2.0 Client Secret です。支払いに必要です。

Source Code (Demo) / Source Code (Live): アカウントの支払いソースの 4 桁のコードです。その Success URL と Failure URL は、このストアを指している必要があります（下記参照）。支払いに必要です。

Merchant ID (Demo) / Merchant ID (Live): 任意です。Viva による Webhook URL の確認に応答する目的でのみ使用されます。

API Key (Demo) / API Key (Live): 任意です。Viva による Webhook URL の確認に応答する目的でのみ使用されます。

保存済みの Client Secret と API Key は再表示されません。入力欄は空のままで、Saved — leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。

Clear saved secrets: Live account セクションの末尾にあります。保存済みの秘密情報にチェックを入れて Save をクリックすると削除されます。入力欄を空にした場合は、保存された値が維持されます。

Return URLs and webhook

Addresses for the Viva account: この欄には、Viva アカウントに入力する 3 つのストアのアドレスが表示されます。これらは OpenCart のストアフロントのアドレスから作成され、次のような形式になります（OpenCart 3）：https://your-store/index.php?route=extension/payment/wcp_viva_gateway/success&、https://your-store/index.php?route=extension/payment/wcp_viva_gateway/fail&、https://your-store/index.php?route=extension/payment/wcp_viva_gateway/webhook。OpenCart 4 では、https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.success&、https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.fail&、https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.webhook の形式です。設定に表示されたとおりに正確にコピーしてください。成功と失敗のアドレス末尾の & は必須です。Viva は取引情報をアドレスに追加するため、これがないと OpenCart はページが見つからないと応答します。

Payment source: 使用する各アカウントで、Sales > Online payments > Websites / apps から、ストアのドメイン用の支払いソースを作成します。Success URL と Failure URL には、成功と失敗のアドレスにあるドメイン以降のパスを入力します。

Webhook: Settings > API Access > Webhooks で、次のイベント用に Webhook アドレスを追加します：

Viva は保存前に URL を確認します。拡張機能は、アカウントの確認キーで応答します。現在のモードの Merchant ID と API Key を使ってキーを取得するか、下に入力されたキーを使用します。Webhook は、購入者がブラウザを閉じた場合でも支払いを確認します。Viva の Webhook は署名されていないため、拡張機能は Webhook だけを信用することはありません。注文がステータスを得る前に、すべての支払いが Viva API で確認されます。Webhook がない場合、注文は購入者が支払い後にストアへ戻ったときにのみステータスを得ます。

Webhook Verification Key: 任意です。空欄のままにすると、現在のモードの Merchant ID と API Key を使ってキーが自動的に取得されます。または、Viva アカウントの確認キーをここに貼り付けてください。

Order statuses

OpenCart は Confirm Order の手順で、ステータスなしの注文（欠落した注文）を作成します。注文が Viva の支払いで確認された後にのみ、ステータスが付与されます。ステータス欄には、OpenCart の注文ステータスが一覧表示されます。

Order Status After Payment: 支払い済みの注文に付与されるステータスです。1 回のステータス変更で即座に設定されます。

Processing Status: Default と Processing の場合に、支払い済みの注文に付与されるステータスです。初期値: Processing。

Complete Status: Completed の場合に、支払い済みの注文に付与されるステータスです。初期値: Complete。

On Hold Status: On Hold の場合に、支払い済みの注文に付与されるステータスです。また、Viva の支払いが注文の金額または通貨と一致しない注文にも使用されます（確認のために保留され、支払い済みにはなりません。メモに理由が記載されます）。初期値: Pending。OpenCart には On hold ステータスがないためです。System > Localisation > Order Statuses で独自のステータスを作成し、ここで選択できます。

Cancelled Order Status: このステータスの注文に対して受け取った Viva の支払いは、その注文を再オープンしません。メモで、注文を復元するか支払いを返金するよう求められます。拡張機能がこのステータスを設定することはありません。初期値: Canceled。

Refunded Status: 注文のタブから支払いが全額返金された後に設定されます。その後の支払いでも、このような注文は再オープンされません。初期値: Refunded。

Advanced Settings

Brand Color: Viva の決済ページの 6 桁の HEX カラーコードです（例：0000ff）。先頭の # は削除されます。空欄のままにすると既定の色になります。それ以外の値は保存されず、他の設定は保存されますが、ページには Brand Color must be a 6-digit HEX code (e.g. 0000ff). The previous value was kept. と表示されます。

Debug Logging: API リクエストを OpenCart のログフォルダ（storage/logs、OpenCart 4 では system/storage/logs）内の viva_wp_debug.log.php に書き込みます。このファイルはウェブから開くことはできません。キー、トークン、購入者データは記録されません。この設定がオフでも、エラーは常に記録されます。初期値: off。

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

Delete Data on Uninstall: オンにすると、拡張機能をアンインストールしたときに、ゲートウェイの設定とログが削除されます。注文と支払いデータ（Viva の支払い試行、返金）は削除されることはありません。初期値: off。

Import / Export

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

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

チェックアウト

Payment Method の手順で、購入者は支払い方法を選択します（既定は Viva Wallet）。Confirm Order の手順では、購入者にストアの説明と、You will be redirected to the secure Viva Wallet payment page (cards, Apple Pay, Google Pay and more). という注記が表示されます。OpenCart はこの手順で、まだステータスのない注文を作成します。OpenCart 4 では、購入者は決済方法ブロックの Choose ボタンから、Payment method options のウィンドウで決済方法を選択し、チェックアウトページの下部で Confirm Order をクリックします。購入者が Confirm Order をクリックすると、拡張機能は注文通貨で注文合計に対応する Viva 決済注文を作成し、購入者を Viva Smart Checkout のページに送ります。Brand Color が設定されている場合は、その色が使用されます。購入者はそこで、Viva アカウントで有効になっている支払い方法のいずれかを使って支払います。購入者のメールアドレス、氏名、電話番号、国、ストアの言語が Viva に渡されます。Viva の支払いには OpenCart # と注文番号が表示され、購入者には Order、注文番号、at、ストア名として説明されます。Viva の決済注文は 30 分後に期限切れになります。

支払い後、購入者はストアに戻ります。注文は、Viva が確認した後にのみ支払い済みになります。拡張機能は、購入者が戻ったときと Webhook を受け取ったときの両方で、Viva API から取引を読み取り直します。その後、注文は OpenCart の標準的な方法でステータスを取得し、通常の注文メールが送信され、在庫が更新されます。購入者には OpenCart の注文完了ページが表示されます。支払いがまだ確認されていない場合、Payment confirmation ページに We are waiting for Viva Wallet to confirm your payment. You will receive an e-mail as soon as it is confirmed. と表示され、Check again と Back to checkout のボタンが表示されます。支払いが確認されるまでカートは保持されます。Viva が確認するとすぐに、Webhook が注文ステータスを設定します。OpenCart 4 では、購入者が Viva のページから戻ると、短い中間ページがストアの戻りアドレスを再度開くため、カートと購入者のセッションは保持されます。

支払いが失敗した場合、または購入者が Viva のページでキャンセルした場合、注文はステータスなしのままで、カートは保持されます。購入者はチェックアウトに戻り、The Viva Wallet payment was not completed. Please try again or choose another payment method. または The Viva Wallet payment was cancelled. You can try again or choose another payment method. と表示されて、再度支払うことができます。新しく試行するたびに、新しい Viva 決済注文が開始されます。1 つのカートは 1 回だけ支払われます。同じチェックアウトの別の注文ですでにカートが支払われている場合、購入者は直接成功ページに進みます。OpenCart 4 では、これらのメッセージはチェックアウトページの上部に表示されます。OpenCart 3 は Confirm Order の手順が表示されるたびに新しい注文を作成し、OpenCart 4 はチェックアウトの注文を更新します。数量の変更を含め、カートを変更すると新しいカートとみなされ、独自の支払いが必要になります。

OpenCart 4 は、成功ページが表示されるまで注文をチェックアウトに保持します。支払いが失敗した後やキャンセルされた後、購入者は新しい Viva 決済注文で同じ注文を再度支払います。その注文がその間に閉じられた場合（たとえばストア側でキャンセルされた場合）、またはその後カートが変更された状態で支払われた場合、購入者は This order can no longer be paid. Please confirm your order again. と表示されてチェックアウトに戻され、次の Confirm Order で新しい注文が支払われます。

Viva が支払いを開始できない場合、購入者はボタンの上にメッセージが表示された状態で Confirm Order の手順にとどまります。Viva Wallet payments are not available at the moment. Please choose another payment method or contact us.（認証情報がない、または誤っている場合）、または We could not connect to Viva Wallet. Please try again in a moment or choose another payment method. 技術的な理由はログに記録されます。

戻りページに注文成功ページが表示されるのは、支払いを行った購入者だけです。戻りアドレスを開いた他のユーザーは、注文の詳細を表示せずに注文履歴またはチェックアウトに送られます。

OpenCart は支払い拡張機能のリクエストを通過させるため、ストアがメンテナンスモードであっても Webhook は動作します。OpenCart 4 では、拡張機能のスタートアップアクションにより、Webhook と成功・失敗のアドレスが通過できます。

この拡張機能は一回限りの支払いのみに対応しており、Viva のページで即時に請求されます。事前承認と売上確定、分割払い、カードの保存、定期購読、Viva Native Checkout（自店ページのカード入力欄）、POS 端末には対応していません。購入者が新しい試行を開始しても、古い未払いの Viva 決済注文はキャンセルされません。Viva が 30 分後に期限切れにします。

注文と返金

Order statuses

ステータスなし（欠落した注文）: 購入者は Viva に送られましたが、まだ支払っていない、支払いが失敗した、またはキャンセルされた、あるいは Viva がまだ支払いを完了していない状態です。購入者は再度支払うことができます。Sales > Orders では、このような注文は Order Status フィルターを Missing Orders に設定した場合にのみ表示されます。OpenCart 4.1 では、このような注文に Voided ステータスが付く場合もあります。これは、Confirm Order の手順が再度表示されたときに OpenCart が設定します。拡張機能はこれもステータスのない注文として扱います。

Order Status After Payment（初期値 Processing）: 支払いが確認されました。メモには、金額、取引、Viva の注文コード、環境（デモまたは本番）、および確認方法（Webhook または購入者の戻り）が表示されます。

不一致後の On Hold Status（初期値 Pending）: Viva が報告した金額または通貨が注文合計と異なります。注文は支払い済みにはならず、メモ Viva Wallet payment held for review に理由が記載されます。Viva のダッシュボードで支払いを注文と照合し、手動で出荷するか返金してください。後で同じ注文に一致する支払いが届いた場合、注文は支払い済みのステータスに移ります。

Cancelled Order Status または Refunded Status の注文に対して届いた支払いは、注文のステータスを変更しません。メモで、注文を復元するか、Viva のダッシュボードで支払いを返金するよう求められます。すでに支払い済みの注文、または支払い済みのカートの別の注文に 2 回目の支払いが届いた場合、その注文は変更されません。支払い済みの注文のメモで、Viva のダッシュボードで重複分を返金するよう求められます。

メモは、購入者には表示されない注文の History のエントリです。ステータスの変更によって購入者に自動的に通知されることはありません。支払い済みの注文が初めてステータスを得たときに、OpenCart は通常の注文メールを送信します。

VibeFox Viva Wallet Gateway tab

Sales > Orders で、Viva Wallet で支払われた注文を開きます。注文ページの下部、History と Additional の隣に、VibeFox Viva Wallet Gateway タブが表示されます。このタブには、Viva order code、デモ支払いの場合は Demo ラベル付きの Transaction ID、Environment / Source Code、Viva status、Paid / refunded の金額、返金フォーム、返金履歴、注文の Viva payment attempts（複数回あった場合）、注文の Viva Wallet notes が表示されます。このタブは、拡張機能にアクセスできるユーザーに表示されます。

Refunds

VibeFox Viva Wallet Gateway タブで Amount を入力します（まだ返金されていない金額が自動入力されます）。必要に応じて Reason (optional) を入力し、Refund via Viva Wallet をクリックします。Refund this amount via Viva Wallet? This cannot be undone. の確認に答えてください。確認済みの Viva 支払いがある注文では、全額返金と一部返金が可能です。拡張機能を変更する権限が必要です（System > Users > User Groups で設定します）。注文が後で編集されていても、Viva が支払いで請求した金額まで返金できます。返金は支払いが行われたアカウント（デモまたは本番）に、支払いの通貨で送信されるため、そのアカウントの Client ID と Client Secret が入力されている必要があります。Viva が返金を受け付けない場合、タブにエラーが表示され、返金は記録されません。返金に成功すると、Viva の返金取引とともに返金履歴とメモに追加されます。全額返金は、購入者に通知せず、商品を在庫に戻すこともなく、手動でのステータス変更と同じように、注文を Refunded Status に設定します。一部返金ではステータスは変わりません。不一致のために確認保留となった注文には確認済みの支払いがないため、タブから返金することはできません。

Sales > Returns での商品返品は、Viva を通じて返金されることはありません。Viva のダッシュボードで行った返金は取り込まれません。必要に応じて注文を手動で更新してください。

ライセンスキー

この拡張機能は、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox Viva Wallet Gateway は、Extensions > Extensions > Payments > VibeFox Viva Wallet Gateway > Edit のページで、設定の上にある最初のブロックです。License key にキーを入力し、Activate をクリックします。その後、ブロックにはキーがマスク表示され、ステータス（ライセンスの有効期限日やドメインなど）と、ステータスを再確認する Check now、別のキーを入力する Change key、このストアからキーを削除する Remove key のボタンが表示されます。その下には Product: opencart-payment-viva という行と、vibefox.net のアカウントを開く 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 のアカウントで枠を解放してください。

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

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

トラブルシューティング

Viva Wallet がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在のモードに Client ID、Client Secret、Source Code が設定されていることを確認してください（テストモードでは Demo の項目、本番モードでは Live の項目）。ストアで選択された通貨は、EUR、GBP、PLN、RON、BGN、CZK、HUF、DKK、SEK、NOK、CHF のいずれかである必要があります。また、支払い先住所が選択した Geo Zone に含まれていること、注文が設定の Total に達していることも確認してください。認証情報が不足している場合、設定ページに警告が表示されます。

支払いは完了したが、注文にステータスが付与されない: Webhook が機能していません。Viva で、使用しているアカウント（デモまたは本番）に Webhook が存在すること、その URL が設定に表示されたものと正確に一致すること、Transaction Payment Created が選択されていることを確認してください。その支払いのアカウントの Client ID と Client Secret がまだ入力されていることも確認してください。拡張機能は支払いを確認するためにこれらを必要とします。Debug Logging をオンにして、Log 欄を確認してください。購入者が支払い後にストアに戻った場合も、注文にはステータスが付与されます。

購入者がページが見つからないに戻される: 支払いソースの Success URL または Failure URL が & で終わっていません。設定に表示されたとおりにパスを正確にコピーしてください。

Viva が Webhook URL を確認できない: 現在のモードの Merchant ID と API Key（または確認キーそのものを Webhook Verification Key に）を入力して保存し、Viva で再度確認してください。もう一方のアカウントの Webhook を確認するには、まず Test Mode を切り替えるか、そのアカウントのキーを入力してください。

Webhook がエラーで応答する: Viva はストアの応答を表示し、失敗した Webhook を再試行します。verification_failed（HTTP 500）は、支払いを確認するための Viva API に接続できなかったこと、または注文ステータスを設定できなかったことを意味します。busy（HTTP 503）は、同じ時点で別のリクエストが注文を処理していたことを意味します。transaction_not_found（HTTP 404）は、その支払いのアカウントに取引が存在しないことを意味します。たとえば認証情報が誤っている場合などです。同じ Viva アカウント上の他のストアの支払いに関するイベントには、ignored が返されます。

購入者が Confirm Order の後にエラーを見る: 拡張機能ページの Log 欄を確認してください。Client ID または Client Secret が誤っている場合、Viva Wallet の支払いが利用できないというメッセージになります。Viva に接続できない、または支払い注文を拒否された場合（たとえば Source Code が別のアカウントのものである場合）、購入者にはストアが Viva Wallet に接続できなかったというメッセージが表示されます。This payment method is not available. は、チェックアウトのセッションが注文と一致しなくなったことを意味します。購入者はチェックアウトを再読み込みしてください。

購入者が戻ったときに We could not find your order. If you were charged, please contact us.: と表示される: 戻りアドレスの Viva 注文コードは、このストアの支払いではありません。たとえば、別のストアの支払いソースがここを指している場合などです。支払いソースの Success URL と Failure URL を確認してください。

支払い後に注文が確認ステータスになる: VibeFox Viva Wallet Gateway タブのメモを読み（Order statuses を参照）、注文を処理するか、支払いを返金してください。

タブに返金フォームがない: タブに理由が表示されます。注文に確認済みの Viva 支払いがない（Transaction ID not found. Cannot process refund.）、全額返金済みである、支払いのアカウントの認証情報がない、またはユーザーグループに拡張機能を変更する権限がない、のいずれかです。

This payment was made in the Viva demo (or live) environment と表示されて返金が失敗する: 支払いが行われたアカウントの Client ID と Client Secret が入力されていません。入力してから再試行してください。その他の返金エラーには、Viva からのメッセージが表示されます。

アンインストール

Extensions > Extensions に進み、種類で Payments を選択して、VibeFox Viva Wallet Gateway の横にある Uninstall（赤色の − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは常に削除されます。OpenCart は、拡張機能自身の設定を必ず削除します：Enable/Disable、Sort Order、Geo Zone、Total、および Order statuses セクションのステータス欄です。これらは再インストール時に初期値に戻ります。キャッシュされた Viva のアクセストークンと Webhook キーは常に削除されます。OpenCart 4 では、拡張機能のイベントと、メンテナンスモードで Webhook と戻りアドレスを通過させるスタートアップアクションも、常に削除されます。Delete Data on Uninstall がオンの場合、その他のゲートウェイ設定（タイトル、説明、テストモード、認証情報、支払い後の注文ステータス、ブランドカラー、ログ記録）とログも削除されます。オフの場合は、後で再インストールするために保持されます。Viva の支払い試行と返金は常に保持されるため、以前に支払われた注文は再インストール後も返金できます。既存の注文は支払いメモを保持します。

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

Viva Wallet は、その所有者の商標です。この拡張機能は Viva Wallet と提携しておらず、Viva Wallet によって推奨されたものでもありません。