VibeFox ePay.bg for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

WooCommerce: 7.0 以降。インストール済みで有効であること。

PHP: 8.0 以降。

ストア通貨: ブルガリア・レフ（BGN）、ユーロ（EUR）、または米ドル（USD）。注文は注文自体の通貨で、小数点以下 2 桁で請求されます。それ以外の通貨では、チェックアウトでこの支払い方法は非表示になります。

ePay.bg アカウント: ePay.bg の加盟店プロフィールにある顧客番号（MIN）とシークレットキーが必要です。本番用は www.epay.bg、テスト用は demo.epay.bg のものです（テストアカウントは別途登録します）。また、ストアの通知 URL を加盟店プロフィールに入力する必要があります。

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

インストール

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

2. Activate をクリックします。WooCommerce が有効になっている必要があります。

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

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

5. テスト用または本番用（あるいは両方）の MIN とシークレットキーを入力します（「設定」を参照）。

6. Payment notifications (IPN) セクションに表示される通知 URL を、デモと本番の両方の ePay.bg 加盟店プロフィールの URL for receiving notifications 欄にコピーします。これがないと、注文は支払い待ちのままになります。

7. Enable/Disable をオンにします。テストモードでテスト注文を行い、その後 Test Mode のチェックを外します。

設定

すべての設定は WooCommerce > Settings > Payments > ePay.bg の 1 ページにあります。フィールドの上に、ストア通貨が BGN、EUR、USD のいずれでもない場合はエラー、ゲートウェイが有効なのに選択中のモードの MIN またはシークレットキーが空の場合は警告（この場合チェックアウトでは非表示になり、保存時にも同じエラーが表示されます）、テストモードがオンの間は Test mode is on: payments go to demo.epay.bg and no real money is charged. が表示されます。支払い方法の一覧では、選択中のモードの認証情報が入力されるまで、ePay.bg にセットアップが必要であることを示す表示が付きます。

一般

Enable/Disable: Enable ePay.bg Payment Gateway で支払い方法のオン・オフを切り替えます。デフォルト: オフ。

Title: チェックアウトで購入者に表示される支払い方法の名前。デフォルト: ePay.bg。

Description: チェックアウトで支払い方法の下に表示されるテキスト。デフォルト: Pay securely via ePay.bg with a bank card or your ePay.bg account.

ePay.bg アカウント

顧客番号（MIN）とシークレットキーは、www.epay.bg（本番）と demo.epay.bg（テストアカウント、別途登録）の加盟店プロフィールに表示されます。貼り付けたシークレットキー内のスペースと改行は、保存時に削除されます。

Test Mode: Enable test mode (use demo.epay.bg and the test credentials)。オンにすると、購入者は ePay.bg のデモ環境に移動し、リクエストはテスト用の認証情報で署名されます。デフォルト: オン。

Test Merchant ID (MIN): demo.epay.bg の加盟店アカウントの顧客番号（MIN）。

Test Secret Key: demo.epay.bg の加盟店アカウントのシークレットキー（64 文字）。

Live Merchant ID (MIN): www.epay.bg の加盟店アカウントの顧客番号（MIN）。

Live Secret Key: www.epay.bg の加盟店アカウントのシークレットキー（64 文字）。HMAC-SHA1 署名に使用されます。

バージョン 1.0 からアップデートする場合、テストモードがオンだったときは、そのバージョンの 1 組の認証情報がテスト用フィールドに移されます。

支払い通知（IPN）

通知は、支払いリクエストが支払い済み、拒否、または期限切れになったことをストアに伝えます。このセクションには通知 URL が表示されます。形式は https://your-site/wc-api/epaybg_payment_callback/ のようになります。これを ePay.bg の加盟店プロフィールの URL for receiving notifications に、本番とテストの両方で入力します。注文が支払い済みになるのはこの署名付き通知だけで、購入者がストアに戻っても注文は支払い済みになりません。

ePay.bg は請求書ごとに次の結果を通知します:

PAID: 購入者が支払いました。注文は支払い済みになります。

DENIED: 支払いが拒否されました。未払いの注文はキャンセルされます。

EXPIRED: 支払いリクエストが未払いのまま期限切れになりました。未払いの注文はキャンセルされます。

各通知は、選択中のモードのシークレットキーで検証されます。有効なチェックサムのない通知は拒否され、ePay.bg は再送を続けます。加盟店プロフィールに通知 URL がない場合、支払い済みになる注文はありません。

支払いリクエスト

Invoice Prefix: 数字のみ（最大 10 桁）。注文 ID の前に付けて ePay.bg の請求書番号になります。例: 00001 + 123 = 00001123。1 つの ePay.bg アカウントで複数のショップを運営する場合は、ショップごとに異なるプレフィックスを使用してください。それ以外の文字は保存時に削除されます。プレフィックスは後から変更しても問題ありません。支払い待ちの注文は、注文に保存された請求書で特定されます。デフォルト: 00001。

Expiration Time: 未払いの支払いリクエストが期限切れになるまでの時間。期限切れになると ePay.bg が期限切れとして通知し、支払い待ちの注文はキャンセルされます。1、3、6、12、24、48、72 時間から選択します。時刻は、サイトのタイムゾーンに関係なく、ブルガリア時間で送信されます。デフォルト: 24 時間。

Language: ePay.bg の決済ページの言語（英語またはブルガリア語）。デフォルト: 英語。

Order Status After Payment: 支払いが成功した後に設定される注文ステータス。ステータスは 2 回目の変更なしに、すぐに設定されます。

Default (WooCommerce decides): 処理中。ダウンロード可能なバーチャル商品のみの注文は完了（デフォルト）。

Processing: 支払い済みのすべての注文が処理中になります。

Completed: 支払い済みのすべての注文が完了になります。

On Hold: 支払い済みのすべての注文が、手動での確認待ちになります。

詳細設定

Logging: Enable logging をオンにすると、支払いリクエストと通知が WooCommerce > Status > Logs（ソース wcp_epaybg_gateway）に記録されます。シークレットキーとカード情報は含まれません。デフォルト: オフ。

Delete Data on Uninstall: Remove all plugin data when uninstalled。チェックすると、プラグインをアンインストールしたときに、ゲートウェイの設定、注文に保存された ePay.bg のデータ、プラグインのログが削除されます。デフォルト: オフ。

チェックアウト

購入者は支払い方法（デフォルトでは ePay.bg）を選択して注文します。購入者には Redirecting to ePay.bg for payment... と表示され、注文通貨での注文合計、請求書番号、有効期限を含む署名付き支払いリクエストとともに ePay.bg に移動します。リダイレクトが始まらない場合に備えて、このページには Pay via ePay.bg ボタンと Cancel order ボタンもあります。ePay.bg では、購入者は銀行カードまたは ePay.bg アカウントで支払います。

支払い後、購入者はストアの注文受付ページに戻ります。注文が支払い済みになるのは、署名付きの ePay.bg 通知が届いたときだけです。カートは注文受付ページでのみ空になります。

購入者が ePay.bg でキャンセルした場合、注文は WooCommerce の標準の方法でキャンセルされ、カートは保持されるため、購入者は別の支払い方法を選択できます。

注文を ePay.bg で支払えない場合、購入者には短いメッセージが表示されます。例: ePay.bg payments are temporarily unavailable. Please choose another payment method.、または ePay.bg が注文通貨での支払いを受け付けていない旨のメッセージ。

この支払い方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで動作します。WooCommerce の高パフォーマンス注文ストレージ（HPOS）に対応しています。

本プラグインは ePay.bg での 1 回限りの支払いのみに対応しています。WooCommerce からの返金、保存済みカードやトークン化、サブスクリプションや定期支払い、EasyPay や B-Pay の現金支払いコードには対応していません。

注文

注文ステータス

Pending payment: 購入者は ePay.bg に移動したがまだ支払っていない、または通知がまだ届いていません。注文メモには Awaiting ePay.bg payment. と表示されます。

Processing, Completed or On Hold: 支払いが確認されました。ステータスは Order Status After Payment の設定に従います。注文メモには、請求書番号、支払い日、STAN、BORICA コードが表示されます。取引 ID は STAN です（STAN がない場合は請求書番号）。

On hold after payment: 支払いは届きましたが、注文の現在の内容と一致しません。支払いリクエスト後に合計または通貨が変更された、リクエストが別のモードで行われた、またはその後ゲートウェイがテストと本番の間で切り替えられた、注文の支払い方法が変更された、あるいは注文が以前にキャンセルされていた場合です。理由は注文メモに記載されます。ePay.bg の加盟店パネルで支払いを確認し、注文を手動で完了するか返金してください。

Cancelled: ePay.bg が支払いリクエストを拒否または期限切れとして通知した、または購入者が ePay.bg でキャンセルしました。WooCommerce が在庫を元に戻します。キャンセルされた注文は再度支払うことができません。ePay.bg の請求書番号はプレフィックスと注文 ID の組み合わせだからです。購入者は新しく注文します。

遅れて届いた拒否または期限切れの通知が支払い済みの注文を変更することはありません。すでに支払い済みまたは返金済みの注文に対する支払いが届いた場合、ステータスは変更されず、メモで ePay.bg の加盟店パネルで二重払いがないか確認するよう案内されます。

返金

ePay.bg の WEB API には返金の呼び出しがないため、WooCommerce からの返金はできません。ePay.bg の加盟店パネルで支払いを返金し、WooCommerce に手動で返金を記録してください。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに ePay.bg が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、選択中のモードの MIN とシークレットキーが設定されていること、ストア通貨が BGN、EUR、USD のいずれかであることを確認してください。設定ページには、これらの各ケースで警告が表示されます。

支払いは完了したが、注文が支払い待ちのまま: 注文が支払い済みになるのは ePay.bg の通知だけです。使用しているモード（デモまたは本番）の ePay.bg 加盟店プロフィールに通知 URL が入力されていること、有効なモードのシークレットキーが正しいことを確認してください。Logging をオンにして、WooCommerce > Status > Logs（ソース wcp_epaybg_gateway）を確認します。

通知が ERR=Not valid CHECKSUM を返す: 設定のシークレットキーが、通知を送信した加盟店プロフィールと一致していません。通知は、現在選択中のモードのキーで検証され、次にもう一方のモードのキーで検証されるため、モードを切り替える前に行われた支払いリクエストも引き続き受け付けられます。ePay.bg は再試行を続けるので、キーが正しくなれば注文は更新されます。

通知が ERR=Not configured を返す: 選択中のモードのシークレットキーが空です。入力してください。

通知が請求書に対して STATUS=NO を返す: その請求書は、このストアの ePay.bg 注文のものではありません。たとえば、同じ ePay.bg アカウントの別のショップが発行したものです。各ショップに固有の Invoice Prefix を設定してください。

通知が STATUS=ERR を返す: 一時的なエラーです。たとえば、同じ注文に対して 2 つの通知が同時に届いた場合です。ePay.bg は通知を再送します。

支払い後に注文が保留中になる: 注文メモを確認してください。支払いリクエスト後に合計または通貨が変更された、リクエストが別のモードで行われた、またはその後モードが切り替えられた、支払い方法が変更された、あるいは注文がキャンセルされていた可能性があります。ePay.bg の加盟店パネルで支払いを確認してください。

保存時に請求書プレフィックスが変更された: プレフィックスには数字のみ、最大 10 桁まで使用できます。それ以外の文字は削除されます。

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

開発者向け: readme には、たとえばカード直接入力ページ（PAGE=credit_paydirect）を使用するためのフィルター epay_bp_form_fields が記載されています。

アンインストール

プラグインを無効化してもすべてのデータは保持されます。削除するには、Plugins ページで無効化してから削除します。このプラグインのライセンスキーとライセンスステータスは常に削除されます。ゲートウェイの設定、注文に保存された ePay.bg のデータ、ログは、Delete Data on Uninstall がオンだった場合にのみ削除されます。オンでなかった場合は、後で再インストールするときのために残ります。既存の注文の支払いメモと取引 ID は保持されます。

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