VibeFox MakeCommerce for OpenCart — ヘルプ

要件

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

PHP：8.0 以降。

ストアのインターネット接続：MakeCommerce は支払い通知をお使いのストアに送信するため、サイトがインターネットから到達可能である必要があります。ファイアウォールやベーシック認証によって通知がブロックされることがあります。メンテナンスモードでもブロックされません。OpenCart 3 は支払い拡張機能のリクエストを通過させ、OpenCart 4 では、拡張機能が通知のためのスタートアップアクションを追加します。

MakeCommerce アカウント：MakeCommerce Merchant Portal（Settings > API）の Shop ID と Secret key が必要です。テスト環境と本番環境には、別々のアカウントとキーがあります。利用できる支払い方法と通貨は、MakeCommerce との契約によって定められます。KWD や BHD のような小数点以下 3 桁の通貨は提供されません。

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

インストール

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

OpenCart 3

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

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

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

4. テスト環境の Shop ID と Secret key を入力し、実際の支払いを受け付ける場合は本番用のキーを入力します（「設定」を参照）。Merchant Portal で設定することは何もありません。

5. Enable/Disable をオンにして Save をクリックします。Test mode をオンにした状態で支払いをテストし、その後オフにして実際の支払いを受け付けます。

OpenCart 4

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

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

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

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

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

設定

すべての設定は拡張機能のページにあります：Extensions > Extensions > Payments > VibeFox MakeCommerce Payment > Edit。セクションは左側に並んでおり、一覧の下にある Save ボタンでページ全体が保存されます。設定の上部には、テストモードがオンの間、Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged. と表示されます。支払い方法が有効なのに現在の環境の Shop ID または Secret key が空の場合（その場合、支払い方法はチェックアウトで非表示になります）、また、ストアの既定の通貨を MakeCommerce で請求できない場合（その場合、その通貨の注文では支払い方法が非表示になります）にも、警告が表示されます。拡張機能を変更する権限がない場合、ページには設定が表示されますが、保存はできません。

保存時、Title は空にできず、128 文字以内である必要があります。Sort Order は整数（負の数も可）、Total は 0 以上の数値である必要があり、すべての注文ステータスが存在している必要があります。項目に誤りがある場合は何も保存されず、ページにその項目が表示されます。Shop ID とキーのスペースは保存時に削除されます。

MakeCommerce

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

Title：チェックアウトで顧客に表示される支払い方法の名前です。注文に保存される支払い方法名にもなります。既定値：Bank link or card (MakeCommerce)。必須、128 文字以内。

Description：Confirm Order のステップで、確認ボタンの上に顧客に表示されるテキストです。既定値：Pay with your Estonian, Latvian, Lithuanian or Finnish bank, or by card. You will be redirected to the secure MakeCommerce payment page.

Sort Order：チェックアウトの支払い方法の中で MakeCommerce が表示される順番です。空欄のままにするか、整数を入力します。

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

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

MakeCommerce アカウント

Shop ID と Secret key は、MakeCommerce Merchant Portal の Settings > API にあります。テストポータルと本番ポータルには、別々のアカウントとキーがあります。このセクションには、両方のポータルと MakeCommerce のサインアップページへのリンクがあります。

Test mode：MakeCommerce のテスト環境を使用します（実際の料金は請求されません）。新しい支払いは、選択した環境とそのキーで作成されます。各注文は、支払いが行われた環境を記憶しています。ステータスの確認と返金は、常にその環境に対して行われます。オンの間、顧客には Confirm Order のステップで TEST MODE — MakeCommerce test environment, no real money is charged. と表示されます。既定値：オン。

Test Shop ID：テストアカウントの Shop ID です。形式は xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx です。

Test Secret key：テストアカウントの Secret key です。支払いメッセージの署名と検証に使用されます。

Live Shop ID：本番アカウントの Shop ID です。形式は同じです。

Live Secret key：本番アカウントの Secret key です。

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

支払い通知

Merchant Portal で設定することは何もありません。Callback URLs には、参考として、顧客の戻りまたはキャンセルのアドレスと、支払い通知のアドレスが表示されます。これらは、OpenCart のインストール先のストアアドレスから作成されます。OpenCart 3 では https://your-store/index.php?route=extension/payment/wcp_makecommerce_payment/notification、OpenCart 4 では https://your-store/index.php?route=extension/wcp_makecommerce_payment/payment/wcp_makecommerce_payment.notification のような形式です。すべての取引には、これらのアドレスに注文番号とキーを追加した、独自の戻り、キャンセル、通知の URL が含まれます。MakeCommerce は、署名付きのメッセージを通知 URL に（サーバー間で）送信し、顧客のブラウザーを通じて戻りまたはキャンセルの URL にも送信します。署名は、その取引が作成された環境の Secret key で検証されます。有効な署名のないメッセージは拒否されます。

この拡張機能は、次の MakeCommerce 取引ステータスを処理します：

顧客がストアに戻ったときにも、支払いは確定されます。顧客が署名付きのメッセージなしで戻った場合、拡張機能は MakeCommerce API にステータスを問い合わせます。

注文

OpenCart は、Confirm Order のステップで注文を（ステータスなしの注文、つまり欠落注文として）作成します。注文は、MakeCommerce が支払いを確定した後（署名付きの通知、または顧客の署名付きの戻りと、MakeCommerce API による再確認）にのみステータスを取得します。以下の各欄には、OpenCart の注文ステータスが表示されます。

Order Status After Payment：検証済みの MakeCommerce 支払い後のステータスです。既定値：Processing（処理中）。

Payment On Hold Status：支払いには手動での確認が必要です。支払われた金額または通貨が注文と異なる、MakeCommerce でまだ取引が確定していない、または注文がキャンセルされた後に入金があった、といった場合です。メモに理由が記録されます。既定値：Pending（支払い待ち）。OpenCart には保留（On hold）ステータスがないためです。System > Localisation > Order Statuses で独自のステータスを作成し、ここで選択できます。

Cancelled Order Status：ストアで「キャンセル」を意味するステータスです。そのような注文に届いた MakeCommerce の支払いは、注文を保留にします。拡張機能がこのステータスを自分で設定することはありません。既定値：Canceled（キャンセル）。

Refunded Status：注文ページから支払いが全額返金された後に設定されます。既定値：Refunded（返金済み）。

詳細設定

Debug log：API の呼び出しと支払い通知を、OpenCart のログフォルダ（storage/logs）内の wc_mkc_debug.log.php に記録します。このファイルは Web から開くことはできません。エラーは常に記録されます。キーと顧客データは決して記録されません。既定値：オフ。

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

Delete data：オンにすると、拡張機能をアンインストールしたときに拡張機能の設定とログが削除されます。注文と、その MakeCommerce の支払いデータは、常に保持されます。既定値：オフ。

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

Export：Download JSON で、設定を JSON ファイルとして保存します。Shop ID と Secret key はエクスポートされません。

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

チェックアウト

Payment Method のステップで、顧客は支払い方法を選択します（既定では Bank link or card (MakeCommerce)）。Confirm Order のステップで、顧客はあなたの説明を見ます。OpenCart は、このステップで注文を作成しますが、この時点ではまだステータスはありません。顧客が Confirm Order をクリックすると、拡張機能は注文通貨での注文合計に対する MakeCommerce の取引を作成し、顧客を MakeCommerce の支払いページに移動させます。そこで顧客は銀行リンクまたはカードを選択します。OpenCart 4 では、顧客は支払い方法ブロックの Choose ボタンで、Payment method options ウィンドウから支払い方法を選択し、チェックアウトページ下部の Confirm Order をクリックします。顧客のメールアドレスと国は MakeCommerce に渡され、MakeCommerce がストアの言語に対応している場合（エストニア語、英語、ラトビア語、リトアニア語、フィンランド語、ロシア語、ドイツ語、ポーランド語）は、その言語でページが開きます。対応していない場合は英語で開きます。

支払い後、顧客はストアに戻ります。注文は、MakeCommerce が確定した後にのみ支払い済みとしてマークされます。確定は、署名付きの通知によるか、顧客の署名付きの戻りと MakeCommerce API による取引の確認によって行われます。その後、注文は OpenCart の標準的な方法でステータスを取得し、通常の注文メールと在庫の更新が行われ、顧客には Your MakeCommerce payment has been received. と表示された OpenCart の注文完了ページが表示されます。注文がレビューステータスになった場合、ページには Your MakeCommerce payment was received and is being reviewed by the store. が表示されます。

支払いが承認されたもののまだ完了していない場合、注文が別のリクエストによって同時に確定されている場合、または MakeCommerce に接続できない場合は、Payment confirmation ページに We could not confirm your payment yet. If you completed it, your order will be updated automatically — please do not pay again. と、Check again および Back to checkout のボタンが表示されます。Check again は、MakeCommerce に注文の最新の取引のステータスを問い合わせます。通知は、支払いが完了するとすぐに注文ステータスを設定します。

顧客が MakeCommerce のページでキャンセルしたり、支払いの期限が切れたり失敗したりした場合、顧客はチェックアウトに戻り、次のようなメッセージが表示されます：The payment was cancelled. You can try again or choose another payment method.、The payment session expired. Please try again.、または The payment was not completed. Please try again or choose another payment method. カートは保持され、顧客は再度支払うことができます。OpenCart 4 では、これらのメッセージはチェックアウトページの上部に表示されます。試行のたびに新しい MakeCommerce 取引が作成されます（OpenCart 3 は、Confirm Order のステップが表示されるたびに新しい注文を作成し、OpenCart 4 はチェックアウトの注文を保持して同じ注文を再び支払います）。新しい取引の前に、同じカートの未完了の試行が MakeCommerce で確認されます。そのいずれかがすでに支払い済みであれば、顧客は直接成功ページに進みます。同じカートの以前の支払いリンクも引き続き機能しますが、カートが 2 つの注文に支払われることはありません。支払い済みのカートの古い注文に対する遅延した支払いは、支払い済みの注文にメモを追加するだけです。

OpenCart 4 は、成功ページが表示されるまで注文をチェックアウトに保持します。その注文が支払いなしで閉じられていた場合（たとえばストアがキャンセルした場合）、顧客は Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. と表示されるチェックアウトに戻され、次の Confirm Order で新しい注文が支払われます。そのような注文は、支払われた後にキャンセルされた場合でも、カートを保持しません。

MakeCommerce が支払いを開始できない場合、顧客は Confirm Order のステップに留まり、MakeCommerce is temporarily unavailable. Please try again in a moment or choose another payment method. または MakeCommerce could not start the payment for this order. Please choose another payment method or contact us. が表示されます。技術的な理由はログに書き込まれます。

銀行またはカードは、チェックアウトではなく MakeCommerce のページで選択されます。この拡張機能には、保存されたカード、定期支払い、サブスクリプションはなく、MakeCommerce を通じた配送（宅配ロッカー、伝票）もありません。

注文と返金

注文ステータス

ステータスなし（欠落注文）：顧客は MakeCommerce に移動したものの支払っていない、支払いがキャンセル、期限切れ、または失敗した、あるいは MakeCommerce がまだ支払いを確定していない状態です。Sales > Orders では、このような注文は Order Status フィルターを Missing Orders に設定した場合にのみ表示されます。

Order Status After Payment（既定値 Processing）：支払いが確定しました。メモには、金額、取引、環境、そして確認方法（MakeCommerce API または署名付きの通知）が表示されます。

Payment On Hold Status（既定値 Pending）：支払われた金額または通貨が注文と異なった、金額が欠けていた、MakeCommerce の取引が完了と報告されたものの、まだ確定していなかった、または注文がキャンセルされた後に支払いが届いた、のいずれかです。メモにその理由が記録されます。金額が一致しない取引が後から注文を支払うことはありません。まだ確定していなかった取引は、MakeCommerce が完了を報告したときに注文を完了させます。Merchant Portal で取引を確認し、注文を処理するか、支払いを返金してください。

Refunded Status（既定値 Refunded）：この拡張機能を通じて支払いが全額返金されました。

すでに支払い済みの注文に対して 2 回目の支払いが届いた場合、注文は変更されません。メモで、MakeCommerce Merchant Portal で重複分を返金するよう求められます。返金済みの注文、または別の支払い方法に切り替えられた注文に対する支払いは、メモを追加するだけです。

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

VibeFox MakeCommerce Payment タブ

Sales > Orders で、MakeCommerce で支払われた注文を開きます。注文ページの下部、History と Additional の隣に、VibeFox MakeCommerce Payment タブが表示されます。このタブには、注文のすべての MakeCommerce 取引（日付、取引 ID、テスト支払いの Test ラベル、金額、MakeCommerce のステータスと結果）、Paid / refunded の金額、返金フォーム、返金履歴、注文の MakeCommerce notes が表示されます。このタブは、この拡張機能へのアクセス権があるユーザーに表示されます。そのボタンは、拡張機能を変更する権限を必要とします（System > Users > User Groups で設定します）。

Check MakeCommerce payment status：注文の取引のステータス（最新のものから）を MakeCommerce API に問い合わせ、その結果を適用して、結果とともにメモを追加します。顧客が支払ったと言っているのに注文にステータスがないときに使用してください。

返金

VibeFox MakeCommerce Payment タブで Amount を入力します（まだ返金されていない金額が自動入力されます）。必要に応じて Reason (optional) を入力し、Refund via MakeCommerce をクリックします。Refund this amount via MakeCommerce? の確認に応じます。全額返金と部分返金に対応しています。返金は MakeCommerce 取引の金額と通貨に限られるため、金額に不一致があった場合、注文の合計ではなく、顧客が実際に支払った金額まで返金できます。返金は、支払いが行われた環境（テストまたは本番）に送信されるため、その環境のキーが設定されている必要があります。理由は、返金のコメントとして MakeCommerce に送信されます。理由がない場合、コメントは Refund for order と注文番号になります。MakeCommerce が返金を受け付けない場合、タブにエラーが表示され、メモが追加され、返金は記録されません。MakeCommerce がまだ支払いを処理中の場合、メッセージは MakeCommerce is still processing this payment — try the refund again later. です。返金が成功すると、返金履歴とメモに MakeCommerce の返金 ID が追加されます。全額返金の場合、注文は顧客に通知されず、手動でのステータス変更と同様に商品も在庫に戻さずに、Refunded Status になります。部分返金ではステータスは変わりません。返金は、MakeCommerce が支払いを確定した後に利用できます。

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

Merchant Portal で行われた返金は、取引のステータスとともに届き、メモに追加されます。注文ステータスは自動的には変更されません。

ライセンスキー

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

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

トラブルシューティング

MakeCommerce がチェックアウトに表示されない：ライセンスが有効であること、Enable/Disable がオンであること、現在の環境にキーがあることを確認してください。テストモードでは Test Shop ID と Test Secret key、本番モードでは Live Shop ID と Live Secret key です。注文の通貨の小数点以下が 2 桁以内であること、支払い先住所が選択された Geo Zone にあること、注文が設定の Total に達していることを確認してください。

支払いは完了したが、注文にステータスがない：通知がストアに届かなかったためです。たとえばファイアウォールやベーシック認証が原因の場合があります。顧客がストアに戻ったとき、Check again をクリックしたとき、または注文のタブで Check MakeCommerce payment status をクリックしたときにも、注文はステータスを取得します。支払いが行われた環境のキーが設定されていることを確認してください。通知はその環境の Secret key で検証されるため、キーがないと MakeCommerce はエラーを受け取り、再試行します。通知を確認するには Debug log をオンにしてください。

注文がレビューステータスになっている：注文のタブにある MakeCommerce notes を読み（「注文ステータス」を参照）、Merchant Portal で取引を確認してから、注文を処理するか、支払いを返金してください。

通知が拒否される：署名が誤っている、別の注文、別のストア、または注文用に作成されていない取引に関するメッセージは拒否され、何も変更されません。Shop ID と Secret key が同じ MakeCommerce アカウントと環境に属していることを確認してください。

顧客が Confirm Order の後にエラーを見る：Debug log をオンにし、拡張機能のページにある Log の欄を確認してください。This payment method is not available. Please reload the checkout page. は、チェックアウトのセッションが注文と一致しなくなったか、その間に支払い方法がオフにされたことを意味します。顧客はチェックアウトを再読み込みする必要があります。MakeCommerce が請求できない通貨の場合は、MakeCommerce cannot process payments in と通貨コードが表示されます。

環境に関するメッセージで返金に失敗する：注文はテストまたは本番環境で支払われましたが、その環境のキーが設定されていません。入力してから再試行してください。

タブに返金フォームがない：タブに理由が表示されます。支払いがまだ確定していない、全額返金済み、ユーザーグループにこの拡張機能を変更する権限がない、注文が別の支払い方法に切り替えられた、または支払いの環境のキーが設定されていない、のいずれかです。

開発者向け：この拡張機能は OpenCart イベント wc_mkc_transaction_data、wc_mkc_customer_data、wc_mkc_supported_locales、wc_mkc_is_available を呼び出し、取引データ、顧客データ、支払いページの言語、および支払い方法の利用可否を変更します。

アンインストール

Extensions > Extensions を開き、種類として Payments を選択して、VibeFox MakeCommerce Payment の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは常に削除されます。OpenCart は、拡張機能自身の設定を常に削除します。Enable/Disable、Sort Order、Geo Zone、Total、そして Orders セクションの注文ステータスです。これらは再インストール時に既定値に戻ります。拡張機能の OpenCart イベントも削除されます（OpenCart 4 では、そのイベントと、メンテナンスモードで通知を通過させるスタートアップアクションも削除されます）。Delete data がオンの場合、その他の設定（タイトル、説明、テストモード、Shop ID、Secret key、デバッグログ）とログが削除されます。オフの場合は、後で再インストールするために保持されます。MakeCommerce の取引と返金は常に保持されるため、以前に支払われた注文は再インストール後も返金できます。既存の注文は、支払いのメモを保持します。

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

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