VibeFox Autopay for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

WooCommerce: 8.0 以降がインストールされ、有効になっていること。

PHP: 8.0 以降。

Autopay サービス: Autopay サービスの Service ID と Shared key（ハッシュキー）が必要です。これらは Autopay の加盟店ポータルに表示されます。本番は portal.autopay.eu、テストは testportal.autopay.eu です。テストサービスには独自の Service ID と Shared key があります。Autopay に依頼して開設してもらってください。サービスのハッシュ関数は SHA-256 である必要があります。

通貨: ストア通貨は PLN、EUR、GBP、USD、CZK のいずれかで、お使いの Autopay サービスが受け付けている必要があります。

到達可能なストア: Autopay がストアに通知を送信できる必要があります。そのため、メンテナンスモード、ベーシック認証、POST リクエストを遮断するファイアウォールなしで、インターネットからアクセスできる必要があります。

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

インストール

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

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

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

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

5. Service ID と Shared key（テストと本番の両方）を入力し、お使いのサービスの通貨を選択します。

6. Autopay の管理画面で、サービスの ITN URL、戻り先 URL、SHA-256 ハッシュ関数を設定します（「設定」の項を参照）。

7. Enable/Disable をオンにします。テストモードでテスト注文を行い、実際の支払いを受け付けるには Test mode のチェックを外します。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > Autopay。フィールドの上に、選択した環境の Service ID または Shared key が空の場合と、ストア通貨が Currencies で選択されていない場合に警告が表示されます。どちらの場合も、チェックアウトで支払い方法は非表示になります。支払い方法の一覧では、選択した環境に認証情報が入力されるまで、Autopay に設定が必要と表示されます。

一般

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

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

Description: チェックアウトで支払い方法の下に表示される説明文。既定値: Pay online by bank transfer, BLIK or card. You will be redirected to the secure Autopay payment page.

Autopay サービス

Service ID と Shared key は、Autopay の加盟店ポータル（portal.autopay.eu または testportal.autopay.eu）に表示されます。

Test mode: Use the Autopay test environment (testpay.autopay.eu) and the test credentials below。既定値はオンです。オフにすると、本番の認証情報を使って pay.autopay.eu で実際の支払いを受け付けます。

Service ID (production): portal.autopay.eu にある数値のサービス識別子。

Shared key (production): 本番サービスのハッシュキー。秘密にしてください。

Service ID (test): testportal.autopay.eu にある数値のサービス識別子。

Shared key (test): テストサービスのハッシュキー。

Currencies: お使いの Autopay サービスが受け付ける通貨: PLN、EUR、GBP、USD、CZK。Autopay は通常、通貨ごとに個別のサービスを開設します。支払い方法は、注文の通貨がここで選択されている場合にのみ提供されます。既定値: PLN。

支払い通知（ITN）と戻り先アドレス

これらのアドレスを、本番用とテスト用の各サービスについて Autopay の管理画面に入力してください。正確なアドレスは、設定のこの項に表示されています。

ITN (transaction notification) URL: https://your-site/?wc-api=wc_ap_payment

Return URL (after payment): https://your-site/?wc-api=wc_ap_return

ITN URL がないと、注文は支払い済みになりません。各 ITN は、一致するサービスの Shared key で作成された SHA-256 ハッシュで確認されます。有効なハッシュがない通知、または未知の Service ID の通知は拒否されます。通知は、同じ Autopay サービスで注文の支払いが開始された場合にのみ、その注文に適用されます。Test mode を切り替える前に開始された支払いの通知も、正しいキーで引き続き検証されます。

プラグインは ITN で次の支払いステータスを処理します:

SUCCESS: 支払いが行われました。金額と通貨の確認の後、注文が支払い済みになります。

PENDING: 支払いが開始されました。注文メモが追加されます。

FAILURE: 支払いに失敗しました。支払い待ちの注文は失敗になります。

詳細設定

Logging: Log payment events を WooCommerce > Status > Logs のソース wcp_autopay_payment に記録します。キーや購入者のデータは、決してログに記録されません。既定値はオフです。

チェックアウト

購入者は支払い方法（既定では Autopay）を選び、注文を確定します。次のページには Thank you for your order. You are being redirected to Autopay to complete the payment. と表示され、購入者は Autopay の決済ページに移動します。購入者がブラウザの戻るボタンで戻ってきた場合、そのページは再度リダイレクトする代わりに Pay with Autopay ボタンを表示します。

プラグインは、注文の通貨での注文合計額、説明として注文番号（Order と番号）、購入者の請求先メールアドレスを渡します。Autopay のページで、購入者は支払い方法を選んで支払います。

支払い後、購入者は注文受付ページに戻ります。戻り先アドレスには署名が付いていますが、注文ステータスを変更することはありません。注文が支払い済みになるのは、Autopay が署名付きの ITN で確認し、金額と通貨が注文と一致した後だけです。

支払いに失敗した場合、注文は失敗になり、購入者は Pay リンクから注文で再度支払うことができます。支払いを開始できない場合、購入者には Autopay payments are not configured. Please choose another payment method or contact the store. などの短いメッセージ、または、この通貨では Autopay で支払いを受け付けられないという内容が表示されます。

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

このプラグインには、WooCommerce からの返金、サブスクリプションや定期払い、カードの保存（1-Click）、チェックアウトページの BLIK コードやカードフォーム、チェックアウトページでの銀行や決済チャネルの選択はありません。また、環境ごとに 1 つの Service ID を使用します。

注文

注文ステータス

Pending payment: 購入者は Autopay に移動しましたが、Autopay はまだ支払いを確認していません。

Processing or Completed: Autopay が支払いを確認しました。WooCommerce は、処理中に設定します。ダウンロード可能な仮想商品のみの注文の場合は、完了に設定します。注文メモには、金額、Autopay のトランザクション、支払い日が表示されます。トランザクション ID は Autopay のトランザクション ID（RemoteID）です。

On hold: Autopay が注文合計と異なる金額または通貨を報告しました。注文は支払い済みになっていません。Autopay のポータルでトランザクションを確認し、手動で完了させるか返金してください。

Failed: 支払いに失敗しました。購入者は注文から再度支払うことができます。

支払い済みの注文が、後から届いた失敗通知によって変更されることはありません。Autopay が支払い済みの注文に対して別の成功した支払いを報告した場合、注文メモで購入者が二重に支払った可能性が警告されます。別の Autopay サービスで開始された支払いの通知は適用されず、その理由が注文メモで説明されます。

返金

WooCommerce からの返金はサポートされていません。Autopay のポータルで支払いを返金し、その後 WooCommerce で手動の返金を作成して記録してください。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに Autopay が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、選択した環境に Service ID と Shared key があること、ストア通貨が Currencies で選択されていることを確認してください。いずれかが欠けている場合、設定ページに警告が表示されます。

支払いは完了したが、注文が Pending payment のまま: Autopay が ITN を届けなかったか、ストアがそれを拒否しました。設定に表示された ITN URL が、Autopay のポータルで（本番またはテストの）サービスに設定されていること、ハッシュ関数が SHA-256 であること、プラグインの Shared key がサービスと一致することを確認してください。ストアがインターネットから到達可能かも確認します。Logging をオンにし、WooCommerce > Status > Logs のソース wcp_autopay_payment を確認してください。

ログに ITN rejected: invalid hash と表示される: Shared key がサービスと一致しないか、サービスのハッシュ関数が SHA-256 ではありません。

ログに、Service ID が設定されていないと表示される: 通知は、Service ID がプラグインに入力されていないサービスから届きました。

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

注文メモに the notification was NOT applied と表示される: この注文の支払いは、この Autopay サービスで開始されたものではありません（例: 本番の注文に対するテスト通知）。Autopay のポータルでトランザクションを確認してください。

支払い後、購入者がホームページに移動する: 戻り先アドレスを検証できませんでした（例: Service ID がプラグインに入力されていないため）。注文ステータスには影響せず、ITN に従います。

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

アンインストール

プラグインを無効化してもすべてのデータは保持されます。削除するには、Plugins ページで無効化してから削除します。このプラグインのライセンスキーとライセンスステータス、およびゲートウェイの設定は削除されます。設定を残すオプションはありません。既存の注文は、支払いメモとトランザクション ID を保持します。

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