VibeFox Mollie for PrestaShop — ヘルプ

要件

PrestaShop：8.0 から 9.x。

PHP：8.0 以降。古い PHP バージョンではモジュールのインストールを拒否します。

ショップの通貨：カートの通貨は 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. 管理画面で Modules > Module Manager を開き、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。

2. アップロードが完了したら Configure をクリックするか、後でモジュール一覧から VibeFox Mollie Gateway を見つけて Configure をクリックします。

3. Configure ページ上部のライセンスブロックにある License key 欄に VibeFox ライセンスキーを入力し、Activate をクリックします（ライセンスキーを参照）。

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

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

インストール時にモジュールは 2 つの注文ステータス Awaiting Mollie payment と Mollie payment on hold を作成します。PrestaShop は、すべての通貨、国、顧客グループに対応する新しい決済モジュールを提供します。これらは Payment > Preferences で制限できます。

設定

すべての設定はモジュールのページにあります：Modules > Module Manager > VibeFox Mollie Gateway > Configure。各セクションには独自の Save ボタンがあり、ページ全体が保存されます。フィールドの上には、Mollie が有効なのに現在のモードの API キーが空の場合や、Mollie がショップの既定の通貨に対応していない場合に警告が表示されます。どちらの場合も、チェックアウトで決済オプションは表示されません。

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

チェックアウト

Enable/Disable：Enable Mollie Gateway で決済オプションのオン・オフを切り替えます。既定値：off。

Title：チェックアウトで購入者に表示される決済方法のタイトルです。注文に保存される決済方法名にもなります。既定値：Mollie。必須。

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

API キー

API キーは Mollie Dashboard の Developers > API keys にあります。このセクションからそのページへのリンクがあります。テストキーと本番キーは別々です。

Test Mode：新しい決済にテスト用 API キーを使用します。実際の決済は処理されません。Mollie のテスト用チェックアウトページでは、決済の結果を選べます。購入者には決済オプションの下に Test mode: no real payment will be made. と表示されます。もう一方のモードで行われた決済は、ステータス確認と返金に引き続きそのモードのキーを使用します。既定値：on。

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

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

保存されたキーは二度と表示されません。フィールドは空のままで、Saved — leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。

Clear saved keys：キーにチェックを入れて Save をクリックすると削除されます。フィールドが空の場合は保存された値が維持されます。

Webhook：ウェブフックの URL を表示します。設定は不要です。モジュールは決済のたびにこの URL を Mollie に送信します。フレンドリー URL の場合は次のような形になります：https://your-shop/module/wcp_mollie_gateway/webhook。言語コードが付く場合もあります。この URL はインターネットから到達可能である必要があります。そうでなければ、注文は購入者が Mollie から戻ったときにのみ作成されます。

注文

Order Status After Payment：決済成功後に設定される注文ステータスです。ステータスは 1 ステップで設定されます。

銀行振込は Awaiting Mollie payment で入金を待ちます。承認済みの決済や、金額または通貨の不一致がある場合は Mollie payment on hold になります。

詳細設定

Logging：API 呼び出しとウェブフックを、モジュールのフォルダ内の logs/molg_debug.log.php に書き込みます。このファイルはウェブから開けません。この設定がオフでも、エラーと警告は常に記録されます。API キーと購入者データは一切記録されません。既定値：off。

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

Delete Data on Uninstall：オンの場合、モジュールをアンインストールするとモジュールの設定とログが削除されます。注文に保存された Mollie の決済 ID、返金記録、モジュールの注文ステータスは常に保持されます。既定値：off。

チェックアウト

決済ステップで購入者は決済オプション（既定では Mollie）を選んで確定します。モジュールは、カートの通貨でカートの合計金額（JPY と ISK は小数点なし）に対する Mollie の決済を作成します。説明には Order # とカート番号が付きます。その後、購入者を Mollie のホスト型チェックアウトページに移動させます。そこで購入者は Mollie アカウントで有効になっている決済方法のいずれかを選んで支払います。この時点ではまだ注文は存在しません。

Mollie のウェブフックには署名がなく、決済 ID だけが含まれます。そのためモジュールは、ウェブフックをそれ自体では信頼しません。モジュールが自分で作成した決済 ID のみを受け付け、決済が行われたモードのキーで Mollie API から決済を読み取り、その決済がカートに属していることを確認し、支払われた金額と通貨をカートの合計と比較します。注文は、Mollie がこの方法で確認した後にのみ支払い済みとしてマークされます。モジュールは次の Mollie の決済ステータスを処理します：

購入者が戻ると、モジュールは同じ方法で Mollie API を使ってカートの最新の決済を確認します。支払いが完了している場合は、標準の注文確認ページに進み、Your payment with Mollie has been received. と表示されます。銀行振込の場合、ページには Your order will be processed as soon as Mollie receives your bank transfer. と表示されます。注文が保留中の場合、ページには We are confirming your payment with Mollie. The order will be updated automatically — please do not pay again. と表示されます。既存の注文の決済が失敗したか注文がキャンセルされた場合、ページには Your Mollie payment was not completed. Please contact us about this 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 に接続できない場合や、まだ判断が出ていない場合は、Payment confirmation ページが表示されます。このページでは購入者に再度支払わないよう求め、Check again ボタンを提供します。ウェブフックが届くと、すぐに注文が作成されます。

購入者が再度支払う場合、同じ金額でまだ有効な 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. 技術的な理由はログに記録されます。

ウェブフックは、ショップがメンテナンスモードの間も動作し、ショップの国の制限によってブロックされることはありません。

購入者は、チェックアウトではなく Mollie のページで Mollie の決済方法を選択します。モジュールは、定期決済やサブスクリプション、保存済みカードや委任契約（マンデート）、貴サイト上のカード入力欄、Apple Pay や PayPal のエクスプレスボタンには対応しておらず、Orders API も使用しません。そのため、これらの決済では、注文明細を必要とする決済方法（一部の Klarna、Billie、in3 のバリエーションなど）は Mollie から提供されません。承認済みの決済は、PrestaShop からではなく Mollie Dashboard でキャプチャまたは取り消されます。

注文と返金

注文ステータス

まだ注文はありません：購入者は Mollie に移動しましたが、まだ支払っていないか、Mollie がまだ決済を確認していません。カートだけが存在します。

Payment accepted または Delivered：決済が確認されました。ステータスは Order Status After Payment に従います。決済は Mollie の決済 ID（tr_...）をトランザクション ID として記録され、メモには Mollie の決済、決済方法、モードが表示されます。

Awaiting Mollie payment：購入者は Mollie のページで銀行振込を選択しました。Mollie が入金を受け取ると、注文は支払い済みのステータスに移ります。

Mollie payment on hold：承認済みの決済がキャプチャを待っている、Mollie がチャージバックを報告した、支払われた金額または通貨がカートと異なる（例：決済の開始後にカートが変更された）、ショップが本番モードの間にテスト決済が行われた（入金はありません）、または注文がキャンセルされた後に決済が届いた。メモに理由が説明されています。Mollie Dashboard で決済を確認してから、注文を処理するか決済を返金してください。

Payment error：既存の注文の銀行振込または承認が、失敗、期限切れ、またはキャンセルされました。支払い済みの注文は決して変更されません。

Refunded：モジュールを通じて決済が全額返金されました。

同じカートの 2 つ目の決済が支払われた場合、注文は変更されません。メモで、Mollie Dashboard の重複した決済を返金するよう求められます。

Mollie payment ブロック

注文ページには Mollie payment ブロックが表示されます。Mollie の決済 ID、決済方法、決済ステータス、支払われた金額と返金された金額、テスト決済用の Test mode バッジ、返金履歴、注文の Mollie notes が含まれます。メモは管理画面でのみ表示されます。

返金

Mollie payment ブロックで金額を入力します（まだ返金されていない金額が自動入力されます）。必要に応じて理由を入力し、Refund via Mollie をクリックします。Refund this amount through Mollie? This cannot be undone. の確認に応じてください。全額返金と一部返金に対応しています。注文を編集する権限が必要です。モジュールのページへのアクセスは不要です。返金は Mollie が請求した金額と通貨で行われます。そのため、金額の不一致がある場合は、注文の合計ではなく、購入者が実際に支払った金額までしか返金できません。返金は、注文を実際に支払った決済に対して、その決済が行われたモードの API キーを使って送信されます。したがって、そのモードのキーが設定されている必要があります。Mollie が返金を拒否した場合、ブロックには Mollie のエラーメッセージが表示され、返金は記録されません。返金に成功すると、返金履歴とメモに Mollie の返金 ID が追加されます。全額返金を行うと、注文は Refunded になります。一部返金ではステータスは変わりません。返金は、Mollie が決済を支払い済みと報告した後にのみ利用できます。

モジュールはクレジットスリップを作成しません。注文ページの PrestaShop の標準の返金ボタンでは、Mollie を通じた返金は行われません。Mollie Dashboard で作成された返金は注文に表示されません。チャージバックの場合はメモが追加されます。

ライセンスキー

モジュールは vibefox.net の VibeFox ライセンスキーを使用します。License — VibeFox Mollie Gateway ライセンスブロックは、Modules > Module Manager > VibeFox Mollie Gateway > Configure ページで設定より上にある最初のブロックです。License key にキーを入力し、Activate をクリックします。その後、ブロックにはキーがマスク表示され、ステータス（ライセンスの有効期限日やお使いのドメインなど）と、次のボタンが表示されます：Check now でステータスを再確認、Change key で別のキーを入力、Remove key でこのショップからキーを削除します。その下には Product: presta-payment-mollie の行と、Manage licenses and domains in your account のリンクがあり、vibefox.net のアカウントを開きます。キーを変更できるのは、このモジュールの Configure 権限を持つ従業員のみです。ブロックのテキストはバックオフィスの言語に従います（英語とロシア語が含まれます）。

キーが受け付けられない場合、ブロックには理由が表示されます。例：Key not found、This key belongs to another product、Domain limit reached、または日付付きの License expired on。ショップのアドレスを変更した後、またはアカウントでドメインの枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、モジュールは最後に確認できた状態で動作を続けます。

1 つのキーは 1 つのドメインで使用できます。メインショップのドメインで、マルチストア構成の場合も同様です。ショップからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。

有効なキーがない場合、チェックアウトで購入者に Mollie は表示されません。それでも決済が開始された場合、購入者には This payment method is not available. Please choose another one. と表示されます。PrestaShop のフロントエンドは、管理画面にログインしていることを認識しないため、お客様にも決済方法は非表示になります。キーを購入する前にモジュールを設定することはできますが、チェックアウトでのテストはできません。Modules > Module Manager の Alerts タブに通知が表示されます。既存の注文には影響しません。すでに開始された決済は引き続き確認され、返金も行えます。

ライセンスの有効期限が切れてもモジュールは動作を続けますが、アップデートとサポートには更新が必要です。管理画面で作業している間、ステータスは自動的に再確認されます：キーを入力してから最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは不要です。モジュールのアンインストールまたはリセットでは、常にライセンスキーとライセンスステータスが削除されます。

トラブルシューティング

チェックアウトに Mollie が表示されない：ライセンスが有効であること、Enable/Disable がオンであること、現在のモードに API キーがあることを確認してください。テストモードでは Test API Key、本番モードでは Live API Key です。カートの通貨が Mollie に対応しているか確認してください。キーがない場合やショップの通貨に対応していない場合、設定ページに警告が表示されます。Payment > Preferences で、カートの通貨、顧客の国、顧客グループに対してモジュールが許可されているかを確認してください。

決済は完了したが、注文が作成されない：ウェブフックがショップに到達できていません。Webhook に表示された URL はインターネットから到達可能である必要があります（ベーシック認証やアクセスを妨げるファイアウォールがないこと）。購入者が支払い後にショップに戻った場合や、Check again をクリックした場合にも注文は作成されます。

ウェブフックが Unknown payment. と応答する：その決済はこのショップで作成されたものではないか、Mollie がそのモードの API キーではその決済を認識しません。例えば、別の Mollie アカウントの決済などです。

ウェブフックが Payment ID mismatch. と応答する：その決済は、作成された対象のカートに属していません。何も変更されません。

ウェブフックが Failed to fetch payment. と応答する：Mollie API に接続できないか、決済のモードの API キーが設定されていません。Mollie は後でウェブフックを再試行します。

ウェブフックが Temporarily unavailable. と応答する：同じ時刻に別のリクエストがカートを処理していたか、注文を作成できませんでした（例：モジュールが無効になっている）。Mollie はウェブフックを再試行します。理由を確認するには Logging をオンにしてください。

ブラウザでウェブフックの URL に Method not allowed. と表示される：これは正常です。この URL は Mollie からのリクエストのみを受け付けます。

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

購入者が Mollie を選ぶとエラーが表示される：モジュールのページの Log フィールドを確認してください。HTTP コードと Mollie のメッセージが表示されます。401 は API キーが誤っていることを意味します。422 はリクエストのフィールド（例：Mollie が受け付けない金額や通貨）に問題があることを示します。

注文が Mollie payment on hold になっている：注文のメモを確認（注文ステータスを参照）してから、注文を処理するか決済を返金してください。

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

その他の通貨や決済データ：開発者は actionWcpMollieSupportedCurrencies フックで通貨リストを、actionWcpMolliePaymentData フックで決済リクエストを変更できます。

アンインストール

Modules > Module Manager に移動し、VibeFox Mollie Gateway の横にあるメニューを開いて Uninstall を選択します。このモジュールのライセンスキーとライセンスステータスは常に削除されます。Delete Data on Uninstall がオンの場合、モジュールの設定とログが削除されます。オフの場合、後で再インストールするためにすべての設定が保持されます。Mollie の決済 ID と返金記録、および注文ステータス Awaiting Mollie payment と Mollie payment on hold は常に保持されるため、以前に支払われた注文は再インストール後も返金できます。既存の注文は、決済のメモとトランザクション ID を保持します。

Mollie は各所有者の商標です。このモジュールは Mollie と提携しておらず、Mollie による承認も受けていません。