VibeFox Mollie for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

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

PHP: 8.0 以降。

ストアの通貨: Mollie が対応している通貨のいずれか: AED, AUD, BGN, BRL, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF, ILS, ISK, JPY, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TWD, USD, ZAR。その他の通貨の場合、この決済方法はチェックアウトで表示されません。Mollie が提供する決済方法は、通貨とお使いのアカウントによって異なります。

サイトのインターネット接続: Mollie はウェブフックをストアに送信するため、サイトはインターネットから到達可能である必要があります。ウェブフックがなくても、購入者が Mollie から戻ったときに注文は更新されます。

Mollie アカウント: Mollie Dashboard > Developers > API keys から API キーを取得する必要があります。テスト用キーは test_ で、本番用キーは live_ で始まります。決済方法そのものは、Mollie アカウントで有効にします。

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

インストール

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

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

3. 設定を開きます: WooCommerce > Settings > Payments > Mollie > Manage、またはプラグインページのプラグイン名の下にある Settings をクリックします。

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

5. テスト用と本番用の API キーを入力します（設定を参照）。Mollie でウェブフックを設定する必要はありません。

6. Enable/Disable をオンにします。テスト決済を行うまで Test Mode はオンのままにし、その後オフにします。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > Mollie。フィールドの上には、Mollie が有効なのに現在のモードの API キーが空の場合や、Mollie がストアの通貨に対応していない場合に警告が表示されます。どちらの場合も、この決済方法はチェックアウトで表示されません。決済方法の一覧では、現在のモードに API キーが設定されるまで Mollie に設定が必要と表示され、テストモードがオンの間は Test mode と表示されます。

保存時、test_ または live_ で始まり、その後に 30 文字以上の英数字が続かない API キーは保存されません。エラーが表示され、以前の値が残ります。

チェックアウト

Enable/Disable: Enable Mollie Gateway で決済方法のオン／オフを切り替えます。既定値: オフ。

Title: チェックアウトで購入者に表示される決済方法のタイトル。既定値: Mollie。

Description: チェックアウトで購入者に表示される決済方法の説明。既定値: Pay securely via Mollie。

API キー

API キーは Mollie Dashboard > Developers > API keys にあります。ウェブフックの設定は不要です。プラグインは決済ごとにウェブフック URL を送信します。URL はこのセクションに表示され、次のような形式です: https://your-site/?wc-api=molg_mollie_webhook。URL はインターネットから到達可能である必要があります。そうでない場合、注文は購入者が Mollie から戻ったときにのみ更新されます。

Test Mode: Enable test mode を選ぶと、新しい決済にテスト用 API キーが使われます。実際の決済は処理されません。Mollie のテスト決済ページでは結果（paid、failed、cancelled、expired）を選べます。購入者はチェックアウトで Test mode: no real payment will be made. と表示されます。別のモードで行われた決済は、ステータス確認と返金に、そのモードのキーを引き続き使用します。既定値: オン。

Test API Key: Mollie のテスト用 API キー（test_ で始まります）。

Live API Key: Mollie の本番用 API キー（live_ で始まります）。

注文

Order Status After Payment: 決済が成功した後に設定される注文ステータス。ステータスは一度の変更で設定され、2 回目のステータス変更は行われません。

詳細設定

Logging: Enable debug logging を選ぶと、API 呼び出しとウェブフックが WooCommerce > Status > Logs に、ソース wcp_mollie_gateway として書き込まれます。エラーは常に記録されます。API キーと購入者データは一切記録されません。既定値: オフ。

Delete Data on Uninstall: Remove the plugin settings and logs when uninstalling。オンにすると、プラグインを削除したときに、プラグインの設定とログファイルも削除されます。注文に保存されている Mollie の決済 ID は残ります。既定値: オフ。

チェックアウト

購入者は決済方法（既定では Mollie）を選んで注文します。プラグインは、注文の通貨で注文合計額の Mollie 決済を作成し（JPY と ISK は小数点なし）、説明に Order # と注文番号を付けて、購入者を Mollie のホスト型決済ページに送ります。購入者はそこで、Mollie アカウントで有効になっている決済方法から 1 つを選び、支払いを行います。

Mollie のウェブフックには署名がなく、決済 ID だけが含まれます。そのためプラグインは、ウェブフックをそのままでは信頼しません。貴店の API キーを使って Mollie API から決済を取得し、その決済が注文に属しているか確認し、支払われた金額と通貨を注文と比較します。このようにして Mollie が確認した後にのみ、注文は支払い済みになります。プラグインは次の Mollie 決済ステータスを処理します:

購入者が戻ると、プラグインは同じ方法で Mollie API を使って直近の決済を確認します。支払い済みの決済の場合は注文受付ページに進みます。決済がキャンセル、失敗、期限切れ、または未完了の場合、購入者は次のようなメッセージとともに Pay for order ページに移動します。例: You cancelled the Mollie payment. You can try again or choose another payment method. または The Mollie payment has expired. Please try again or choose another payment method.

購入者が再度支払う場合、同じ金額でまだ有効な Mollie の決済が再利用され、2 つ目の支払い可能な決済は作成されません。注文合計が変更された場合は、Mollie が許可するときに、古い有効な決済が Mollie でキャンセルされます。古い決済がその間に支払われていた場合は、新たな決済なしで注文が支払い済みになります。

Mollie が決済を開始できない場合、購入者には次のような短いメッセージが表示されます。例: The payment provider could not be reached. Please try again in a moment.、This payment method is temporarily unavailable. Please choose another payment method.（API キーが誤っている場合）、または Mollie cannot accept a payment of this amount or currency. Please choose another payment method. 技術的な理由は注文メモとログに追加されます。

この決済方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで機能します。WooCommerce High-Performance Order Storage（HPOS）に対応しています。

購入者は、貴店のチェックアウトではなく Mollie のページで Mollie の決済方法を選びます。本プラグインには、定期決済やサブスクリプション、保存済みカードやマンデート、Mollie Components（貴サイト上のカード入力欄）、Apple Pay や PayPal のエクスプレスボタン、Orders API はありません。そのため、注文明細を必要とする決済方法（例: Klarna、Billie、in3 の一部のバリエーション）は、これらの決済に対して Mollie では提供されません。承認済みの決済は、WooCommerce ではなく Mollie Dashboard でキャプチャまたは取り消しします。

注文と返金

注文ステータス

Pending payment: 購入者は Mollie に移動しましたが、まだ支払いを行っていません。

Processing or Completed: 決済が確認されました。ステータスは Order Status After Payment に従います。注文メモには、Mollie の決済、決済方法、モードが表示されます。トランザクション ID は、注文の支払いに使われた Mollie の決済 ID（tr_...）です。

On hold: 銀行振込が入金を待っている、承認済みの決済がキャプチャを待っている、または Mollie がチャージバックを報告した場合に設定されます。支払われた金額または通貨が注文と異なる場合、ストアが本番モードの間にテスト決済が支払われた場合（入金はありません）、キャンセルされた後に決済が届いた場合にも保留になります。注文メモに理由が説明されます。Mollie Dashboard で決済を確認し、その後に注文を処理するか、決済を返金してください。

Failed: 直近の決済の試行が失敗した、期限切れになった、またはキャンセルされました。支払い済みの注文は決して変更されません。購入者は再度支払うことができます。

同じ注文の 2 つ目の決済が支払われた場合、注文は再び変更されません。メモが表示され、Mollie Dashboard で重複した決済を返金するよう促されます。

返金

注文を開き、Refund をクリックし、金額を入力して Refund via Mollie をクリックします（ボタンには貴店の Title が表示されます）。全額返金と一部返金に対応しています。返金は、実際に注文を支払った決済に対して、その決済が行われたモードの API キーを使って送信されます。そのため、そのモードのキーが設定されている必要があります。このボタンは、Mollie の決済が支払い済みの注文でのみ利用できます。Mollie が返金を拒否した場合は、WooCommerce に Mollie のエラーメッセージが表示され、返金は記録されません。返金に成功すると、Mollie の返金 ID とともに注文メモに追加されます。

Mollie Dashboard で作成された返金とチャージバックは、WooCommerce の返金には変換されません。チャージバックはメモを追加するだけです。

ライセンスキー

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

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

有効なキーがない場合、Mollie はチェックアウトで購入者に表示されません。それでも決済が開始された場合、購入者には This payment method is not available. Please choose another one. と表示されます。ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示された決済方法が引き続き表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインページと WooCommerce のページには通知が表示されます。既存の注文には影響ありません。開始済みの決済は引き続き確認され、返金も機能します。

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

トラブルシューティング

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

決済は完了したが、注文が Pending payment のまま: ウェブフックがサイトに届いていません。設定に表示されているウェブフック URL は、インターネットから到達可能である必要があります（メンテナンスモード、ベーシック認証、アクセスを遮るファイアウォールがないこと）。購入者が支払い後にストアに戻った場合も、注文は更新されます。

Webhook answers Unknown payment.: 貴店のテスト用または本番用 API キーでは、Mollie がその決済 ID を認識していません。例えば、別の Mollie アカウントの決済の場合です。

Webhook answers Payment ID mismatch.: そのデータによると、決済はこの注文に属していません。注文は変更されません。

Webhook answers Failed to fetch payment.: Mollie API に接続できませんでした。Mollie は後でウェブフックを再試行します。

API キーが保存されない: キーは test_ または live_ で始まり、その後に 30 文字以上の英数字が続く必要があります。Mollie Dashboard からもう一度コピーしてください。

決済が作成されない: 注文メモとログに、HTTP コードと Mollie のメッセージが表示されます。401 は API キーが誤っていることを示します。422 は、リクエストのフィールド（例: Mollie が受け付けない金額や通貨）に問題があることを示します。Logging をオンにして、WooCommerce > Status > Logs（ソース wcp_mollie_gateway）を確認してください。

注文が On hold: 注文メモを確認してください。理由は、金額または通貨の不一致、本番モードでのテスト決済、キャンセル後の決済、銀行振込、キャプチャされていない承認、またはチャージバックのいずれかです。

モードに関するメッセージで返金が失敗する: 決済はテストモードまたは本番モードで行われましたが、そのモードの API キーが設定されていません。キーを入力してから、もう一度お試しください。

その他の通貨: 開発者は molg_supported_currencies フィルターで通貨リストを変更できます。

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

アンインストール

プラグインを無効化しても、すべてのデータは保持されます。削除するには、Plugins ページで無効化してから削除してください。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。ゲートウェイの設定とログファイルは、Delete Data on Uninstall がオンだった場合にのみ削除されます。それ以外の場合は、後で再インストールするために残ります。既存の注文は、決済メモ、Mollie の決済 ID、トランザクション ID を保持します。

Mollie は、各所有者の商標です。本プラグインは Mollie と提携しておらず、Mollie による承認も受けていません。