VibeFox Barion for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

WooCommerce: 7.0 以降がインストールされ、有効になっていること。WooCommerce がない場合、プラグインは管理画面に通知を表示し、支払い方法は読み込まれません。

PHP: 8.0 以降。

Barion ショップ: ショップの POSKey（シークレットキー）と、支払いを受け取る Barion ウォレットのメールアドレスが必要です。どちらも Barion のポータルにあります。本番は secure.barion.com、テストは secure.test.barion.com で、My stores とお使いのショップの下にあります。テストと本番では認証情報が異なります。

通貨: ストア通貨は HUF、EUR、USD、CZK のいずれかである必要があります。その他の通貨では、チェックアウトで支払い方法は非表示になります。

到達可能なストア: Barion は支払いのたびにストアを呼び出すため、サイトはインターネットから到達可能である必要があります。/wc-api/ の前に、メンテナンスモード、ファイアウォール、ベーシック認証があってはいけません。

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

インストール

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

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

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

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

5. テストの POSKey とテストウォレットのメールアドレスを入力し、Test Mode をオンのままにして、Enable/Disable をオンにします。テスト注文を行います。

6. すべてが動作したら、本番の認証情報を入力し、Test Mode のチェックを外します。

コールバック URL は、支払いのたびに自動的に Barion に送信されます。Barion のポータルで設定する必要はありません。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > Barion。ストア通貨が対応していない場合、ページの Barion shop credentials の項に赤字でその旨が表示され、対応している通貨が一覧表示されます。その場合、チェックアウトで支払い方法は非表示になります。

一般

Enable/Disable: Enable Barion Payment で支払い方法をオンまたはオフにします。既定値はオフです。

Title: 購入者がチェックアウトで見る支払い方法の名前。既定値: Barion。

Description: チェックアウトで支払い方法の下に表示される説明文。既定値: Pay securely with Barion — card, Barion Wallet, Apple Pay or Google Pay.

Barion ショップの認証情報

POSKey とウォレットのメールアドレスは、Barion のポータルで取得します: secure.barion.com（本番）または secure.test.barion.com（テスト）の My stores と、お使いのショップ。この項には、コールバック URL も表示されます（例: https://your-site/wc-api/barion_payment_callback/）。これは支払いのたびに Barion に送信されます。インターネットから到達可能であれば十分です。

Test Mode: Enable Barion test/sandbox mode。テストモードでは、以下のテスト用の認証情報と Barion サンドボックス（api.test.barion.com）を使用します。実際の料金は請求されません。既定値はオンです。実際の支払いを受け付けるには、チェックを外してください。

Test POSKey: Barion テストシステム（secure.test.barion.com、My stores）にあるショップの POSKey（シークレットキー）。

Test Payee Email: テスト支払いを受け取る Barion テストウォレットのメールアドレス。

Live POSKey: Barion 本番システム（secure.barion.com、My stores）にあるショップの POSKey（シークレットキー）。

Live Payee Email: 支払いを受け取る Barion ウォレットのメールアドレス。

注文

Order Status After Payment: 成功し、確認された支払いの後に設定される注文ステータス。

詳細設定

Logging: Enable debug logging。ログは WooCommerce > Status > Logs のソース wcp_barion_gateway に保存されます。シークレットキーは決してログに記録されません。既定値はオフです。

Delete Data on Uninstall: Remove the plugin settings when the plugin is deleted。注文と Barion の支払いデータは常に保持されます。既定値はオフです。

チェックアウト

購入者は支払い方法（既定では Barion）を選び、注文を確定します。プラグインは、注文の通貨での注文合計額について Barion の支払いを開始し、購入者を Barion の決済ページに移動させます。注文の商品、送料、手数料、税は支払い画面に一覧表示され、購入者の請求先メールアドレスはヒントとして渡されます。ページの言語は、Barion が対応している場合にストアの言語に従います。

支払い後、購入者はストアに戻ります。Barion もコールバック URL を呼び出します。どちらのリクエストも、それだけで注文を支払い済みにすることはありません。プラグインは POSKey を使って Barion に支払い状態を問い合わせ、Barion が確認し、金額と通貨が注文と一致した後にだけ、注文を支払い済みにします。戻りリンクには注文キーが含まれ、その注文に対して開始された支払いだけが確認されます。

支払いが成功した場合、または Barion でまだ処理中の場合、購入者は注文受付ページに移動します。それ以外の場合、購入者はチェックアウトに戻り、Payment was not completed. Please try again. と表示されます。購入者は再試行できます。すべての試行が記録されるため、以前の試行の遅延した支払いでも注文は完了します。

支払いを開始できない場合、購入者には The Barion payment could not be started. Please try again or choose another payment method. と表示されます。ログインしているストア管理者には、技術的な理由も表示されます。詳細はログに記録されます。

この支払い方法は、クラシックチェックアウトとチェックアウトブロックの両方で動作します。WooCommerce の高性能注文ストレージ（HPOS）に対応しています。

このプラグインは即時決済のみに対応しています。オーソリや後日キャプチャの支払い、WooCommerce Subscriptions や定期払い、カードの保存、Barion Pixel はありません。また、追加の 3-D Secure データもありません。3-D Secure は Barion が決済ページで処理します。

注文と返金

注文ステータス

Pending payment: Barion の支払いは開始されましたが、Barion はまだ確認していません。注文メモには、Barion PaymentId、金額、テストモードの場合は (test mode) が表示されます。

Processing or Completed: Barion が支払いを確認しました。ステータスは Order Status After Payment に従います。注文メモには、金額、PaymentId、トランザクションが表示されます。トランザクション ID は Barion のトランザクション ID です。

On hold: Barion が注文合計と異なる金額または通貨を報告しました。たとえば、支払いが開始された後に注文が編集された場合などです。Barion のポータルで支払いを確認し、手動で注文を完了させるか返金してください。

Cancelled: 最新の支払いの試行が、Barion でキャンセルされたか期限切れになりました。

Failed: 最新の支払いの試行が失敗しました。

支払い済みまたは返金済みの注文は、後から届いたコールバックによって変更されることはありません。支払い済みの注文に対して別の支払いが成功した場合、注文メモで Barion のポータルでの確認と、重複であれば返金するよう案内されます。

返金

注文を開き、Refund をクリックして金額を入力し、Refund via Barion をクリックします。全額返金と一部返金に対応しています。返金理由はコメントとして Barion に送信されます。HUF の返金は整数の金額である必要があります。返金は、注文が支払われたモード（テストまたは本番）で送信されるため、そのモードの POSKey が設定されている必要があります。Barion がリクエストを受け付けない、または確認しない場合、WooCommerce にエラーが表示され、返金は記録されません。返金に成功すると、Barion のトランザクションとステータスとともに注文メモに追加されます。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに Barion が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在のモードに POSKey と受取人のメールアドレスがあること、ストア通貨が HUF、EUR、USD、CZK のいずれかであることを確認してください。

支払いは完了したが、注文が Pending payment のまま: 注文は、Barion がコールバック URL を呼び出したとき、または購入者がストアに戻ったときに完了します。サイトがインターネットから到達可能であることを確認してください（/wc-api/ の前にメンテナンスモード、ファイアウォール、ベーシック認証がないこと）。プラグインは支払い状態の問い合わせに POSKey を使うため、注文が支払われたモードの POSKey が正しいことを確認してください。コールバックを確認するには、Logging をオンにしてください。

コールバックが Busy, retry と応答する: 購入者の戻りによって、同じ時刻に注文が処理されていました。Barion が再度呼び出します。

コールバックが API error と応答する: ストアが Barion から支払い状態を読み取れませんでした。注文が支払われたモードの POSKey を確認してください。

注文が不一致の注意メモ付きで On hold になっている: Barion が報告した金額または通貨が注文合計と異なります。Barion のポータルで支払いを確認し、手動で完了させるか返金してください。

10.50 HUF を返金できない: Barion は HUF を小数点なしで処理します。整数の金額を入力してください。

返金時に、この注文のモードの POSKey が設定されていないと表示される: 注文はテストまたは本番モードで支払われており、そのモードの POSKey が空です。入力してから再試行してください。

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

アンインストール

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

Barion は、それぞれの所有者の商標です。このプラグインは Barion と提携しておらず、Barion による推奨も受けていません。