VibeFox ifthenpay for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

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

PHP: 8.0 以降。

通貨: ユーロ（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. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で wcp_ifthenpay_gateway フォルダを /wp-content/plugins/ にアップロードすることもできます。

2. Activate をクリックします。プラグインがフィッシング対策キーを生成します。

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

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

5. Payment Method を選択し、その ifthenpay キーを入力します。保存して、Callback URL が選択した方法に対応するようにします。

6. 設定に表示される Anti-phishing Key と Callback URL をコピーし、ifthenpay にお使いのキーのコールバックを有効化するよう依頼します（バックオフィスまたは ifthenpay サポート経由）。

7. Enable/Disable をオンにします。

設定

すべての設定は 1 つのページにあります：WooCommerce > Settings > Payments > ifthenpay。選択した方法のキーがないと、チェックアウトに支払い方法が表示されず、支払い方法の一覧では対応が必要として表示されます。このキーなしで有効なゲートウェイを保存すると、ページには ifthenpay: enter the key of the selected payment method, otherwise the method is not shown at checkout. と表示されます。

Enable/Disable: Enable ifthenpay Payment で支払い方法のオン／オフを切り替えます。デフォルト：オフ。

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 キー。カードページからお客様が戻ってきた際の署名の検証にも使用されます。

コールバック（支払い通知）

コールバックは、支払いが行われたことを店舗に知らせます。使用するキーごとに、下記のフィッシング対策キーとコールバック URL を使って、ifthenpay にコールバックの有効化を依頼してください。Multibanco と MB WAY の注文はコールバックでのみ確認されます。カード決済は、カードページからの署名付きの戻りでも確認されます。

Anti-phishing Key: プラグインが生成し、コピー用に表示されます。ifthenpay は各コールバックにこのキーを含めて返します。キーのないコールバックは拒否されます。

Callback URL: 選択した支払い方法のコールバック URL。ifthenpay のプレースホルダーを含み、コピー用に表示されます。https://your-site/wc-api/ifthenpay_payment_callback/ で始まり、その方法のパラメーターが続きます。設定に表示されている URL を、全体をそのままコピーしてください。

各コールバックのフィッシング対策キーは、お使いのキーと照合されます。キーがない、または間違っている場合は 403 で応答され、注文は変更されません。コールバックは、このゲートウェイの注文とも一致している必要があります：Multibanco はエンティティと参照番号、MB WAY は注文とその MB WAY リクエストのいずれか、Credit Card は注文とそのカードリクエストで照合されます。正しく機能するコールバックがなければ、Multibanco と MB WAY の注文は確認されず、カード決済は署名付きの戻りでのみ確認されます。

詳細設定

Test Mode: Enable test/sandbox mode。クレジットカードと Multibanco は ifthenpay のサンドボックスエンドポイントを使用します。実際の代金は引き落とされず、ifthenpay から提供されたテストキーを使います。MB WAY にはサンドボックスがないため、ifthenpay のテストキーでテストしてください。チェックアウトには TEST MODE バッジが表示されます。デフォルト：オフ。

Order Status After Payment: 支払いが確定した後に設定される注文ステータス。ステータスは 1 回だけ変更され、お客様へのメールも 1 通だけ送られます。ダウンロード可能なバーチャル商品のみを含む注文は、常に WooCommerce によって完了されます。

Debug Log: Enable logging。API リクエストとコールバックは、ソース wcp_ifthenpay_gateway として WooCommerce > Status > Logs に記録されます。エラーは常に記録されます。キー、フィッシング対策キー、電話番号は記録されることはありません。デフォルト：オフ。

Delete Data on Uninstall: Remove the plugin settings, the anti-phishing key and the logs when the plugin is deleted (orders are kept)。デフォルト：オフ。

チェックアウト

Multibanco。チェックアウトでお客様には You will receive a Multibanco reference to complete the payment. と表示されます。注文が確定すると、プラグインは注文合計に対して動的な Multibanco 参照番号を作成します。注文は「保留中」になり、在庫が減り、カートは空になります。注文受付ページと、保留中の間に送られる注文メールには、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）を入力します。請求先の電話番号も自動入力されます。プラグインは電話に支払いリクエストを送信し、注文は「保留中」になり、在庫が減り、カートは空になります。注文受付ページには A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. と表示されます。注文のすべてのリクエストは保持されるため、以前にアプリで承認されたリクエストも引き続き受け付けられます。注文はコールバックによって確認されます。

クレジットカード。お客様には You will be redirected to a secure page to enter your card details. と表示され、ifthenpay のカードページへ移動します。注文は支払いが完了するまで「支払い待ち」のままで、それまで在庫は減りません。支払いが成功すると、お客様は店舗に戻ります。戻りは、有効な ifthenpay の署名、注文キー、その試行のシークレット、注文のカードリクエストがすべて確認できた場合にのみ受け付けられ、その後注文は支払い済みとしてマークされます。戻りを確認できない場合、注文は変更されず、注文受付ページには Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. と表示されます。カード決済が失敗すると注文は「失敗」になり、キャンセルされた場合は「支払い待ち」のままです。どちらの場合も、お客様は Pay for order ページに移動し、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. などです。

この支払い方法は、クラシックチェックアウト、カートおよびチェックアウトブロック（MB WAY の電話番号欄付き）、Pay for order ページで動作します。WooCommerce の High-Performance Order Storage（HPOS）に対応しています。

プラグインが一度に提供する ifthenpay の方法は 1 つだけです。Payshop、Cofidis Pay、Apple Pay、Google Pay、PIX、Pay-by-Link には対応しておらず、サブスクリプションや保存済みカードにも対応していません。未払いの Multibanco 参照番号の自動期限切れやキャンセル、支払い状況のポーリングもありません。

注文

Order statuses

On hold (waiting for payment): Multibanco 参照番号が発行されたか、MB WAY リクエストが送信されました。未払いの参照番号は自動的にキャンセルされません。必要に応じて、このような注文はご自身でキャンセルしてください。

Pending payment: カード決済が開始されましたが、まだ確認されていないか、キャンセルされました。

Processing or Completed: 支払いが確認されました。ステータスは Order Status After Payment に従います。注文メモには Multibanco のエンティティと参照番号、MB WAY の取引、またはカードリクエスト ID が表示されます。

On hold after payment: 受け取った金額が注文合計と異なるか、注文がキャンセルされた後に支払いが届きました。理由は注文メモに記載されています。ifthenpay のバックオフィスで支払いを確認し、注文を手動で完了するか返金してください。

Failed: お客様がエラーを伴ってカードページから戻りました。

支払い済みの注文に対して 2 回目の支払い通知が届いた場合は、メモが追加されるだけです。ifthenpay のバックオフィスで二重払いがないか確認してください。返金済みの注文と、支払い後にキャンセルされた注文は再度開かれることはありません。

返金

WooCommerce からの返金には対応していません。ifthenpay のバックオフィスで支払いを返金し、WooCommerce には手動で記録してください。返金済み（DEVOLVIDO）のコールバックは注文メモを追加するだけです。ifthenpay から届くその他のステータスも、メモを追加するだけです。

ライセンスキー

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

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

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

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

トラブルシューティング

ifthenpay がチェックアウトに表示されない: ライセンスが有効か、Enable/Disable がオンか、選択した Payment Method のキーが入力されているか、通貨が EUR か、合計金額が 0.01〜99,999.99 EUR の範囲内かを確認してください。Pay for order ページでは、注文の通貨が基準になります。

お客様は支払ったのに、注文が On hold または Pending payment のまま: コールバックが店舗に届いていません。ifthenpay が、お使いのキーについてコールバック URL とフィッシング対策キーを有効化したか、また URL が選択した方法のものかを確認してください。サイトはインターネットからアクセス可能である必要があり、localhost や、ログインの背後にあってはいけません。WooCommerce > Status > Logs で、ソース wcp_ifthenpay_gateway の Callback rejected の行を探してください。

コールバックが 403 Forbidden を返す: コールバック内のフィッシング対策キーがないか、設定内のキーと異なります。設定に表示されているキーを ifthenpay に再送してください。

コールバックが 503 Not configured を返す: フィッシング対策キーがまだ生成されていません。設定ページを一度開いてください。ifthenpay がコールバックを再試行します。

コールバックが Order not found を返す: 参照番号またはリクエストが、このゲートウェイの注文に属していません。たとえば、注文後に支払い方法が切り替えられた場合などです。

支払い済みの注文が On hold になったのはなぜですか？ 受け取った金額が注文合計と異なるか、注文がキャンセルされた後に支払いが届きました。注文メモを確認し、ifthenpay のバックオフィスで支払いを確認して、注文を手動で完了するか返金してください。

MB WAY リクエストを送信できない: 電話番号が MB WAY に登録されていないか、形式が正しくありません。912 345 678 の形式を使うか、他国の番号の場合は 351#912345678 の形式を使ってください。

テストモードと MB WAY: ifthenpay には MB WAY のサンドボックスがありません。ifthenpay から提供されたテストキーを使用してください。

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

アンインストール

プラグインを無効化しても、すべてのデータは保持されます。削除するには、Plugins ページで無効化してから削除してください。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。ゲートウェイの設定、フィッシング対策キー、ログは、Delete Data on Uninstall がオンだった場合にのみ削除されます。そうでない場合は、後で再インストールする際に使えるように残ります。注文と、その ifthenpay データ（参照番号、リクエスト ID）は常に保持されます。既存の注文は、支払いメモと取引 ID を保持します。

ifthenpay は、その所有者の商標です。このプラグインは ifthenpay と提携しておらず、ifthenpay の承認も受けていません。