VibeFox Barion for PrestaShop — ヘルプ

要件

PrestaShop: 8.0 から 9.x。

PHP: 8.0 以降。古いバージョンの PHP ではモジュールはインストールできません。

Barion ショップ: ショップの POSKey（秘密鍵）と、支払いを受け取る Barion ウォレットのメールアドレスが必要です。どちらも Barion ポータルで確認できます。本番は secure.barion.com、テストは secure.test.barion.com で、My stores からショップを選択します。テストと本番の認証情報は別々です。

通貨: カートの通貨は HUF、EUR、USD、CZK のいずれかである必要があります。それ以外の通貨では、チェックアウトで支払い方法が表示されません。

到達可能なショップ: Barion は支払いごとにショップを呼び出します。そのため、サイトはインターネットから到達可能で、前段にファイアウォールやベーシック認証がないことが必要です。

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

インストール

1. バックオフィスで Modules > Module Manager に進み、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。

2. アップロードが完了したら Configure をクリックします。後でモジュール一覧から VibeFox Barion Gateway を探して Configure をクリックすることもできます。

3. Configure ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを入力し、Activate をクリックします（「ライセンスキー」を参照）。

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

5. すべて正常に動作したら、本番の認証情報を入力し、Test Mode をオフにします。

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

インストール時にモジュールは 2 つの注文ステータス Awaiting Barion payment と Barion payment on hold を作成します。PrestaShop は、すべての通貨、国、顧客グループに対して新しい支払いモジュールを有効にします。Payment > Preferences で制限できます。

設定

すべての設定はモジュールのページにあります：Modules > Module Manager > VibeFox Barion Gateway > Configure。各セクションには独自の Save ボタンがあり、ページ全体が保存されます。フィールドの上には、現在のモードに POSKey または受取人のメールアドレスがない場合（その場合、チェックアウトで支払い方法は非表示になります）や、ショップの既定の通貨が Barion でサポートされていない場合に、サポートされている通貨の一覧とともに警告が表示されます。テストモードがオンの間は、テストモードがオンです: 支払いは Barion のサンドボックス（api.test.barion.com）に送られ、実際の料金は請求されません。 と表示されます。

Barion

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 から、ご自身のショップを選びます。テストモードではテスト用の認証情報のみ、本番モードでは本番用の認証情報のみを使用します。

Test Mode: 下に入力したテスト用の認証情報と Barion のサンドボックス（api.test.barion.com）を使用します。実際の料金は請求されません。既定値: オン。実際の支払いを受け付けるにはオフにします。オンの間、購入者には支払い方法の下に テストモード: 実際の支払いは行われません。 と表示されます。

Test POSKey: Barion のテストシステムにおけるショップの秘密鍵（POSKey）（secure.test.barion.com、My stores）。

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

Live POSKey: Barion の本番システムにおけるショップの秘密鍵（POSKey）（secure.barion.com、My stores）。

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

保存された POSKey は二度と表示されません。フィールドは空のままになり、保存済み — 変更しない場合は空のままにしてください。 と表示されます。変更したい場合にのみ新しい値を入力してください。

Clear saved POSKeys: キーにチェックを入れて Save をクリックすると削除されます。フィールドが空の場合は、保存された値が保持されます。

Callback URL: 支払いのたびに Barion が呼び出すアドレスです。例えば、フレンドリー URL を使用している場合は https://your-shop/module/wcp_barion_gateway/callback となり、/en/ のような言語コードが付くこともあります。支払いのたびに Barion に送信されるため、設定するものはありません。インターネットから到達可能であれば十分です。

注文

Order Status After Payment: 支払いが成功し、検証された後に設定される注文ステータスです。

Barion でまだ処理中の支払いは Awaiting Barion payment で待機します。金額または通貨が一致しない場合は、常に Barion payment on hold になります。

詳細設定

Logging: Barion へのリクエストとコールバックを、モジュールのフォルダ内にある logs/barion_p_debug.log.php に書き込みます。このファイルは Web から開くことはできません。秘密鍵とウォレットのメールアドレスは記録されません。既定値: オフ。オフの間は、エラーを含めて何も書き込まれません。

Log: ログのサイズと最新のエントリを表示します。Clear log をクリックするとログが空になります。

Delete Data on Uninstall: オンの場合、モジュールをアンインストールするとモジュールの設定とログが削除されます。注文、その Barion 支払いデータ、注文ステータスは常に保持されます。既定値: オフ。

チェックアウト

支払いの手順で購入者は支払い方法（既定では Barion）を選び、安全な Barion の決済ページに移動します。 という案内を目にします。確定すると、モジュールはカートの通貨でカート合計額について Barion の支払いを開始し、購入者を Barion の決済ページに案内します。支払いには商品、送料、ギフトラッピング、税が表示され、支払いはカート番号とともに Cart として表示されます。購入者のメールアドレスはヒントとして渡され、Barion が対応している場合はページの言語がカートの言語に従います。この時点ではまだ注文は存在しません。

支払い後、購入者はショップに戻り、Barion もコールバック URL を呼び出します。どちらのリクエストも、単独では何かを支払い済みにはしません。モジュールは、支払いを開始したモードの POSKey を使って Barion に支払い状態を確認します。注文が支払い済みになるのは、Barion が確認し、かつ金額と通貨がカートと一致した場合のみです。戻りリンクにはカートの安全なキーが含まれ、そのカートについて開始された支払いのみが確認されます。

支払いが成功すると注文が作成され、購入者には Barion での支払いを受け付けました。 と表示される標準の注文確認ページが表示されます。支払いが Barion でまだ処理中の場合、注文は Awaiting Barion payment で作成され、ページには Barion で支払いを確認中です。確認が完了すると、メールでお知らせします。 と表示されます。その後そのような支払いが Barion でキャンセル、期限切れ、または失敗した場合、ページには Barion での支払いが完了しませんでした。この注文についてお問い合わせください。 と表示されます。購入者が戻ったときに Barion に接続できない場合は、同じ「確認中」の文言と Check again ボタンを表示する 支払いの確認 ページが表示されます。コールバックは Barion が支払いを確認した時点で注文を作成します。

支払いが完了しなかった場合（キャンセル、期限切れ、または失敗）、注文は作成されず、カートは保持され、購入者は 支払いが完了しませんでした。もう一度お試しください。 と表示されたチェックアウトに戻ります。購入者は再試行できます。すべての試行は記録されるため、以前の試行の遅延した支払いでも注文は作成され、期限切れになった以前の試行によって新しい試行の注文がキャンセルされることはありません。

支払いを開始できない場合、購入者はチェックアウトに留まり、短いメッセージが表示されます：Barion での支払いを開始できませんでした。もう一度お試しいただくか、別の支払い方法をお選びください。、Barion は次の通貨での支払いに対応していません: カートの通貨、または Barion は合計金額がゼロの注文を処理できません。 Logging がオンの場合、詳細はログに書き込まれます。

コールバックは、ショップがメンテナンスモードの間も機能し、ショップの国による制限でブロックされることはありません。

このモジュールは即時決済のみに対応しています。オーソリや後日キャプチャの支払い、サブスクリプションや定期払い、保存されたカード、Barion Pixel、追加の 3-D Secure データはありません。3-D Secure は Barion がその決済ページで処理します。

注文と返金

注文ステータス

No order yet: 購入者は Barion に移動しましたが、まだ支払っていないか、Barion がまだ支払いを確認していません。存在するのはカートだけです。

Awaiting Barion payment: Barion が、支払いがまだ処理中であると報告しています。メモには Barion の PaymentId、金額、テストモードでは (test mode) が表示されます。Barion が支払いを確認すると、注文は「支払い受付」に移行します。

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

Barion payment on hold: 支払いが開始された後にカートが変更されたことなどにより、Barion が注文合計と異なる金額または通貨を報告しました。メモには両方の金額が表示されます。Barion ポータルで支払いを確認してから、注文を処理するか、Barion ポータルで支払いを返金してください。

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

Payment error: 保留中の注文の最新の支払い試行が失敗しました。

Refunded: 支払いはモジュールを通じて全額返金されました。

注文がキャンセルまたは失敗した後も、その注文の支払いがまだ成功する場合、注文は支払い済みになります。支払い済みまたは返金済みの注文は、後のコールバックによって決して変更されません。支払い済みの注文に対して別の支払いが成功した場合、メモで Barion ポータルでの確認と、重複であれば返金が求められます。メモは注文ページ上の非公開メッセージです。

Barion 支払いブロック

注文ページには、PaymentId、Barion のトランザクション、支払い状態、支払い済みと返金済みの金額、テスト支払い用の Test mode バッジ、返金履歴を含む Barion payment ブロックが表示されます。

返金

Barion payment ブロックで金額を入力し（まだ返金されていない金額が自動入力されます）、必要に応じて理由を入力して、Refund via Barion をクリックします。この金額を Barion 経由で返金しますか？この操作は取り消せません。 という確認に答えます。全額および一部の返金に対応しています。注文を編集する権限が必要です。理由はコメントとして Barion に送信されます。HUF の返金は整数の金額である必要があります。返金は支払いが行われたモード（テストまたは本番）で送信されるため、そのモードの POSKey が設定されている必要があります。Barion が返金を受け付けない、または確認しない場合、ブロックにエラーが表示され、返金は記録されません。返金が成功すると、返金履歴とメモに Barion のトランザクションとステータスとともに追加されます。全額返金を行うと、注文は Refunded になります。一部返金ではステータスは変わりません。

返金は、Barion が支払いを確認し、その支払いによって注文が支払い済みになってから利用できます。金額または通貨が一致しない支払いは PrestaShop から返金できません。Barion ポータルで返金してください。モジュールはクレジットスリップを作成せず、注文ページの標準の PrestaShop 返金ボタンでは Barion を通じて返金は行われません。

ライセンスキー

このモジュールは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox Barion Gateway は、Modules > Module Manager > VibeFox Barion Gateway > Configure ページの一番上（設定の上）にあります。キーを License key に入力し、Activate をクリックしてください。その後、ブロックにはキーがマスクされた状態で表示され、ステータス（ライセンスの有効期限日やドメインなど）と、ステータスを再確認する Check now、別のキーを入力する Change key、このショップからキーを削除する Remove key のボタンが表示されます。その下には、Product: presta-payment-barion の行と、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 のアカウントで枠を解放してください。

有効なキーがない場合、チェックアウトで Barion は購入者に表示されません。それでも支払いが開始された場合、購入者には This payment method is not available. Please choose another one. と表示されます。PrestaShop のストアフロントは、バックオフィスにログインしていることを認識しないため、支払い方法はご自身にも非表示になります。キーを購入する前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文には影響しません。すでに開始された支払いは引き続き確認され、返金も機能します。

ライセンスの期限が切れても、モジュールは動作を続けますが、アップデートとサポートには更新が必要です。バックオフィスで作業している間、ステータスは自動的に再確認されます。キー入力後の最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは不要です。モジュールをアンインストールまたはリセットすると、ライセンスキーとライセンスステータスは常に削除されます。

トラブルシューティング

チェックアウトに Barion が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在のモードに POSKey と受取人のメールアドレスがあること（不足している場合、設定ページに警告が表示されます）、カートの通貨が HUF、EUR、USD、CZK のいずれかであることを確認してください。Payment > Preferences で、カートの通貨、購入者の国、購入者のグループに対してモジュールが許可されているか確認してください。

支払いは完了したが注文が作成されない: 注文は、Barion がコールバック URL を呼び出したとき、または購入者がショップに戻ったときに作成されます。サイトがインターネットから到達可能であることを確認してください（コールバック URL の前にファイアウォールやベーシック認証がないこと）。支払いが行われたモードの POSKey が正しいか確認してください。モジュールはこの POSKey を使って Barion に支払い状態を確認します。コールバックを確認するには Logging をオンにしてください。

コールバックが Busy, retry を返す: 注文が、購入者の戻りによって同時に処理されていたか、注文を作成できませんでした（例: モジュールが無効になっている）。Barion は再度呼び出します。理由を確認するには Logging をオンにしてください。

コールバックが API error を返す: ショップが Barion から支払い状態を読み取れなかったか、支払いが行われたモードの POSKey が設定されていません。その POSKey を確認してください。

コールバックが Order not found を返す: その PaymentId はこのショップが開始したものではありません。他のショップやテストシステムに対する Barion の呼び出しは無視されます。

購入者に「支払いの検証に失敗しました」と表示される: 戻りリンクがカートと一致していません。例えば、別のブラウザセッションで開かれたか、編集されたことが考えられます。支払い状態は引き続きコールバックによって確認されます。

購入者が Barion を選択したときにエラーが表示される: Logging をオンにし、モジュールのページの Log フィールドを確認してください。POSKey または受取人のメールアドレスが誤っていると、Barion での支払いを開始できませんでした。 と表示されます。

注文が Barion payment on hold になっている: 注文の不一致メモを確認し、Barion ポータルで支払いを確認してから、注文を処理するか、Barion ポータルで返金してください。

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

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

アンインストール

Modules > Module Manager に進み、VibeFox Barion Gateway の横のメニューを開いて Uninstall を選択します。このモジュールのライセンスキーとライセンスステータスは、常に削除されます。Delete Data on Uninstall がオンの場合、モジュールの設定とログが削除されます。オフの場合、後で再インストールできるようにすべての設定が保持されます。注文の Barion 支払いデータと、Awaiting Barion payment および Barion payment on hold の注文ステータスは常に保持されるため、以前に支払われた注文は再インストール後も返金できます。既存の注文は、支払いメモとトランザクション ID を保持します。

Barion は各所有者の商標です。このモジュールは Barion と提携しておらず、Barion による推奨もされていません。