VibeFox EveryPay for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

WooCommerce: 7.0 以降、インストールおよび有効化済み。

PHP: 8.0 以降。

EveryPay アカウント: ストアの API ユーザー名、API シークレット、処理アカウント名が必要です。これらは EveryPay Merchant Portal のストア設定にあります。テストモードではデモポータル（mwt-demo.every-pay.com）、本番の決済では本番ポータル（portal.every-pay.eu）を使用します。テスト環境と本番環境では認証情報が別々です。また、両方のポータルでストアのコールバック URL を設定します（「設定」を参照）。

ストアの通貨: 処理アカウントによって請求通貨が決まります。たとえば EUR3D1 は EUR で請求します。決済方法は、その通貨の注文に対してのみ提供されます。

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

インストール

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

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

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

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

5. デモ版 Merchant Portal から、テスト用の API ユーザー名、テスト用の API シークレット、処理アカウント名を入力します。Test Mode はオンのままにします。

6. 設定ページに表示されているコールバック URL をコピーし、Merchant Portal のストアの Callback notification URL に貼り付けます。

7. Enable/Disable をオンにして、テスト注文を行います。すべて正常に動作したら、本番の認証情報を入力し、本番ポータルにもコールバック URL を設定して、Test Mode のチェックを外します。

設定

すべての設定は 1 つのページにあります：WooCommerce > Settings > Payments > EveryPay。テストモードがオンの間、フィールドの上に Test mode is on: payments go to the EveryPay demo environment, no real money is charged. と表示されます。ゲートウェイが有効なのに、現在のモードの API ユーザー名、API シークレット、処理アカウントが不足している場合は警告が表示されます（その場合、決済方法はチェックアウトで非表示になります）。処理アカウントがストアの通貨と異なる通貨で請求する場合も警告されます。決済方法の一覧では、現在のモードが設定されるまで EveryPay に「設定が必要」と表示されます。認証情報と一緒に貼り付けたスペースや改行は、保存時に削除されます。

一般

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

Title: チェックアウトで購入者に表示される決済方法の名前。デフォルト: EveryPay。

Description: チェックアウトで決済方法の下に表示されるテキスト。デフォルト: Pay securely by card or bank link on the EveryPay payment page.

EveryPay アカウント

API ユーザー名、API シークレット、処理アカウント名は、EveryPay Merchant Portal（ストア設定）に表示されます。テストモードはデモポータル、本番の決済は本番ポータルを使用します。

Test Mode: Enable test mode は、テスト用の認証情報で決済を EveryPay のデモ環境に送信します。実際の料金は請求されません。デフォルト: オン。

Test API Username: デモ環境の API ユーザー名。

Test API Secret: デモ環境の API シークレット。

Live API Username: 本番環境の API ユーザー名。

Live API Secret: 本番環境の API シークレット。

Processing Account Name: EveryPay の処理アカウント（例: EUR3D1）。このアカウントが請求通貨を決定します。ゲートウェイは、その通貨の注文に対してのみ提供されます。両方のモードで同じアカウント名を使用します。

決済の通知（コールバック）

コールバックは、決済が完了したことをストアに知らせます。そのため、購入者がブラウザを閉じても注文が更新されます。このセクションに表示される URL を、デモと本番の両方について、EveryPay Merchant Portal のストアの Callback notification URL にコピーしてください。URL の形式は https://your-site/wc-api/wc_evp_payment/ です。決済リクエストにはコールバック URL が含まれないため、ポータルで設定しておく必要があります。

コールバックには決済の参照情報のみが含まれます。届くと、プラグインは決済が作成された環境で EveryPay API に決済ステータスを問い合わせ、応答がこの注文のものであることを確認します。注文が作成したものではない決済に対するコールバックは拒否されます。コールバックがない場合、購入者が支払い後にストアへ戻ったとき、または注文で Check EveryPay payment status を実行したときに注文が確定されます。

詳細設定

Debug log: Log payment events は、決済イベントを WooCommerce > Status > Logs に、ソース wcp_everypay_payment として書き込みます。エラーは常に記録されます。API シークレットとカード情報は決して記録されません。デフォルト: オフ。

Uninstall: Delete the gateway settings and logs when the plugin is deleted。デフォルト: オフ。

チェックアウト

購入者は決済方法（デフォルトは EveryPay）を選び、注文を確定します。テストモードでは、チェックアウトに TEST MODE: EveryPay demo environment, no real money is charged. と表示されます。プラグインは、注文金額に対して、購入者のメールアドレスと請求先情報を添えて 1 回限りの EveryPay 決済を作成し、購入者を EveryPay の決済ページへ移動させます。決済ページの言語はサイトの言語に従います（英語、エストニア語、ロシア語、ラトビア語、リトアニア語、フィンランド語、ドイツ語。それ以外は英語）。購入者はそこで、EveryPay アカウントで有効になっている方法のいずれかで支払います。

支払い後、購入者はストアに戻ります。注文は EveryPay が確認した後にのみ支払い済みになります。プラグインは、戻りとコールバックのタイミングで、EveryPay API に決済ステータスを問い合わせます。支払い済みの注文、確認中の注文、または処理中の決済は、注文受付ページに移動します。

決済が失敗した場合、購入者はチェックアウト（または Pay for order ページ）に戻り、Your EveryPay payment was not successful. Please try again or choose another payment method. というメッセージが表示されます。購入者が支払わずに決済ページを離れた場合、メッセージは The EveryPay payment was not completed. You can try again or choose another payment method. です。新しい試行ごとに新しい EveryPay 決済が作成されます。以前の試行も記録されるため、古いリンクで行われた支払いも引き続き認識されます。

EveryPay が決済を開始できない場合、購入者には短いメッセージが表示されます。例: EveryPay is temporarily unavailable. Please try again in a moment or choose another payment method. 詳細はログに記録されます。

この決済方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで動作します。WooCommerce High-Performance Order Storage（HPOS）に対応しています。購入者向けのテキストはエストニア語に翻訳されています。

本プラグインは 1 回限りの決済のみに対応しています。WooCommerce からの返金やキャプチャ、保存済みカードやワンクリック決済、サブスクリプションや定期決済、埋め込み型のカード入力欄には対応しておらず、複数通貨にも対応していません。

注文

注文ステータス

Pending payment: 購入者は EveryPay に移動しましたが、まだ支払っていないか、決済が処理中です。

Processing: EveryPay が決済の完了または承認を報告しました（仮想のダウンロード可能商品のみを含む注文は、WooCommerce の標準動作どおり「完了」になります）。注文備考には、金額、通貨、決済参照番号が表示されます。注文のトランザクション ID は EveryPay の決済参照番号です。承認済みの決済の場合、備考には資金が確保されたことが記されます。アカウントで自動キャプチャしない場合は、EveryPay Merchant Portal で決済をキャプチャしてください。後で決済が完了すると、その旨の備考が 1 件追加されます。

On hold after payment: 決済には手動での確認が必要です。支払われた金額または通貨が注文と異なる、決済が届く前に注文がキャンセルされていた、または注文が現在別の決済方法を使用している、のいずれかです。備考にその理由が記され、注文は支払い済みとしてマークされていないことが示されます。Merchant Portal で決済を確認し、手動で完了させるか返金してください。この決済に対するその後のコールバックでは、注文は自動的に完了しません。

Failed: 未払い注文の最新の決済試行が失敗したか、中断されたか、取り消されました。備考には EveryPay からの理由が表示されます。購入者は再試行できます。

支払い済みの注文に対して 2 回目の決済が完了しても、注文は変更されません。備考で、重複した決済を EveryPay Merchant Portal で返金するよう求められます。

Check EveryPay payment status

注文画面で、注文操作 Check EveryPay payment status を選択します。プラグインは、注文のすべての EveryPay 決済を API で確認し、上記のとおり結果を適用して、各決済の状態を示す備考を追加します。コールバックが届かなかった注文に使用してください。

返金

WooCommerce からの返金には対応していません。EveryPay Merchant Portal で返金してから、WooCommerce で注文ステータスを設定してください。EveryPay が決済を返金済みまたはチャージバックと報告した場合、プラグインは注文備考を追加するだけで、注文ステータスは変更されません。

ライセンスキー

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

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

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

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

トラブルシューティング

EveryPay がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在のモードの API ユーザー名、API シークレット、Processing Account Name が設定されていること、そしてストアの通貨（Pay for order ページでは注文の通貨）が処理アカウントの通貨と一致していることを確認してください。これらの場合、設定ページに警告が表示されます。

決済は完了したのに、注文が Pending payment のまま: コールバックが機能していません。設定のコールバック URL が、使用中のモード（デモまたは本番）の Merchant Portal で Callback notification URL として設定されていることを確認してください。注文を開いて Check EveryPay payment status を実行することもできます。Debug log をオンにし、WooCommerce > Status > Logs で、ソース wcp_everypay_payment を確認してください。

コールバックが Unknown payment reference または Payment does not belong to this order と応答する: 決済はこの注文によって作成されていないか、EveryPay の応答が一致しません。注文は変更されません。

コールバックが Not configured と応答する: 決済が作成された環境の認証情報がありません。たとえば、テスト用認証情報を削除した後に行ったテスト決済です。認証情報を再入力してください。EveryPay はコールバックを再試行します。

コールバックが Payment status unavailable または Busy, please retry と応答する: EveryPay API に接続できなかったか、注文が別のリクエストによって同時に更新されていました。EveryPay はコールバックを再試行します。

購入者に EveryPay is temporarily unavailable と表示される: EveryPay が認証情報を拒否したか、接続できませんでした。現在のモードの API ユーザー名と API シークレットを確認してください。

購入者に This payment method does not support the order currency と表示される: 注文の通貨が、処理アカウントの通貨と異なります。

注文が On hold after payment になっている: 注文備考を確認してください。金額または通貨が異なっていたか、決済が届く前に注文がキャンセルされていました。Merchant Portal で決済を確認し、手動で完了させるか返金してください。

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

開発者向けに、プラグインのドキュメントには、フィルター wc_evp_icon、wc_evp_locale、wc_evp_currency_decimals、wc_evp_oneoff_request が記載されています。

アンインストール

プラグインを無効化してもすべてのデータは保持されます。削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。ゲートウェイの設定とログは、Uninstall（Delete the gateway settings and logs when the plugin is deleted）がオンの場合にのみ削除されます。それ以外の場合は、後で再インストールできるように残ります。注文に保存された EveryPay の決済参照番号は、常に保持されます。既存の注文は、決済に関する備考とトランザクション ID を保持します。

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