VibeFox Paysera for WooCommerce — ヘルプ

要件

WordPress：6.0 以降。

WooCommerce：7.0 以降。インストールされ、有効化されている必要があります。WooCommerce がない場合、プラグインは有効化できません。

PHP：8.0 以降。

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

到達可能なサイト：注文は Paysera のコールバックによって支払い済みになるため、サイトはインターネットから到達可能である必要があります。ログイン画面、メンテナンスモード、ファイアウォールの背後にあってはいけません。

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

インストール

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

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

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

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

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

6. 任意：お金を請求せずに流れを試すには、Paysera プロジェクトで Allow test payments、プラグインで Test payments を有効にします。販売を開始する前に無効にしてください。

7. Enable/Disable をオンにして保存します。

設定

すべての設定は1つのページにあります：WooCommerce > Settings > Payments > Paysera。フィールドの上には、Project ID か Project password のどちらかが未入力の場合、Project ID と Project password が入力されるまで、Paysera はチェックアウトで非表示になります。 と表示されます。また、テスト支払いまたはサンドボックスが有効な間は、お客様から料金を請求していないことを示す通知が表示されます。決済方法の一覧では、プロジェクトの設定が完了するまで Paysera は設定が必要とマークされ、テスト支払いまたはサンドボックスが有効な場合はテストモードのバッジが表示されます。

一般

Enable/Disable：Enable Paysera Payment で決済方法のオン／オフを切り替えます。デフォルト：オフ。

Title：チェックアウトでお客様に表示される決済方法の名前。デフォルト：Paysera。

Description：チェックアウトで決済方法の下に表示されるテキスト。デフォルト：Pay securely via Paysera。

Paysera プロジェクト

プロジェクト ID とプロジェクトパスワードは、Paysera アカウントの Projects and activities で、対象のプロジェクトを選び、General project settings を開くと確認できます。このセクションにはコールバック URL が表示されます。形式は https://your-site/wc-api/wc_psr_payment/ のようになります。支払いのたびに自動的に送信されるため、Paysera で設定する必要はありません。

Project ID：Paysera プロジェクトの数値 ID。

Project password：プロジェクトパスワード（署名キー）。支払いリクエストに署名し、Paysera からのコールバックを検証するために使用されます。

テスト

Test payments：Send payments in test mode (no money is charged)。お客様に請求することなく、Paysera が成功したテスト支払いを返します。まず Paysera プロジェクトの設定で Allow test payments を有効にしてください。このオプションがオンの間、テスト支払いは注文を支払い済みにします。オフの場合、テスト支払いで注文が支払い済みになることはありません。デフォルト：オフ。

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

詳細設定

Debug log：Log payment events。エラーは常に記録されます。ログは WooCommerce > Status > Logs にあり、ソースは wcp_paysera_payment です。パスワードとお客様のデータは書き込まれません。デフォルト：オフ。

Delete data：Delete the plugin settings and logs when the plugin is deleted。プラグインを無効化しても何も削除されません。注文データは常に保持されます。デフォルト：オフ。

チェックアウト

お客様は決済方法（デフォルトは Paysera）を選択し、注文を確定します。テスト支払いがオンの場合、チェックアウトには TEST MODE — no money will be charged. と表示されます。プラグインは、注文通貨の最小単位で注文合計額、お客様の氏名、メールアドレス、請求先住所を含む署名付きの支払いリクエストを作成します。また、サイトの言語に応じて表示言語を選択します（リトアニア語、ラトビア語、エストニア語、ロシア語、ドイツ語、ポーランド語。それ以外は英語）。お客様は Paysera の決済ウィンドウに移動し、そこで銀行、カード、またはその他の方法を選択します。

支払い後、お客様は注文受付ページに戻ります。注文は、署名付きの Paysera コールバックが届いた時点でのみ支払い済みになります。お客様が戻っただけでは、注文が支払い済みになることはありません。

お客様が Paysera ウィンドウでキャンセルした場合、注文は WooCommerce の標準的な方法でキャンセルされ、お客様は再度注文できます。支払いを開始できない場合、お客様には Paysera 決済は一時的に利用できません。別の決済方法を選択してください。 と表示されます。理由はログに記録されます。

この決済方法は、従来のチェックアウト、チェックアウトブロック、および Pay for order ページで動作します。WooCommerce の High-Performance Order Storage（HPOS）に対応しています。

このプラグインでは、WooCommerce からの返金、チェックアウトページでの銀行や決済方法の選択、サブスクリプション、保存済みカード、Paysera の配送またはクーリエサービスには対応していません。

注文

注文ステータス

Pending payment：お客様は Paysera に移動しましたが、コールバックはまだ届いていません。

Processing：Paysera が支払いを確認しました（ステータス 1）。ダウンロード可能な仮想商品のみの注文は、WooCommerce のデフォルトである完了になります。注文メモには Paysera のリクエストと決済方法が表示されます。トランザクション ID は Paysera のリクエスト ID です。

On hold：Paysera は支払い指示を受け付けましたがまだ実行していません（ステータス 2）。Paysera が支払いを確認すると、注文は完了になります。または、支払われた金額または通貨が注文と異なります（メモ amount/currency mismatch）。または、テスト支払いがオフの間にテスト支払いを受信したため、料金は請求されていません。注文メモに理由が記載されています。

Cancelled：お客様が Paysera ウィンドウでキャンセルしたか、あなたまたは在庫保持のタイムアウトによって注文がキャンセルされました。キャンセル済みの注文に対して後から確認された支払いがあっても、注文のステータスは変わりません。メモで、注文を復元（Processing に設定）するか、Paysera で支払いを返金するよう促されます。

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

返金

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

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに Paysera が表示されない：ライセンスが有効であること、Enable/Disable がオンであること、Project ID と Project password の両方が入力されていることを確認してください。どちらかが未入力の間は、設定ページに警告が表示されます。

支払いは完了したのに、注文が Pending payment のまま：注文は、お客様の戻りではなく Paysera のコールバックによって支払い済みになります。設定に表示されたコールバック URL で、サイトがインターネットから到達可能であることを確認してください（ログイン画面、メンテナンスモード、ファイアウォールの背後にないこと）。また、WooCommerce > Status > Logs をソース wcp_paysera_payment で確認してください。

コールバックが Invalid signature を返す：Project password がプロジェクトと一致していないか、コールバックが Paysera からのものではありません。プロジェクトパスワードを再度コピーしてください。

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

コールバックが Gateway not configured または Busy を返す：プロジェクト ID またはパスワードが空か、同じ注文の別のコールバックがまだ処理中です。Paysera はコールバックを再試行します。

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

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

チェックアウトにアイコンが表示されない：プラグインはデフォルトではアイコンを表示しません。開発者は wc_psr_gateway_icon フィルターでアイコンを設定できます。

注文が On hold になり、金額または通貨の不一致に関するメモがある：Paysera が、注文合計と金額または通貨が一致しない支払いを確認しました。たとえば、お客様が支払いを開始した後に注文が編集された場合などです。Paysera アカウントで支払いを照合し、注文を手動で完了するか返金してください。

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

アンインストール

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

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