VibeFox Paysera for PrestaShop — ヘルプ

動作環境

PrestaShop：8.0 から 9.x。

PHP：8.0 以降。モジュールは、それより古い PHP のバージョンではインストールできません。

Paysera プロジェクト：Paysera プロジェクトのプロジェクト ID とプロジェクトパスワード（sign key）が必要です。お客様に表示される支払い方法は、このプロジェクトで有効になっているものです。コールバックのために Paysera で設定する必要はありません。そのURLは支払いリクエストごとに送信されます。

到達可能なショップ：注文は Paysera のコールバックによって作成されるため、ショップがインターネットから到達可能である必要があります。ログイン、ベーシック認証、ファイアウォールの背後にあってはなりません。コールバックは、ショップがメンテナンスモードの間も動作します。

VibeFox ライセンスキー：vibefox.net で購入します。1つのキーは1つのドメインで動作します。

インストール

1. 管理画面で Modules > Module Manager に移動し、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。

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

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

4. Paysera アカウントの Project ID と Project password を入力します（設定を参照）。

5. 任意：料金を請求せずに流れを試すには、Paysera プロジェクトで Allow test payments、モジュールで Test payments を有効にします。販売を始める前にオフにしてください。

6. Enable/Disable をオンにして、Save をクリックします。

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

設定

すべての設定はモジュールのページにあります：Modules > Module Manager > VibeFox Paysera Payment > Configure。各セクションには独自の Save ボタンがあり、ページ全体が保存されます。フィールドの上には、どちらかが未入力の間は Paysera is hidden at checkout until the project ID and the project password are entered. と表示され、テスト支払いまたはサンドボックスが有効な間は Test mode is on: customers are not charged. Turn off "Test payments" and select "Production" before accepting real orders. と表示されます。

Paysera

Enable/Disable：Enable Paysera Payment は、支払い方法をオンまたはオフにします。デフォルト：off。

Title：お客様が決済時に見る支払い方法の名前です。注文にも、支払い方法の名前として保存されます。デフォルト：Paysera。必須。

Description：決済時に支払い方法の下に表示されるテキストです。デフォルト：Pay securely via Paysera。

Paysera プロジェクト

プロジェクト ID とプロジェクトパスワードは、Paysera アカウントの Projects and activities、該当するプロジェクト、General project settings で確認できます。

Callback URL：Paysera が各支払いを確認するために使用するアドレスです。フレンドリー URL を使用している場合は、https://your-shop/module/wcp_paysera_payment/callback のような形になり、言語コードが付くこともあります。各支払いに自動的に付加されるため、Paysera で設定する必要はありませんが、インターネットから到達可能である必要があります。注文は、この署名付きコールバックによってのみ作成されます。

Project ID：Paysera プロジェクトの数値 ID です。数字のみが受け付けられます。それ以外の値を入力すると、Project ID must be a number: the numeric ID of your Paysera project. というエラーが表示され、何も保存されません。

Project password：プロジェクトパスワード（sign key）です。支払いリクエストに署名し、Paysera のコールバックを検証します。保存されたパスワードは再度表示されません。フィールドは空のままで、Saved — leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。

Clear saved password：Project password にチェックを入れて Save をクリックすると、保存されたパスワードを削除します。フィールドが空の場合は、保存された値が維持されます。

テスト

Test payments：テストモードで支払いを送信するため、料金は請求されません。Paysera は、お客様に請求せずに成功したテスト支払いを返します。事前に Paysera プロジェクトの設定で Allow test payments を有効にしてください。このオプションがオンの間、テスト支払いは注文を支払い済みとしてマークします。オフの場合は、テスト支払いによって注文が保留になります。デフォルト：off。オンの間、お客様には支払い方法の下に TEST MODE — no money will be charged. と表示されます。

Environment：お客様が移動する先です。通常の Paysera プロジェクトでは、テスト支払いを含めて Production のままにしてください。デフォルト：Production。

詳細設定

Debug log：支払いイベントを、モジュールフォルダ内の logs/wc_psr_debug.log.php に書き込みます。このファイルはウェブから開くことはできません。エラーと警告は常に書き込まれますが、その他の手順はこのオプションがオンの間のみ書き込まれます。パスワードとお客様のデータは書き込まれることはありません。デフォルト：off。

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

Delete data：オンの場合、モジュールをアンインストールするとモジュールの設定とログが削除されます。注文データ（注文、Paysera の支払い記録、注文ステータス）は常に保持されます。デフォルト：off。

決済

決済の段階で、お客様は支払い方法（デフォルトは Paysera）を選択し、注文を確定します。モジュールは、カートの通貨の最小単位によるカートの合計金額、お客様の氏名、メールアドレス、請求先住所、およびショップページの言語（リトアニア語、ラトビア語、エストニア語、ロシア語、ドイツ語、ポーランド語、それ以外は英語）を含む、署名付きの支払いリクエストを作成します。お客様は Paysera の決済ウィンドウに移動し、そこで銀行、カード、その他の方法を選択します。この時点では、まだ注文は存在しません。

Paysera は、サーバー間のコールバックによって支払いを確認します。注文は、Paysera が署名付きコールバックで確認した後にのみ支払い済みとしてマークされます。お客様がショップに戻っただけでは、注文が作成されたり支払い済みになったりすることはありません。コールバックの後にお客様が戻ってきた場合は、標準の注文確認ページが表示されます。銀行が支払い指示を受け付けたもののまだ実行していない場合は、注文が Awaiting Paysera payment の状態で作成され、ページには Paysera is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. と表示されます。保留中の注文の場合、ページには Your payment is being reviewed. We will contact you if anything else is needed. と表示されます。

コールバックの前にお客様が戻ってきた場合、Payment confirmation ページが表示され、Paysera が支払いを確認するとすぐに注文が作成されることが説明され、Check again と Back to checkout が提供されます。

お客様が Paysera ウィンドウでキャンセルすると、決済ページに戻り、The Paysera payment was cancelled. You can try again or choose another payment method. と表示されます。Paysera が支払いは実行されなかったと報告した場合は、The payment was not completed. You can try again or choose another payment method. と表示されます。どちらの場合もカートは保持されます。カートにすでに注文がある場合、新しい試行は2回目の支払いではなく、直接注文確認に進みます。

支払いを開始できない場合、お客様は決済ページに留まり、Paysera payments are temporarily unavailable. Please choose another payment method. と表示されます。注文合計が無効な場合は、This order cannot be paid via Paysera. と表示されます。理由はログに記録されます。

コールバックは、ショップがメンテナンスモードの間も動作し、ショップの国別制限にはブロックされません。

本モジュールは、管理画面からの返金、決済ページでの銀行や支払い方法の選択、サブスクリプション、保存済みカード、Paysera の配送サービスや宅配サービスには対応していません。

注文

注文ステータス

No order yet：お客様は Paysera に移動しましたが、コールバックがまだ届いていないか、お客様がキャンセルしました。カートのみが存在します。

Payment accepted：Paysera が、金額と通貨が一致する支払いを確認しました。支払いは、Paysera リクエスト ID をトランザクション ID として記録され、リクエストと支払い方法を示すメモが表示されます。テスト支払いの場合は、(TEST — no money charged) と表示されます。

Awaiting Paysera payment：Paysera が支払い指示を受け付けましたが、銀行がまだ実行していません。Paysera が支払いを確認すると、注文は Payment accepted に移ります。

Paysera payment on hold：支払いには手動での確認が必要です。支払われた金額または通貨がカートまたは注文合計と異なる場合、Test payments がオフの間に TEST 支払いが届いた場合（料金は請求されていません）、またはお客様がキャンセルした後に支払いが確認された場合です。支払いは記録されません。メモに理由が表示され、Paysera ブロックには、Paysera アカウントで支払いを確認した上で、注文を Payment accepted に設定するか、キャンセルして Paysera で返金するよう求める内容が表示されます。

Cancelled：キャンセルされた注文について後から確認された支払いは、注文のステータスを変更しません。メモには、注文を復元する（Payment accepted に設定する）か、Paysera で支払いを返金するよう求める内容が表示されます。キャンセルされた注文に対する後続の TEST 支払いや金額の不一致も、メモを追加するだけです。

すでに支払い済みの注文に別の成功した支払いが届いた場合、注文は変更されず、メモには、重複した支払いを Paysera アカウントで返金するよう求める内容が表示されます。その他の Paysera のステータス（支払いが実行されていない、追加情報が必要など）は、メモを追加するだけです。

Paysera 支払いブロック

注文ページには、Paysera payment ブロックが表示されます。このブロックには、Paysera 注文 ID（カート番号と試行回数）、Paysera リクエスト ID、環境と TEST payment の表示、支払いステータス、リクエストされた金額と支払われた金額、支払い方法、モジュールのメモが含まれます。

返金

管理画面からの返金はサポートされていません。Paysera の決済ウィンドウのプロトコルには返金 API がありません。返金は Paysera アカウントで行ってください。Paysera が返金を報告すると、返金額を示すメモが注文に追加されます。注文ステータスは変わりません。必要に応じて、PrestaShop で返金を手動で記録してください。

ライセンスキー

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

有効なキーがない場合、決済時のお客様には Paysera が表示されません。それでも支払いが開始された場合、お客様には This payment method is not available. Please choose another one. と表示されます。PrestaShop のストアフロントは、管理画面にログインしていることを認識しないため、お客様だけでなくあなたにも支払い方法は非表示になります。キーを購入する前にモジュールを設定することはできますが、決済でテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文には影響しません。すでに開始された支払いは、コールバックによって引き続き確認されます。

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

トラブルシューティング

決済ページに Paysera が表示されない：ライセンスが有効であること、Enable/Disable がオンであること、Project ID と Project password の両方が入力されていることを確認してください。どちらかが未入力の間、設定ページには警告が表示されます。Payment > Preferences で、カートの通貨、お客様の国、お客様の顧客グループに対してモジュールが許可されているか確認してください。

支払いは完了したが、注文が作成されない：注文は、お客様が戻ってくることではなく、Paysera のコールバックによって作成されます。設定に表示される Callback URL で、ショップがインターネットから到達可能であることを確認してください（ログイン、ベーシック認証、ファイアウォールの背後ではないこと）。また、モジュールページの Log フィールドを確認してください。

コールバックが Invalid signature と応答する：Project password がプロジェクトと一致していないか、コールバックが Paysera からのものではありません。プロジェクトパスワードを再度コピーしてください。プロジェクトやパスワードを変更した場合、変更前に開始された支払いは検証できなくなります。

コールバックが Project ID mismatch と応答する：設定の Project ID が、支払いを行ったプロジェクトと異なります。

コールバックが Order not found と応答する：コールバックのカートに、このショップでの Paysera 支払いがありません。例えば、同じプロジェクトを使用する別のショップで支払いが開始された場合などです。

コールバックが Gateway not configured、Busy、Temporary error と応答する：プロジェクト ID またはパスワードが空である、同じカートに対する別のコールバックがまだ実行中である、または注文を作成できなかった（例：モジュールが無効になっている）ためです。Paysera はコールバックを再試行します。理由を確認するには Debug log をオンにしてください。

Paysera が決済ウィンドウを拒否する、またはプロジェクトが存在しないと表示される：Environment を確認してください。通常の Paysera プロジェクトは Production でのみ動作します。Sandbox には、Paysera のサンドボックス環境で作成されたプロジェクトが必要です。

テスト支払いで注文が支払われない：TEST 支払いは、Test payments がオンの場合にのみ注文を支払います。それ以外の場合、注文は保留になり、料金が請求されていないことを示すメモが付きます。Paysera プロジェクトで Allow test payments も有効にしてください。

注文が Paysera payment on hold になり、金額/通貨の不一致に関するメモが付いている：Paysera が、金額または通貨がカートの合計と異なる支払いを確認しました。例えば、お客様が支払いを始めた後に、別のタブでカートが変更された場合などです。Paysera アカウントで支払いを比較し、注文を承認するか、手動で返金してください。同じ注文に対して後から正しい支払いが届くと、注文は支払い済みになります。

お客様に Paysera payments are temporarily unavailable と表示される：Log フィールドを確認してください。プロジェクト ID またはパスワードが空である、または Paysera に送信されたショップのアドレスのいずれかが 255 文字を超えている可能性があります。

アンインストール

Modules > Module Manager に移動し、VibeFox Paysera Payment の横のメニューを開いて、Uninstall を選択します。このモジュールのライセンスキーとライセンスステータスは、常に削除されます。Delete data がオンの場合、モジュールの設定とログが削除されます。オフの場合は、後で再インストールできるように、すべての設定が保持されます。Paysera の支払い記録と、Awaiting Paysera payment および Paysera payment on hold の注文ステータスは、常に保持されます。既存の注文は、支払いのメモとトランザクション ID を保持します。

Paysera は、それぞれの所有者の商標です。本モジュールは Paysera と提携しておらず、Paysera による承認も受けていません。