VibeFox CorvusPay for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

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

PHP: 8.0 以降。

通貨: AUD、BAM、BHD、CAD、CHF、CZK、DKK、EUR、GBP、HRK、HUF、ISK、MKD、NOK、PLN、RON、RSD、RUB、SEK、USD。それ以外の通貨では、支払い方法はチェックアウトで非表示になります。金額は小数 2 桁で送信されます。それより小数桁数の多い合計（たとえば小数 3 桁の BHD ストア）は、丸められずに拒否されます。

CorvusPay アカウント: CorvusPay の加盟店アカウントが必要です。CorvusPay は、テストストアと本番ストアで別々に、ストアごとに Store ID と Secret Key を発行します。これらは CorvusPay Merchant Center に表示されます。プラグインの Success URL と Cancel URL をそこに登録する必要があります（「設定」を参照）。

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

インストール

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

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

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

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

5. CorvusPay テストストアの Store ID と Secret Key を入力します（本番決済を行う場合は本番ストアのものも入力します）。設定ページに表示される Success URL と Cancel URL を、テストストア用と本番ストア用に CorvusPay Merchant Center へコピーします。

6. Enable/Disable をオンにしてテスト注文を行い、その後 Test Mode のチェックを外して本番に切り替えます。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > CorvusPay。このページでは、テストモードがオンの間、フィールドの上に Test mode is on. が表示されます。また、ゲートウェイが有効なのに現在のモードの Store ID または Secret Key が空の場合（入力されるまでチェックアウトでは非表示になります）や、ストアの通貨が CorvusPay で対応していない場合にも警告が表示されます。

一般

Enable/Disable: Enable CorvusPay Gateway は支払い方法のオン・オフを切り替えます。デフォルト: オフ。

Title: チェックアウトで購入者に表示される支払い方法の名前。デフォルト: Credit/Debit Card (CorvusPay)。

Description: チェックアウトで支払い方法の下に表示されるテキスト。デフォルト: Pay securely with your credit or debit card via CorvusPay。テストモードでは、これに (Test mode — no real payment is taken.) が追加されます。

ストアの認証情報

Store ID と Secret Key は、CorvusPay がストアごと（テストと本番は別々）に発行するもので、CorvusPay Merchant Center に表示されます。

Test Mode: Enable test mode は、CorvusPay のテスト環境（wallet.test.corvuspay.com）とテスト用の Store ID および Secret Key を使用します。デフォルト: オン。

Test Store ID: CorvusPay テストストアの数値の Store ID。

Test Secret Key: CorvusPay テストストアの Secret Key。HMAC-SHA256 署名に使用されます。

Live Store ID: CorvusPay 本番ストアの数値の Store ID。

Live Secret Key: CorvusPay 本番ストアの Secret Key。HMAC-SHA256 署名に使用されます。

Store ID には数字のみ使用できます。それ以外を入力するとエラーが表示され、以前の値が保持されます。決済は常に、その決済が行われたストアの Secret Key で検証されます。そのため、テスト注文がまだ残っている間は、テスト用キーを入力したままにしてください。

Success URL と Cancel URL

このセクションに表示される 2 つのアドレスを、テストストア用と本番ストア用に CorvusPay Merchant Center へコピーします。CorvusPay は、決済後に購入者をこれらのアドレスに戻します。

支払い

Transaction Type: カードへの請求方法。

Payment Page Language: CorvusPay 決済ページの言語。Site language（デフォルト）は、CorvusPay が対応している場合はサイトの現在の言語を、そうでない場合は英語を使用します。クロアチア語、英語、ドイツ語、イタリア語、セルビア語、スロベニア語から選ぶこともできます。

Order Status After Payment: Sale の支払いが成功した後の注文のステータス。ステータスはすぐに設定され、2 回目のステータス変更は行われません。

詳細設定

Logging: Enable debug logging は、WooCommerce > Status > Logs のソース wcp_corvuspay_gateway に書き込みます。エラーは常に記録されます。シークレットや購入者データは記録されません。デフォルト: オフ。

Delete Data: Delete the plugin settings and log files when the plugin is deleted (uninstalled)。無効化では何も削除されません。注文に保存された決済データは常に保持されます。デフォルト: オフ。

チェックアウト

購入者は支払い方法（デフォルトでは Credit/Debit Card (CorvusPay)）を選んで注文します。注文は支払い待ちのままとなり、Pay for order ページに Redirecting to CorvusPay for payment. Please wait... と表示され、署名付きフォームが CorvusPay の決済ページに送信されます。リダイレクトが始まらない場合、購入者は Pay via CorvusPay をクリックします。注文合計、通貨、カートの簡単な説明、請求先情報（決済ページに事前入力するため）が送信されます。金額が変わらない限り同じ CorvusPay 注文番号が再利用され、CorvusPay はその番号に対する二度目の支払いを受け付けません。

支払い後、CorvusPay は購入者を Success URL に戻します。注文が支払い済みになるのは、CorvusPay が確認した後だけです。CorvusPay 注文番号はこの注文のために発行されたものであること、署名は決済が行われたストアの Secret Key と一致すること、金額と通貨は注文と一致することが必要です。その後、購入者は注文受付完了ページに移動します。在庫は支払いの確認時に減らされ、カートは注文受付完了ページで空になります。

購入者が CorvusPay のページでキャンセルすると、未払いの注文はキャンセルされ、購入者はカートがそのままの状態で The CorvusPay payment was cancelled and the order was not paid. Your cart is still here — you can try again or choose another payment method. とともにチェックアウトに戻ります。支払いが Pay for order ページから開始され、カートが空の場合は、WooCommerce がカートページに The CorvusPay payment was cancelled and the order was not paid. を表示します。Success URL のリクエストを検証できない場合、購入者には We could not confirm this CorvusPay payment. If your card was charged, please contact the shop — do not pay again. と表示され、注文は変更されません。

この支払い方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで動作します。WooCommerce の High-Performance Order Storage（HPOS）に対応しています。テキストはクロアチア語に翻訳されています。

注文が確定するのは、CorvusPay が購入者を Success URL に戻したときだけです。サーバー間通知はありません。購入者が支払い直後にブラウザーを閉じた場合、注文は支払い待ちのままです。本プラグインは、WooCommerce からの返金、キャプチャ、取り消しには対応していません（CorvusPay のサーバー API にはクライアント証明書が必要です）。また、保存済みカード、サブスクリプション、分割払い、IBAN / PIS、CorvusWallet にも対応していません。

注文

注文ステータス

Pending payment: 購入者は CorvusPay に移動しましたが、まだ戻っていません。購入者が支払ったのに戻らなかった場合は、CorvusPay Merchant Center で支払いを確認し、注文を手動で完了してください。

Processing、Completed、または On Hold: Sale の支払いが確認されました。ステータスは Order Status After Payment に従います。注文メモには、CorvusPay 注文番号、承認コード、カード種別が表示されます。注文のトランザクション ID は CorvusPay のトランザクション ID です。CorvusPay が送信しない場合は CorvusPay 注文番号となり、これで Merchant Center 内の支払いを検索できます。

On hold、承認済み: Authorize only が選択されています。CorvusPay Merchant Center で支払いをキャプチャしてから、注文を処理中に変更してください。

On hold、金額/通貨の不一致: 支払われた金額または通貨が注文と一致しません。CorvusPay Merchant Center で支払いを確認するまで出荷しないでください。

On hold、キャンセル済み注文への支払い: 注文がキャンセルされた後（たとえば未払い注文のタイムアウトによる）に、支払いが成功しました。注文を履行するか、CorvusPay Merchant Center で支払いを返金してください。

Cancelled: 購入者が CorvusPay のページで支払いをキャンセルしました。

すでに支払い済みまたはクローズ済みの注文に対して、別の成功した支払いが届いた場合、注文は変更されません。メモで、CorvusPay Merchant Center を確認し、必要に応じて重複した支払いを返金するよう案内されます。

Refunds: WooCommerce からの返金、キャプチャ、取り消しには対応していません。CorvusPay Merchant Center で行い、返金は WooCommerce に手動で記録してください。

ライセンスキー

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

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

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

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

トラブルシューティング

CorvusPay がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在のモードの Store ID と Secret Key が入力されていること（テストモードでは Test Store ID と Test Secret Key、本番モードでは Live Store ID と Live Secret Key）、ストアの通貨が CorvusPay で対応していることを確認してください。いずれの場合も、設定ページに警告が表示されます。

支払いは完了したが、注文が支払い待ちのまま: Success URL が CorvusPay Merchant Center に登録されていないか、WooCommerce の Secret Key がストアと一致していない可能性が高いです。Logging をオンにして、WooCommerce > Status > Logs のソース wcp_corvuspay_gateway で INVALID signature を探してください。購入者が戻る前にブラウザーを閉じた場合も、注文は支払い待ちのままになります。その場合は、Merchant Center で支払いを確認し、注文を手動で完了してください。

購入者に We could not confirm this CorvusPay payment と表示される: Success URL のリクエストが拒否されました。必須フィールドがない、CorvusPay 注文番号がその注文のために発行されていない、そのストアの Secret Key が空、または署名が一致しなかったことが原因です。注文は変更されません。理由はログに記録されます。

購入者に This order total cannot be paid via CorvusPay と表示される: 合計が 0 か、小数点以下が 2 桁を超えています。

購入者に CorvusPay is not configured または CorvusPay does not accept payments in … と表示される: 現在のモードの Store ID または Secret Key がないか、注文の通貨が対応していません。

注文が On hold になっている: 注文メモを確認してください。Authorize only が選択されている、支払われた金額または通貨が注文と一致しなかった、または注文のキャンセル後に支払いが届いた、のいずれかです。

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

アンインストール

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

CorvusPay は、それぞれの所有者の商標です。このプラグインは CorvusPay と提携しておらず、CorvusPay の承認も受けていません。