VibeFox MakeCommerce for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

WooCommerce: 7.0 以降、インストール済みで有効化されていること。WooCommerce がない場合、プラグインは有効化されません。

PHP: 8.0 以降。

サイトへのインターネットアクセス: MakeCommerce は貴店に支払い通知を送信するため、サイトがインターネットからアクセス可能である必要があります（HTTPS を推奨）。ファイアウォール、メンテナンスモード、または基本認証によってこれらがブロックされる場合があります。

MakeCommerce アカウント: MakeCommerce Merchant Portal（Settings > API）から取得した Shop ID と Secret key が必要です。テスト環境と本番環境では、アカウントとキーが分かれています。利用可能な決済方法および通貨は、お客様の MakeCommerce 契約によって定義されます（バンクリンクは EUR 建てです）。KWD や BHD など、小数点以下 3 桁の通貨は提供されません。

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

インストール

1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP 経由で wcp_makecommerce_payment フォルダーを /wp-content/plugins/ にアップロードすることもできます。

2. Activate をクリックします。

3. 設定を開きます: WooCommerce > Settings > Payments > MakeCommerce > Manage に進むか、プラグイン一覧ページのプラグイン名の下にある Settings をクリックします。

4. ページ上部にあるライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。

5. テスト環境の Shop ID と Secret key を入力し、実際の支払いのために本番キーを入力します（「設定」を参照）。Merchant Portal 側で設定する必要がある項目はありません。

6. Enable/Disable をオンにします。Test mode をオンにして支払いをテストし、問題がなければチェックを外して実際の支払いを受け付けます。

設定

すべての設定は 1 つのページにまとまっています: WooCommerce > Settings > Payments > MakeCommerce。テストモードが有効になっている間、項目の上部に Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged. と表示されます。決済方法が有効化されているにもかかわらず現在の環境の Shop ID または Secret key が空である場合、またはストア通貨が MakeCommerce で請求できない場合に警告が表示されます。どちらの場合も、該当する決済方法はチェックアウト時に非表示になります。決済方法の一覧では、現在の環境にキーが設定されるまで MakeCommerce は設定が必要であると表示されます。保存時にキーから空白文字が自動的に除去されます。

General

Enable/Disable: Enable MakeCommerce payments で決済方法を有効または無効にします。デフォルト: オフ。

Title: チェックアウト時に購入者に表示される決済方法の名前。デフォルト: Bank link or card (MakeCommerce)。

Description: チェックアウト時に決済方法の下に表示されるテキスト。デフォルト: Pay with your Estonian, Latvian, Lithuanian or Finnish bank, or by card. You will be redirected to the secure MakeCommerce payment page.

MakeCommerce account

Shop ID と Secret key は、MakeCommerce Merchant Portal の Settings > API 内にあります。テストポータルと本番ポータルはアカウントおよびキーが分かれています。このセクションには、両ポータルおよび MakeCommerce の登録ページへのリンクがあります。

Test mode: Use the MakeCommerce test environment (no real money is charged)。新規の支払いは、選択された環境でその環境のキーを使用して作成されます。各注文はどの環境で支払われたかを記憶しており、ステータス確認および返金は常にその環境に対して行われます。チェックアウト時には 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。

Payment notifications

Merchant Portal 側で設定する必要がある項目はありません。各取引は、このセクションに表示されるアドレス（https://your-site/wc-api/wc_mkc_payment/ のような形式）に注文番号と注文キーを追加した、独自の復帰用、キャンセル用、および通知用 URL を保持します。MakeCommerce は通知用 URL に（サーバー間通信で）署名付きメッセージを送信し、購入者のブラウザを通じて復帰用またはキャンセル用 URL に送信します。署名は、取引が作成された環境の Secret key で検証されます。有効な署名のないメッセージは拒絶されます。

本プラグインは、MakeCommerce の以下の取引ステータスを処理します:

支払いは、購入者がストアに戻った際にも確認されます。購入者が署名付きメッセージなしで戻った場合、プラグインは MakeCommerce API にステータスを照会します。

Advanced

Debug log: Log API calls and payment notifications は、WooCommerce > Status > Logs のソース wcp_makecommerce_payment に詳細を書き込みます。エラーは常に記録されます。キーや購入者のデータがログに記録されることは一切ありません。デフォルト: オフ。

Delete data: Delete the gateway settings and logs when the plugin is deleted。注文およびその支払いメモは常に保持されます。プラグインを無効化してもデータが削除されることはありません。デフォルト: オフ。

チェックアウト

購入者は決済方法（デフォルトでは Bank link or card (MakeCommerce)）を選択し、注文を行います。プラグインは注文通貨で注文合計金額に対する MakeCommerce 取引を作成し、購入者を MakeCommerce の決済ページへ誘導します。そこで購入者はバンクリンクまたはカードを選択します。請求先メールアドレスと国情報が MakeCommerce に渡され、MakeCommerce がサポートしている場合はストアの言語（エストニア語、英語、ラトビア語、リトアニア語、フィンランド語、ロシア語、ドイツ語、ポーランド語）でページが開き、それ以外の場合は英語で開きます。

支払い後、購入者は貴店の注文完了（Order received）ページに戻ります。注文は、MakeCommerce が確認した後にのみ支払い済みとしてマークされます。これには、署名付き通知、または購入者の署名付き復帰と MakeCommerce API を通じた取引の確認が用いられます。

購入者が MakeCommerce ページでキャンセルした場合、または支払いの有効期限が切れた場合、購入者はメッセージ（例: The payment was cancelled. You can try again or choose another payment method. または The payment session expired. Please try again.）とともにチェックアウト（または Pay for order ページ）に戻ります。支払いをまだ確認できない場合のメッセージは、We could not confirm your payment yet. If you completed it, your order will be updated automatically; otherwise please try again. となります。購入者は再度支払うことができます。同じ注文の過去の支払いリンクも機能し続け、注文が二重に支払われることはありません。

MakeCommerce が支払いを開始できない場合、購入者には 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. と表示されます。技術的な理由は注文メモとログに追加されます。

この決済方法は、クラシックチェックアウト、チェックアウトブロック、および Pay for order ページで動作します。WooCommerce 高性能注文ストレージ（HPOS）に対応しています。

銀行またはカードの選択は貴店のチェックアウトではなく、MakeCommerce のページ上で行われます。本プラグインには、保存済みカード、定期支払い、WooCommerce Subscriptions、および MakeCommerce 配送（宅配ロッカー、配送ラベル）の機能はありません。

注文と返金

注文ステータス

Pending payment: 購入者が MakeCommerce にリダイレクトされ、まだ支払いを完了していないか、MakeCommerce がまだ支払金を確認していません。注文メモには、MakeCommerce の取引、金額、環境が表示されます。

Processing: 支払いが確認されました。仮想ダウンロード商品のみを含む注文は、WooCommerce のデフォルト動作に従い「完了（Completed）」になります。注文メモには、金額、取引、環境、および検証方法（MakeCommerce API または署名付き通知）が表示されます。取引 ID は MakeCommerce 取引 ID です。

On hold: 支払額または通貨が注文と異なっていた、金額が不足していた、MakeCommerce での取引ステータスがまだ確定していなかった、あるいはキャンセルされた注文に対して支払いが届いた状態です。注文メモにその理由が記載されます。このような取引が後から注文を自動的に支払い済みにすることはありません。Merchant Portal で取引を確認し、手動で注文を完了するか返金してください。

Failed: 注文に対する最新の支払いがキャンセルされたか、期限切れになったか、失敗しました。購入者は再度支払うことができます。

既に支払い済みの注文に対して 2 回目の支払いが届いた場合、注文は再度変更されることはありません。重複分を MakeCommerce Merchant Portal で返金するよう促すメモが追加されます。

Check MakeCommerce payment status

注文画面で、注文アクションの Check MakeCommerce payment status を選択します。プラグインは MakeCommerce API に注文の取引ステータス（最新のものを優先）を照会して適用し、結果をメモに追加します。購入者が支払ったにもかかわらず注文が「支払い待ち」のままになっている場合に使用します。

返金

注文を開き、Refund をクリックして金額を入力し、Refund via Bank link or card (MakeCommerce) をクリックします（ボタンには貴店の Title が表示されます）。全額返金と一部返金に対応しています。返金は注文が支払われた環境（テストまたは本番）に送信されるため、その環境のキーが設定されている必要があります。MakeCommerce が返金を受け付けない場合、WooCommerce はエラーを表示し、メモが追加され、返金は記録されません。MakeCommerce が支払いをまだ処理中の場合のメッセージは、MakeCommerce is still processing this payment — try the refund again later. となります。正常に完了した返金は、MakeCommerce 返金 ID とともに注文メモに追加されます。

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

ライセンスキー

プラグインは vibefox.net の VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Payments > MakeCommerce の上部にあります。キーを License key に貼り付け、Activate をクリックします。ブロックにはステータス（ライセンスの有効期限やお客様のドメインなど）が表示されます。ステータスを再確認するには Check now、別のキーを入力するには Change key、このサイトから削除するには Remove key を使用します。Manage licenses and domains in your account リンクから vibefox.net のアカウントページが開きます。

1 つのキーは 1 つのドメインで機能します。サイトからキーを削除しても、そのドメインのスロットは解放されません。ドメインスロットの解放は vibefox.net アカウントで行ってください。

有効なキーがない場合、チェックアウト時に購入者へ MakeCommerce は表示されません。何らかの方法で支払いが開始された場合、購入者には This payment method is not available. Please choose another one. と表示されます。ログインしているストア管理者には、キーを購入する前にプラグインを設定およびテストできるように、(unlicensed — visible to admins only) とマークされた状態で決済方法が表示され続けます。プラグイン一覧ページや WooCommerce の各ページに通知が表示されます。既存の注文への影響はありません。既に開始されている支払いは引き続き確認され、返金も動作します。

ライセンスの有効期限が切れてもプラグインは動作し続けますが、アップデートとサポートを受けるには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。

トラブルシューティング

チェックアウトに MakeCommerce が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在の環境のキー（テストモードでは Test Shop ID と Test Secret key、本番モードでは Live Shop ID と Live Secret key）が設定されていることを確認してください。ストア通貨（または Pay for order ページでの注文通貨）の小数点以下の桁数が 2 桁以下であることを確認してください。設定ページには、これらの問題ごとに警告が表示されます。

支払いは完了したが、注文が「支払い待ち」のままになる: ファイアウォール、メンテナンスモード、または基本認証などの理由で、通知がサイトに届きませんでした。注文を開き、注文アクション Check MakeCommerce payment status を実行してください。支払いが行われた環境のキーが設定されているか確認してください。通知はその環境の Secret key で検証され、設定されていない場合 MakeCommerce はエラーを受け取って再試行します。

注文が MakeCommerce のメモ付きで「保留中」になっている: 支払いが注文内容（金額、通貨、ステータス）と一致しなかったか、キャンセルされた注文に対する支払いが届きました。Merchant Portal で取引を確認し、手動で注文を完了するか返金してください。

通知が拒絶される: 署名が無効なメッセージ、別の注文宛て、別のストア宛て、または該当の注文用に作成されていない取引に関するメッセージは拒絶され、注文は変更されません。Shop ID と Secret key が同一の MakeCommerce アカウントおよび環境のものであるか確認してください。

注文時に購入者にエラーが表示される: 注文メモを開くか、Debug log をオンにして WooCommerce > Status > Logs のソース wcp_makecommerce_payment を確認してください。MakeCommerce で請求できない通貨の場合、MakeCommerce cannot process payments in と通貨コードが表示されます。

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

No MakeCommerce transaction ID found for this order で返金に失敗する: 注文に MakeCommerce の取引が存在しません。Merchant Portal で返金を行ってください。

ライセンスブロックにエラーが表示される: ブロック内のメッセージに従ってください。たとえば、キーが既に別のドメインで使用されている場合は、vibefox.net アカウントでスロットを解放してから Check now をクリックします。サイトのアドレスが変更された場合は、Check now をクリックして新しいドメイン用にキーを有効化します。ライセンスサーバーにアクセスできない場合、プラグインは最後に確認された有効なステータスで動作を継続します。

アンインストール

プラグインを無効化してもすべてのデータは保持されます。完全に削除するには、Plugins ページでプラグインを無効化して削除してください。このプラグインのライセンスキーとライセンスステータスは常に削除されます。決済ゲートウェイの設定およびログは、Delete data がオンになっていた場合にのみ削除されます。それ以外の場合は、後での再インストールに備えて保持されます。既存の注文は支払いメモと取引 ID をそのまま維持します。

MakeCommerce はそれぞれの所有者の商標です。本プラグインは MakeCommerce と提携しておらず、また MakeCommerce による推奨を受けたものでもありません。