VibeFox Midtrans for OpenCart — ヘルプ

要件

OpenCart: 3.0.x（3.0.5.0 でテスト済み）または 4.0.2 以降（4.1.0.3 でテスト済み）。

PHP: 8.0 以降。

通貨: インドネシア・ルピア（IDR）。Midtrans は IDR でのみ請求するため、チェックアウトの通貨が IDR の場合にのみ支払い方法が提供されます。通貨換算は行われません。ストアに IDR 通貨がない場合は、System > Localisation > Currencies で追加してください。

Midtrans アカウント: Midtrans Dashboard > Settings > Access Keys の Server Key が必要です。サンドボックスのダッシュボードと本番のダッシュボードの両方で取得してください。使用するのは Server Key のみです。Snap Redirect では Client Key は不要です。支払い方法そのもの（GoPay、QRIS、仮想口座など）は、Midtrans アカウントで有効にします。

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

インストール

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

OpenCart 3

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

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

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

4. Server Key を入力し、支払い通知 URL を Midtrans のダッシュボードにコピーします（設定を参照）。

5. Enable/Disable をオンにして Save をクリックします。Sandbox でテストしてから、Environment を Production に切り替えます。

OpenCart 4

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

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

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

4. ライセンスキー、Server Key、通知 URL を、OpenCart 3 の手順 3 から 5 と同じように入力します。設定ページとそのフィールドは両方のバージョンで同じです。異なるのは通知 URL だけです（設定を参照）。

新規インストールでは、支払い方法はオフ、環境は Sandbox が選択された状態で開始します。

設定

すべての設定は拡張機能のページにあります: Extensions > Extensions > Payments > VibeFox Midtrans Payment Gateway > Edit。セクションは左側に一覧表示され、一覧の下にある Save ボタンでページ全体を保存します。設定の上には、選択した環境の Server Key が不足している場合（その場合、支払い方法はチェックアウトで非表示になります）、およびストアの既定の通貨が IDR でない場合に警告が表示されます。Sandbox が選択されている間は、Sandbox mode: payments are simulated, no real money is charged. と表示されます。拡張機能を変更する権限がない場合、ページには設定は表示されますが、保存はできません。

保存時、Title は 1 から 128 文字、Sort Order は整数、Total は 0 以上の数値、Payment page expiry (minutes) は整数である必要があります。値が正しくない場合、ページにエラーが表示され、何も保存されません。

Midtrans

Enable/Disable: Enable Midtrans payments で支払い方法のオン・オフを切り替えます。既定値: オフ。

Title: チェックアウトでお客様に表示される支払い方法のタイトルです。注文にも支払い方法名として保存されます。既定値: Midtrans。必須。

Description: Confirm Order の手順で、確認ボタンの上にお客様に表示されるテキストです。既定値: Pay securely via Midtrans — GoPay, QRIS, ShopeePay, cards, bank transfer and more。Sandbox の場合、その上に SANDBOX MODE: no real money is charged. の行が表示されます。

Sort Order: チェックアウトにおける Midtrans の支払い方法の表示順です。空欄のままにするか、整数を入力します。

Geo Zone: 選択した地域ゾーン内の支払い先住所に対してのみ Midtrans を提供します。既定値: All zones。地域ゾーンは System > Localisation > Geo Zones で設定します。

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

API 認証情報

Midtrans Dashboard > Settings > Access Keys から Server Key をコピーします。このセクションには、本番ダッシュボードとサンドボックスダッシュボードへのリンクがあります。

Environment: 新しい支払いで使用される Midtrans 環境です。切り替えると、選択した環境のキーと API が使用されます。注文は、返金と通知のために、支払いが行われた環境を保持します。既定値: Sandbox。

Sandbox: テスト用です。実際のお金は発生しません。

Production: 実際の支払いです。

Production Server Key: Mid-server- で始まります。秘密にしてください。

Sandbox Server Key: SB-Mid-server- で始まります。

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

支払い通知 URL

通知は、支払いが行われたことをストアに伝えます。Notification URL 欄には、使用する URL が表示されます。OpenCart 3 では https://your-store/index.php?route=extension/payment/wcp_midtrans_payment_gateway/webhook、OpenCart 4 では https://your-store/index.php?route=extension/wcp_midtrans_payment_gateway/payment/wcp_midtrans_payment_gateway.webhook で、OpenCart インストールのストアフロントのアドレスから作られます。設定に表示されたとおりに URL を正確にコピーし、使用しているサンドボックスのダッシュボードと本番のダッシュボードの両方で、Midtrans Dashboard > Settings > Payment > Notification URL に貼り付けてください。この URL はインターネットから到達可能である必要があります。ブラウザで開くと短い説明が表示されるため、到達可能かどうかを確認できます。Midtrans ダッシュボードの Test notification URL ボタンにも応答します。

すべての通知には、Server Key のいずれかで作成された有効な署名が必要で、キーの環境は支払いの環境と一致している必要があります。有効な署名のない通知は拒否されます。注文が変更される前に、ステータスは Midtrans のステータス API から再取得されます。拡張機能は次の Midtrans のトランザクションステータスを処理します:

settlement, capture (accepted): 支払いが行われました。金額（ルピアの整数単位）と通貨が注文と一致すると、注文は支払い済みになります。

capture (challenge): Midtrans の不正検知によってフラグが付けられたカード支払いです。Midtrans ダッシュボードで承認または拒否するまで、注文は審査ステータスになります。

pending: お客様が後払いの方法（仮想口座、コンビニ、QRIS）を選んだか、カードの 3-D Secure の確認が完了していません。注文は保留の状態になります。

expire, cancel: 未払いのトランザクションが期限切れになったか、キャンセルされました。保留中の注文は、どの支払い方法でも expired / cancelled になります。ステータスなしの注文はステータスを得ません。試行が終了するだけで、お客様は再度支払うことができます。

deny: 支払いが拒否されました。保留中の注文は failed になります。

failure: 支払いが失敗しました。保留中の注文は failed になります。

refund, partial_refund: Midtrans ダッシュボードで行われた返金は、注文に記録されます。

支払い通知 URL がない場合、注文は、お客様が支払い後にストアへ戻ったときにのみ確認されます。後から行われた後払いの支払いは、お客様が戻るまで認識されません。

支払い設定

Midtrans は IDR でのみ請求し、金額はルピアの整数単位で送信されます。注文明細を合計しても四捨五入後の合計と一致しない場合、Rounding adjustment の行が Midtrans に送信されます。

Payment page expiry (minutes): お客様が支払いを完了できる期間です（Snap ページ、仮想口座など）。空欄または 0 を指定すると、Midtrans の既定値が使用されます。

Order ID prefix: Midtrans に送信する番号の先頭に付加されます。これにより、複数のストアで 1 つの Midtrans アカウントを共有できます。番号は、タイムスタンプ付きの OpenCart の注文 ID です（例: OC-123-1700000000）。使用できるのは英字、数字、および - _ . ~ のみで、最大 20 文字です。それ以外の文字は保存時に削除されます。他のストアの通知は無視されます。既定値: OC-。

注文

OpenCart は Confirm Order の手順で、ステータスなし（未完了の注文）として注文を作成します。注文は、Midtrans がトランザクションを確認した後にのみステータスを得ます。以下の各項目には、OpenCart の注文ステータスが表示されます。

Status after payment: 支払いが確認された後のステータスです。既定値: 処理中。支払い済みの注文を完了として扱うには完了ステータスを、支払い済みのすべての注文を手動で確認するには独自の審査ステータスを選択します。

Awaiting Midtrans payment status: Midtrans が pending を報告しています。仮想口座、コンビニ、または QRIS コードが発行されたか、カードの 3-D Secure の確認が完了していません。既定値: 保留中。

Midtrans payment on hold status: 支払いにはお客様による確認が必要です（注文ステータスを参照）。既定値: 保留中。OpenCart には On hold のステータスがないためです。System > Localisation > Order Statuses で独自のステータスを作成し、ここで選択できます。

Payment failed status: Midtrans が、保留中の注文に対して deny または failure を報告しています。既定値: 失敗。

Payment expired / cancelled status: 保留中の注文の、保留中の Midtrans トランザクションが期限切れになったか、キャンセルされました。未払いの Midtrans 注文を手動でこのステータスに設定すると、その保留中の Midtrans トランザクション（たとえば発行済みの仮想口座）は失効し、支払いできなくなります。既定値: キャンセル済み。

Refunded status: 支払いは、注文ページまたは Midtrans ダッシュボードから全額返金されました。既定値: 返金済み。

詳細設定

Debug log: API 呼び出しと通知を、OpenCart のログフォルダ（storage/logs）にある midtrans_p_debug.log.php に書き込みます。このファイルは Web から開くことはできません。エラーは常に記録されます。キーとお客様のデータは記録されません。既定値: オフ。

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

Delete data on uninstall: オンにすると、拡張機能をアンインストールしたときにゲートウェイの設定とログが削除されます。注文の Midtrans 支払い参照情報と返金は常に残るため、古い注文も再インストール後に返金できます。既定値: オフ。

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

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

Import: 以前にエクスポートした JSON を貼り付けて、Import をクリックすると設定が復元されます。保存されている Server Key は保持されます。

チェックアウト

Payment Method の手順で、お客様は支払い方法を選びます（既定では Midtrans）。Confirm Order の手順で、お客様にはあなたの説明文と、You will be redirected to the Midtrans payment page (GoPay, QRIS, ShopeePay, cards, bank transfer and more). という注記が表示されます。OpenCart はこの手順で注文を作成しますが、まだステータスはありません。お客様が Confirm Order をクリックすると、拡張機能は注文合計額について、ルピアの整数単位で Midtrans Snap トランザクションを作成します。注文明細、配送料、割引、税、お客様の請求先および配送先の情報も含まれ、お客様は Midtrans の支払いページに移動します。そこでお客様は、あなたの Midtrans アカウントで有効になっている任意の方法を選べます。OpenCart 4 では、お客様は支払い方法ブロックの Choose ボタンで、Payment method options ウィンドウから支払い方法を選択し、チェックアウトページ下部の Confirm Order をクリックします。

支払い後、お客様はストアに戻ります。戻りリンク自体では、注文が支払い済みになることはありません。注文が支払い済みになるのは、Midtrans が確認した後のみです。確認は、署名付きの通知によるか、お客様が戻ってきたときに Midtrans のステータス API に問い合わせることで行われます。その後、注文は通常の OpenCart の方法でステータスを得て、通常の注文メールと在庫の更新が行われ、お客様には OpenCart の注文完了ページが表示されます。後払いの支払いの場合、ページには We are waiting for Midtrans to confirm your payment. If you chose a bank transfer, virtual account or convenience store, please complete the payment using the instructions from Midtrans. You will receive an e-mail once the payment is confirmed. も表示されます。お客様が戻ったときに Midtrans に接続できない場合は、Payment confirmation ページに We are confirming your payment with Midtrans. The order will be updated automatically — please do not pay again. と表示され、Check again ボタンと Back to checkout ボタンが表示されます。

お客様が支払わずに Snap ページを離れた場合、The Midtrans payment was not completed. You can try again below. と表示されて、チェックアウトに戻ります。支払いが拒否されたか期限切れになった場合のメッセージは、Your Midtrans payment was declined or has expired. Please try again or choose another payment method. です。OpenCart 4 では、これらのメッセージはチェックアウトページの上部に表示されます。カートは保持されます。OpenCart 3 は Confirm Order の手順が表示されるたびに新しい注文を作成し、OpenCart 4 はチェックアウトの注文を 1 つ保持して同じ注文を再び支払います。いずれの場合も、拡張機能は同じカートのすべての注文を 1 回の支払いとして扱います。お客様が再度支払う場合、同じ金額の未使用または保留中の Snap が再利用されます（発行済みの仮想口座は有効なままです）。金額が変わっている場合は、まず保留中のトランザクションが Midtrans で期限切れになります。その間に以前の Snap が支払われていた場合は、その支払いが確認され、お客様は新しいトランザクションなしで成功ページに移動します。

OpenCart 4 は、成功ページが表示されるまで注文をチェックアウトに保持します。その注文が支払いなしで閉じられていた場合（たとえば支払いが拒否または期限切れになった、またはストアがキャンセルした場合）、お客様は Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. と表示されるチェックアウトに戻され、次の Confirm Order で新しい注文が支払われます。注文がすでに確定していて、その後カートが変わった場合、メッセージは Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. です。数量の変更を含むカートの変更は、独自の支払いを必要とする新しいカートとして扱われます。カートがすでに空になった後に注文の支払いが拒否または期限切れになった場合（たとえば仮想口座の支払い後）、お客様には The Midtrans payment of order #(number) was declined or has expired, so the order will not be shipped. To buy these items, please place a new order. が表示されます。

Midtrans が支払いを開始できない場合、お客様はボタンの上に短いメッセージが表示された Confirm Order の手順にとどまります: Could not connect to Midtrans. Please try again in a moment.、Midtrans payments are temporarily unavailable. Please choose another payment method or contact us.（たとえば Server Key が誤っている場合）、または Midtrans からの理由。技術的な理由はログに書き込まれます。

ストアがメンテナンスモードでも、通知は機能します。OpenCart 3 は支払い拡張機能のリクエストを通過させ、OpenCart 4 では、拡張機能が通知とお客様の戻りを通過させるスタートアップアクションを追加します。

この拡張機能は Snap Redirect のみを使用します。Snap のポップアップ、サイト上のカードフォーム、保存されたカードやワンクリック支払い、分割払いやプロモーションの設定（支払い方法は Midtrans ダッシュボードで設定します）、サブスクリプションには対応していません。カード支払いは即時に確定し、個別の承認とキャプチャはありません。

注文と返金

注文ステータス

No status (missing order): お客様は Midtrans に案内されましたが、まだ支払っていないか、Midtrans がまだ支払いを確認していません。Sales > Orders では、このような注文は Order Status フィルタを Missing Orders に設定した場合にのみ表示されます。

Awaiting Midtrans payment status（既定値保留中）: お客様が後払いの方法を選んだか、完了していないカード支払いを開始しました。Midtrans が支払いを報告すると、注文は Status after payment に移ります。

Status after payment（既定値処理中）: 支払いが確認されました。メモには、支払い方法、Midtrans の注文 ID、トランザクションが表示されます。

Midtrans payment on hold status（既定値保留中）: カード支払いが不正審査中です（challenge。まだ金額は記録されていません）。支払われた金額または通貨が注文と一致しなかったか（注文は支払い済みになりません）、キャンセルされた注文に対して支払いが届きました（注文は自動的には再オープンされません）。メモにその理由が説明されます。注文を確認し、処理するか、支払いを返金してください。

Payment expired / cancelled status（既定値キャンセル済み）: 保留中の注文の、未払いのトランザクションが期限切れになったか、キャンセルされました。

Payment failed status（既定値失敗）: 支払いが失敗したか、審査中のカード支払いが拒否されました。

Refunded status（既定値返金済み）: 支払いが全額返金されました。

OpenCart は、これらのステータス変更を通常の方法でお客様に通知します。同じカートに 2 回目の支払いが届いても、注文は変わりません。支払い済みの注文のメモには、Midtrans ダッシュボードで 2 回目の支払いを返金するよう表示されます。返金済みの注文への支払いは、メモが追加されるだけです。

メモは、お客様には表示されない注文の History のエントリです。

VibeFox Midtrans Payment Gateway タブ

Sales > Orders で、Midtrans で支払われた注文を開きます。注文ページの下部、History と Additional の横に、VibeFox Midtrans Payment Gateway タブが表示され、Midtrans order ID、支払い環境の Midtrans ダッシュボードのトランザクションにリンクされた Transaction ID（サンドボックスの支払いには Sandbox のラベル付き）、Payment method、Status、Paid / refunded の金額、返金フォーム、返金履歴、注文の Midtrans notes が表示されます。このタブは、拡張機能へのアクセス権があるユーザーに表示されます。

返金

VibeFox Midtrans Payment Gateway タブで、Amount（まだ返金されていない金額が自動入力されます）を入力し、必要に応じて Reason (optional) を入力して、Refund via Midtrans をクリックします。Refund this amount through Midtrans? This cannot be undone. という確認に同意してください。全額返金と一部返金は、ルピアの整数単位でサポートされています。小数を含む金額は拒否されます。拡張機能を変更する権限が必要です（System > Users > User Groups で設定します）。後から注文が編集されていても、Midtrans が実際に請求した金額まで返金できます。返金は支払いが行われた環境で送信されるため、その環境の Server Key が設定されている必要があります。Midtrans が API による返金を許可するのは、一部の支払い方法と決済済みのトランザクションのみです。Midtrans が返金を受け付けない場合、タブにエラーが表示され、返金は記録されません。その場合は Midtrans ダッシュボードで返金してください。成功した返金は、返金履歴とメモに追加されます。全額返金では、お客様に通知せず、商品を在庫に戻すこともなく、手動でのステータス変更と同様に注文を Refunded status にします。一部返金ではステータスは変わりません。返金は、Midtrans が支払いを決済済みと報告した後にのみ利用できます。

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

Midtrans ダッシュボードで行われた返金は、通知によって届き、理由 Refunded in the Midtrans dashboard とともに返金履歴に自動的に追加されます。そこで支払い全体が返金された場合、注文は Refunded status になります。

ライセンスキー

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

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

トラブルシューティング

チェックアウトに Midtrans が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、選択した Environment に Server Key があることを確認してください。チェックアウトの通貨が IDR であること、支払い先住所が選択された Geo Zone に含まれていること、注文が設定の Total に達していることも確認してください。キーがない場合やストアの通貨が IDR でない場合、設定ページに警告が表示されます。

支払いは完了したが、注文がステータスなしのまま: 通知が機能していません。使用している環境（サンドボックスまたは本番）の Midtrans ダッシュボードに支払い通知 URL が設定されていること、Notification URL に表示されている URL と正確に一致すること、そして到達可能であることを確認してください。ブラウザで開くと短い説明が表示されます。通知を確認するには Debug log をオンにしてください。お客様が支払い後にストアに戻ったときにも、注文はステータスを得ます。

通知が Invalid signature と応答する: 通知は、Sandbox または Production の Server Key で署名されていません。設定のキーが、通知を送信しているダッシュボードと同じ Midtrans アカウントのものかを確認してください。

通知が Server key not configured と応答する: Server Key が設定されていません。設定に入力してください。Midtrans は通知を再試行します。

通知が Order not found — ignored と応答する: Midtrans の注文 ID は、このストアによって発行されたものではありません。たとえば、同じ Midtrans アカウントの別のストアによるものです。各ストアに異なる Order ID prefix を設定してください。

通知が Environment mismatch — ignored と応答する: 通知は、支払いが行われた環境とは異なる環境のキーで署名されています。

通知が Verification failed, please retry と応答する: Midtrans のステータス API に接続できませんでした。Midtrans は通知を再試行します。

通知が Busy, please retry と応答する: カートが同じ時点で別のリクエストによって更新されていたか、注文ステータスを設定できませんでした。Midtrans は通知を再試行します。理由はログで確認してください。

注文が審査ステータスになっている: タブの Midtrans notes を読んでください。カード支払いが不正審査中であるか、支払われた金額または通貨が注文と一致しなかったか、または注文がキャンセルされた後に支払いが届きました。

お客様が Confirm Order の後にエラーを見る: 拡張機能ページの Log 欄を確認してください。エラーは常に記録されます。Server Key が誤っている場合は、Midtrans の支払いが一時的に利用できないというメッセージが表示されます。Midtrans only supports payments in IDR (Indonesian Rupiah). Please choose another payment method. は、注文が IDR でないことを意味します。This payment method is not available. は、チェックアウトのセッションが注文と一致しなくなったか、支払い方法がその間にオフにされたことを意味します。お客様はチェックアウトを再読み込みする必要があります。

お客様が Payment verification failed. とともにチェックアウトに戻る: 戻りリンクが不完全だったか、注文に属していませんでした。注文は、通知からステータスを得ます。

タブに返金フォームが表示されない: タブに理由が表示されます: 支払いがまだ決済されていないか、全額返金されているか、ユーザーグループに拡張機能を変更する権限がないか、または注文が支払われた環境の Server Key が設定されていません。

返金が失敗する: 支払い方法またはトランザクションの状態が API による返金を許可していません。Midtrans ダッシュボードで返金してください。返金は自動的に注文に記録されます。

開発者向け: Snap トランザクションが作成される前に、拡張機能はリクエストデータと注文とともに OpenCart イベント midtrans_p_snap_payload をトリガーします。注文 ID と金額は変更できません。

アンインストール

Extensions > Extensions に進み、種類 Payments を選択して、VibeFox Midtrans Payment Gateway の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは、常に削除されます。OpenCart は、拡張機能自身の設定を常に削除します: Enable/Disable、Sort Order、Geo Zone、Total、および Orders セクションの注文ステータス。これらは再インストール時に既定値に戻ります。拡張機能の OpenCart イベントも削除されます（OpenCart 4 では、そのイベントと、メンテナンスモードで通知を通過させるスタートアップアクションも削除されます）。Delete data on uninstall がオンの場合、残りのゲートウェイ設定（タイトル、説明、環境、Server Key、支払い設定、ログ記録）とログが削除されます。オフの場合は、後で再インストールするために保持されます。注文の Midtrans 支払い参照情報と返金は常に残るため、再インストール後も、以前に支払われた注文を返金できます。既存の注文は、支払いのメモを保持します。

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

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