VibeFox ifthenpay for PrestaShop — ヘルプ
要件
PrestaShop: 8.0 から 9.x。
PHP: 8.0 以降。モジュールは古い PHP バージョンではインストールを拒否します。
通貨: ユーロ（EUR）のみ。カート通貨が EUR でない場合、支払い方法は表示されません。ifthenpay は 0.01 から 99,999.99 EUR までの金額を受け付けます。
ifthenpay アカウント: ifthenpay.com でお申し込みください。提供する方法のキーが必要です：Multibanco、MB WAY、または Credit Card（形式 ABC-123456）。キーは ifthenpay のバックオフィス（backoffice.ifthenpay.com）に表示されるか、お客様のアカウントでその方法が有効化されたときに ifthenpay から送られます。ifthenpay はお客様のキーに対してコールバックも有効化する必要があり（設定を参照）、ストアはインターネットから到達可能である必要があります。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインでのみ使用できます。
インストール
1. 管理画面で Modules > Module Manager に進み、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。
2. アップロードが完了したら Configure をクリックします。後からモジュール一覧で VibeFox ifthenpay Gateway を探し、Configure をクリックすることもできます。モジュールはインストール時に反フィッシングキーを生成します。
3. Configure ページ上部のライセンスブロックの License key 欄に VibeFox ライセンスキーを入力し、Activate をクリックします（ライセンスキーを参照）。
4. Payment Method を選択し、その ifthenpay キーを入力して Save をクリックします。これにより Callback URL が選択した方法と一致します。
5. 設定に表示される Anti-phishing Key と Callback URL をコピーし、お客様のキーのコールバックを有効化するよう ifthenpay に依頼します（バックオフィスまたは ifthenpay サポート経由）。
6. Enable/Disable をオンにし、Save をクリックします。
インストール時、モジュールは 2 つの注文ステータスを作成します：Awaiting ifthenpay payment と ifthenpay payment on hold。PrestaShop は、すべての通貨、国、顧客グループに対して新しい支払いモジュールを有効にします。Payment > Preferences で制限できます。ただし EUR は許可されたままにしてください。
設定
すべての設定はモジュールのページにあります：Modules > Module Manager > VibeFox ifthenpay Gateway > Configure。Save ボタンのあるセクションはいずれも、ページ全体を保存します。選択した方法のキーがない場合、チェックアウトに支払い方法は表示されません。そのキーがないままゲートウェイを有効にすると、ページには ifthenpay: enter the key of the selected payment method, otherwise the method is not shown at checkout. と表示されます。
ifthenpay
Enable/Disable: Enable ifthenpay Payment は支払い方法を有効または無効にします。既定値: off。
Title: チェックアウトに表示される支払い方法のタイトルです。注文に保存される支払い方法名としても使われます。既定値: ifthenpay。
Description: チェックアウトに表示される支払い方法の説明です。既定値: Pay via Multibanco, MB WAY or Credit Card。提供する方法に合わせて変更してください。
Payment Method: チェックアウトで提供される方法です。必要なのはこの方法のキーだけです。
ifthenpay キー
キー（形式 ABC-123456）は ifthenpay のバックオフィスに表示されるか、お客様のアカウントで支払い方法が有効化されたときに ifthenpay から送られます。
Multibanco Key: 動的参照番号用の ifthenpay Multibanco（MB）キーです。
MB WAY Key: ifthenpay MB WAY キーです。
Credit Card Key: ifthenpay Credit Card キーです。カードページからお客様が戻る際の署名の検証にも使われます。
保存済みのキーは再び表示されません。欄は空のままで、Saved — leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。
Clear saved keys: キーにチェックを入れ、Save をクリックすると削除されます。空欄の場合は保存済みの値が維持されます。
Callback（支払い通知）
コールバックは、支払いが行われたことをお使いのストアに通知します。使用するキーごとに、以下の反フィッシングキーとコールバック URL を使って、ifthenpay にコールバックの有効化を依頼してください。Multibanco と MB WAY の注文はコールバックによってのみ確認されます。カード払いは、カードページからの署名付きの戻りによっても確認されます。
Anti-phishing Key: モジュールが生成し、コピーできるように表示されます。ifthenpay はすべてのコールバックでこのキーを送り返します。キーのないコールバックは拒否されます。
Callback URL: 選択した支払い方法のコールバック URL です。ifthenpay のプレースホルダーを含み、コピーできるように表示されます。フレンドリー URL を使用する場合は、https://your-shop/module/wcp_ifthenpay_gateway/callback のように始まり、/en/ のような言語コードが付くこともあります。その後に方法のパラメータが続きます。設定に表示されているとおりに URL 全体をコピーしてください。
各コールバックの反フィッシングキーは、お客様のキーと照合されます。キーが欠けている場合または誤っている場合は 403 が返され、注文は変更されません。コールバックは、このモジュールの支払いとも一致している必要があります。Multibanco はエンティティと参照番号、MB WAY はカートとそのいずれかの MB WAY リクエスト、Credit Card はカートとそのいずれかのカードリクエストで照合されます。正常に動作するコールバックがなければ、Multibanco と MB WAY の注文は決して確認されず、カード払いは署名付きの戻りによってのみ確認されます。コールバックはストアがメンテナンスモードの間も動作し、ストアの国別制限によってブロックされることはありません。
詳細設定
Test Mode: Credit Card と Multibanco は ifthenpay のサンドボックスエンドポイントを使用します。実際の資金は引き落とされず、ifthenpay から提供されたテストキーを使用します。MB WAY にはサンドボックスがないため、ifthenpay のテストキーでテストしてください。チェックアウトには TEST MODE バッジが表示されます。既定値: off。
Order Status After Payment: 支払いが確認された後に設定される注文ステータスです。ステータスは 1 回だけ変更されます。
Debug Log: API リクエストとコールバックは、モジュールフォルダ内の logs/ifthenpay_p_debug.log.php に書き込まれます。このファイルは Web から開くことはできません。エラーは常に記録されます。キー、反フィッシングキー、電話番号の全桁は決して記録されません。既定値: off。
Log: ログのサイズと最新のエントリを表示します。Clear log をクリックすると空になります。
Delete Data on Uninstall: オンの場合、モジュールをアンインストールするとモジュールの設定、反フィッシングキー、ログが削除されます。注文と ifthenpay の支払い記録は常に残ります。既定値: off。
チェックアウト
Multibanco。チェックアウトでお客様は You will receive a Multibanco reference to complete the payment. と表示されるのを見ます。お客様が確定すると、モジュールはカート合計に対して動的な Multibanco 参照番号を作成し、注文は Awaiting ifthenpay payment で作成されます。注文確認ページには Multibanco Payment Details が表示され、エンティティ、参照番号、金額とともに Please use these details to pay at any Multibanco ATM or through your online banking. と書かれます。同じ情報が注文確認メールにも追加されます。ifthenpay が支払いのコールバックを送ると、注文は支払い済みになります。
MB WAY。お客様は MB WAY phone number（912 345 678、+351 912 345 678、またはその他の国では 351#912345678）を入力します。請求先住所の電話番号が自動入力されます。モジュールはその電話番号に支払いリクエストを送信し、注文は Awaiting ifthenpay payment で作成されます。注文確認ページには A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. と表示されます。ifthenpay がコールバックを送ると、注文は支払い済みになります。保存されるのはマスクされた電話番号だけです。
クレジットカード。お客様には You will be redirected to a secure page to enter your card details. と表示され、ifthenpay のカードページに移動します。まだ注文は存在せず、カートは保持されます。支払いが成功すると、お客様はストアに戻ります。戻りは、有効な ifthenpay の署名、カートの安全なキー、その試行の秘密の値、そしてカートのカードリクエストが揃っている場合にのみ受け付けられます。その後、注文は支払い済みとして作成され、お客様には標準の注文確認ページが表示されます。戻りを検証できない場合は何も変わらず、Payment confirmation ページに Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. と Check again ボタンが表示されます。コールバックが届くとすぐに注文が作成されます。カード払いが失敗またはキャンセルされた場合、お客様は The card payment was not completed. You can try again or choose another payment method. または The card payment was cancelled. You can try again or choose another payment method. と表示されたチェックアウトに戻ります。カートのすべてのカード試行は保持されるため、以前のタブで行った支払いも引き続き受け付けられます。
注文が支払い済みとしてマークされるのは、ifthenpay が支払いを確認した後だけです。金額は注文合計と 1 セント単位で照合されます。支払いを開始できない場合、お客様はチェックアウトに留まり、The Multibanco reference could not be created. Please try again or choose another payment method.、The MB WAY payment request could not be sent. Please check that the phone number is linked to MB WAY, or choose another payment method.、The payment service is temporarily unavailable. Please try again in a few minutes. などの短いメッセージが表示されます。技術的な理由はログに書き込まれます。
モジュールが一度に提供する ifthenpay の方法は 1 つだけです。Payshop、Cofidis Pay、Apple Pay、Google Pay、PIX、Pay-by-Link には対応していません。また、サブスクリプションや保存済みカード、未払いの Multibanco 参照番号の自動期限切れやキャンセル、支払い状況のポーリングにも対応していません。
注文
注文ステータス
No order yet: カード払いが開始されましたが、まだ確認されていないか、失敗またはキャンセルされました。存在するのはカートだけです。
Awaiting ifthenpay payment: Multibanco の参照番号が発行されたか、MB WAY リクエストが送信されました。注文が作成されると、PrestaShop は在庫を減らします。未払いの参照番号や拒否された MB WAY リクエストによって注文が自動的にキャンセルされることはありません。必要に応じて、そのような注文はご自身でキャンセルしてください。
Payment accepted or Delivered: 支払いが確認されました。ステータスは Order Status After Payment に従います。支払いは、取引 ID として Multibanco 参照番号、MB WAY リクエスト ID、またはカードリクエスト ID とともに記録され、メモには確認方法が表示されます。
ifthenpay payment on hold: 受け取った金額が注文合計と異なっていた場合（例えば、カード払いの開始後にカートが変更された場合）、または注文がキャンセルされた後に支払いが届いた場合です。メモにその理由が書かれ、お客様に再度支払いを求めることはありません。ifthenpay のバックオフィスで支払いを確認し、注文を手動で完了するか返金してください。そのような注文に対して後から正しい支払いがあっても、注文は変わりません。
すでに支払い済みの注文に対する 2 回目の支払いは、ifthenpay のバックオフィスで二重払いがないか確認するためのメモを追加するだけです。返金済みの注文と、支払い後にキャンセルされた注文が再度開かれることはありません。
ifthenpay 支払いブロック
注文ページには ifthenpay payment ブロックが表示され、注文の支払い試行（日付、方法、テスト支払い用の Sandbox バッジ、金額、Multibanco のエンティティと参照番号またはマスクされた MB WAY の電話番号、ifthenpay のリクエスト ID とステータス）、注文が ifthenpay payment on hold の間に表示される Manual review の警告、そして注文の ifthenpay notes が表示されます。
返金
PrestaShop からの返金には対応していません。ifthenpay のバックオフィスで支払いを返金し、PrestaShop には手動で記録してください。返金済み（DEVOLVIDO）のコールバックはメモを追加するだけです。ifthenpay が報告するその他のステータスも、メモを追加するだけです。
ライセンスキー
モジュールは vibefox.net の VibeFox ライセンスキーを使用します。ライセンスブロック License — VibeFox ifthenpay Gateway は、Modules > Module Manager > VibeFox ifthenpay Gateway > Configure の最初のブロックで、設定の上にあります。キーを License key に貼り付け、Activate をクリックしてください。その後、ブロックにはキーがマスク表示され、ステータス（ライセンスの有効期限日や貴社のドメインなど）と、Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このストアからキーを削除）のボタンが表示されます。その下には Product: presta-payment-ifthenpay の行と、vibefox.net のアカウントを開く Manage licenses and domains in your account のリンクがあります。キーを変更できるのは、このモジュールの Configure 権限を持つスタッフだけです。ブロックの文言は管理画面の言語に従います（英語とロシア語を含みます）。
キーが受け付けられない場合、ブロックには理由が表示されます（例：Key not found、This key belongs to another product、Domain limit reached、License expired on と日付）。ストアのアドレスを変更した後や、アカウントでドメインの枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、モジュールは最後に確認されたステータスで動作を続けます。
1 つのキーは 1 つのドメインでのみ使用できます。メインストアのドメインであり、マルチストア構成でも同じです。キーをストアから削除しても、ドメインの枠は解放されません。枠は vibefox.net のアカウントで解放してください。
有効なキーがないと、チェックアウトで ifthenpay がお客様に表示されません。それでも支払いが開始された場合、お客様には This payment method is not available. Please choose another one. と表示されます。PrestaShop のストアフロントは、貴社が管理画面にログインしていることを認識しないため、支払い方法は貴社に対しても非表示になります。キーを購入する前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。リマインダーは Modules > Module Manager の Alerts タブに表示されます。既存の注文には影響しません。すでに開始された支払いは引き続き確認されます。
ライセンスが期限切れになっても、モジュールは動作を続けますが、アップデートとサポートには更新が必要です。ステータスは、管理画面で作業している間に自動的に再確認されます。キーを入力してから最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは不要です。モジュールをアンインストールまたはリセットすると、ライセンスキーとライセンスステータスは常に削除されます。
トラブルシューティング
チェックアウトに ifthenpay が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、選択した Payment Method のキーが入力されていること、カート通貨が EUR であること、合計が 0.01 から 99,999.99 EUR の範囲であることを確認してください。Payment > Preferences で、モジュールが EUR、お客様の国、お客様のグループに対して許可されていることも確認してください。
お客様が支払ったのに、注文が Awaiting ifthenpay payment のままか、注文が作成されていない: コールバックがストアに届いていません。ifthenpay が、お使いのキーに対してコールバック URL と反フィッシングキーを有効化していること、そして URL が選択した方法のものであることを確認してください。ストアはインターネットから到達可能である必要があります。localhost や、ログインの背後にあってはいけません。モジュールページの Log 欄で Callback rejected の行を探してください。
コールバックが 403 Forbidden を返す: コールバック内の反フィッシングキーが欠けているか、設定内のキーと異なります。設定に表示されているキーを ifthenpay に再度送ってください。
コールバックが 503 Not configured を返す: 反フィッシングキーがまだ生成されていません。モジュールの設定を一度開いてください。ifthenpay はコールバックを再試行します。
コールバックが 503 Busy を返す: その時点で同じカートが別のリクエストで処理されていました。ifthenpay はコールバックを再試行します。
コールバックが Order not found を返す: 参照番号またはリクエストが、このモジュールの支払いに属していないか、そのカートが別の支払い方法で注文されています。
支払い済みの注文が保留になったのはなぜですか？ 受け取った金額が注文合計と異なっていたか、注文がキャンセルされた後に支払いが届いた場合です。ifthenpay payment ブロックのメモを確認し、ifthenpay のバックオフィスで支払いを確認して、注文を手動で完了するか返金してください。
MB WAY リクエストを送信できない: 電話番号が MB WAY に登録されていないか、形式が間違っています。912 345 678 を使用してください。他の国の番号の場合は 351#912345678 を使用してください。
テストモードと MB WAY: ifthenpay には MB WAY のサンドボックスがありません。ifthenpay から提供されたテストキーを使用してください。
アンインストール
Modules > Module Manager に進み、VibeFox ifthenpay Gateway の横にあるメニューを開いて、Uninstall を選択します。このモジュールのライセンスキーとライセンスステータスは常に削除されます。Delete Data on Uninstall がオンの場合、モジュールの設定、反フィッシングキー、ログが削除されます。再インストール後には新しい反フィッシングキーが生成され、ifthenpay に再度送る必要があります。オフの場合、後で再インストールできるようにすべての設定が保持されます。ifthenpay の支払い記録（参照番号とリクエスト ID）と、Awaiting ifthenpay payment および ifthenpay payment on hold の注文ステータスは常に保持されるため、以前に発行された参照番号のコールバックは、再インストール後も対応する注文を見つけられます。既存の注文は、支払いメモと取引 ID を保持します。
ifthenpay はそれぞれの所有者の商標です。本モジュールは ifthenpay と提携しておらず、ifthenpay による承認も受けていません。