VibeFox CorvusPay for PrestaShop — ヘルプ

要件

PrestaShop: 8.0 ～ 9.x。

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

通貨: AUD、BAM、BHD、CAD、CHF、CZK、DKK、EUR、GBP、HRK、HUF、ISK、MKD、NOK、PLN、RON、RSD、RUB、SEK、USD のいずれか。カートの通貨がこれら以外の場合、チェックアウトではこの決済方法が表示されません。金額は小数点以下 2 桁で送信されます。小数点以下の桁数がそれより多い合計金額（たとえば BHD の価格が小数点以下 3 桁のショップ）は、四捨五入されず拒否されます。

CorvusPay アカウント: CorvusPay の加盟店アカウントが必要です。CorvusPay は、テストショップと本番ショップそれぞれに Store ID と Secret Key を発行します。これらは CorvusPay Merchant Center に表示されます。モジュールの Success URL と Cancel URL は、そこに入力する必要があります（設定を参照）。

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

インストール

1. 管理画面で Modules > Module Manager を開き、Upload a module をクリックします。モジュールの ZIP ファイルを選択してください。

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

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

4. CorvusPay のテストショップの Store ID と Secret Key を入力します（本番の支払いを受け付ける場合は、本番ショップの Store ID と Secret Key も入力します）。Configure ページに表示される Success URL と Cancel URL を、テストショップと本番ショップの両方について CorvusPay Merchant Center にコピーします。

5. Enable/Disable をオンにして Save をクリックします。テスト注文を行い、本番運用に切り替えるには Test Mode をオフにします。

インストール時、モジュールは注文ステータス CorvusPay payment on hold を作成します。PrestaShop は、新しい決済モジュールをその時点で有効な通貨、顧客グループ、国に関連付けます。これは Payment > Preferences で変更できます。後から有効にした国は、そこでモジュールに対してチェックを入れる必要があります。

設定

すべての設定はモジュールのページにあります: Modules > Module Manager > VibeFox CorvusPay Gateway > Configure。各セクションには独自の Save ボタンがあり、ページ全体が保存されます。テストモードがオンの間、フィールドの上にはページが テストモードがオンです。決済は CorvusPay のテスト環境に送られ、実際の料金は請求されません。 と表示されます。また、決済ゲートウェイが有効なのに現在のモードの Store ID または Secret Key が空の場合（入力されるまでチェックアウトでは非表示になります）や、ショップのデフォルト通貨が CorvusPay でサポートされていない場合には、警告が表示されます。

CorvusPay

Enable/Disable: Enable CorvusPay Gateway で決済方法をオンまたはオフにします。デフォルト: オフ。

Title: チェックアウトで顧客に表示される決済方法の名称です。注文にも、この名称が決済方法として保存されます。デフォルト: Credit/Debit Card (CorvusPay)。

Description: チェックアウトで決済方法の下に表示されるテキストです。デフォルト: Pay securely with your credit or debit card via CorvusPay。テストモードでは、（テストモード — 実際の決済は行われません。） が追加されます。

ショップの認証情報

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

Test Mode: CorvusPay のテスト環境（wallet.test.corvuspay.com）と、テスト用の Store ID および Secret Key を使用します。デフォルト: オン。実際の決済を wallet.corvuspay.com で受け付けるにはオフにします。

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 署名に使用されます。

Clear saved secrets: Test Secret Key または Live Secret Key にチェックを入れ、Save をクリックすると削除されます。

Store ID は数字のみで入力してください。それ以外の文字を入力すると、ページに … は数字のみで入力してください — 以前の値を保持しました。 と表示されますが、ほかのフィールドは保存されます。保存済みの Secret Key は再表示されません。フィールドは空のままで、保存済み — 変更しない場合は空のままにしてください。 と表示されます。値を変更する場合のみ新しい値を入力してください。決済は常に、開始したショップの Secret Key で検証されます。そのため、テスト決済が戻ってくる可能性がある間は、テストキーを入力したままにしてください。

Success URL と Cancel URL

このセクションに表示される 2 つのアドレスを、テストショップと本番ショップの両方について、CorvusPay Merchant Center にコピーします。決済後、CorvusPay はお客様をこれらのアドレスに戻します。ページに表示されたとおりに正確にコピーしてください。フレンドリー URL の場合、次の例のような形になります（先頭に /en/ などの言語コードが付くこともあります）。

決済

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

Payment Page Language: CorvusPay の決済ページの言語です。Site language（デフォルト）は、CorvusPay が対応している場合はショップの現在の言語を使用し、対応していない場合は英語を使用します。Hrvatski、English、Deutsch、Italiano、Srpski、Slovenščina から選択することもできます。

Order Status After Payment: Sale の決済が成功した後の注文ステータスです。注文はこのステータスで直接作成されます。

詳細設定

Logging: モジュールのフォルダー内の logs/corvuspay_p_debug.log.php にデバッグ情報を書き込みます。このファイルは Web からは開けません。この設定がオフでも、エラーは常に記録されます。シークレット、署名、顧客データは記録されることはありません。デフォルト: オフ。

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

Delete Data: オンの場合、モジュールをアンインストールするとモジュールの設定とログファイルが削除されます。注文、CorvusPay の取引データ、注文ステータスは常に保持されます。デフォルト: オフ。

チェックアウト

決済ステップで、お客様は決済方法（デフォルトでは Credit/Debit Card (CorvusPay)）を選択して確定します。次のページには CorvusPay での決済にリダイレクトしています。しばらくお待ちください... と表示され、署名付きフォームが CorvusPay の決済ページに送信されます。リダイレクトが開始されない場合、お客様は Pay via CorvusPay をクリックします。Back to checkout を押すと、チェックアウトに戻ります。送信されるのは、カートの合計金額、通貨、簡単な説明（カート番号とショップ名）、請求先住所の情報とメールアドレス（決済ページの入力を事前に済ませるため）です。この時点では、まだ注文は存在しません。金額、通貨、モード、取引タイプが変わらない限り、同じ CorvusPay の注文番号が再利用され、CorvusPay は同じ番号に対する二回目の支払いを受け付けません。

決済の後、CorvusPay はお客様を Success URL に戻します。注文は、CorvusPay が確認した後にのみ支払い済みとしてマークされます。CorvusPay の注文番号はこのショップが発行したものである必要があり、署名は決済を開始したショップの Secret Key と一致する必要があり、金額と通貨はカートと一致する必要があります。その後、注文が作成され、お客様には標準の注文確認ページが表示されます。CorvusPay での決済を受け付けました。 Authorize only の場合、ページには CorvusPay での決済が承認されました。金額は、ショップがご注文を処理したときに請求されます。 と表示されます。保留中の注文の場合は お支払いを受け付けました。ショップで確認中です。 と表示されます。

その時点で注文を作成できない場合（たとえば、別のリクエストが同じカートを確認している場合）、お客様には お支払いを確認中です と Check again ボタンが表示されます。ボタンを押すと、注文が存在するようになり次第、注文確認ページに進みます。Success URL リクエストを検証できない場合、お客様には 支払いを確認できませんでした と この CorvusPay 決済を確認できませんでした。カードに請求が発生している場合は、ショップにお問い合わせください。再度支払わないでください。 が表示されます。何も変更されません。ショップがメンテナンスモードであっても、Success URL は機能します。

お客様が CorvusPay のページでキャンセルすると、カートはそのままの状態でチェックアウトに戻り、CorvusPay での決済はキャンセルされ、注文は支払われていません。カートはそのまま残っています。もう一度お試しいただくか、別の決済方法をお選びください。 と表示されます。

決済を開始できない場合、お客様はチェックアウトに残り、短いメッセージが表示されます。CorvusPay が設定されていません。別の決済方法をお選びください。、CorvusPay は … での支払いを受け付けていません、または この注文金額は CorvusPay では決済できません（0 より大きく、小数点以下 2 桁までである必要があります）。別の決済方法をお選びください。 のいずれかです。

注文が確定するのは、CorvusPay がお客様を Success URL に戻したときだけです。サーバー間の通知はありません。お客様が決済直後にブラウザーを閉じた場合、注文は作成されません。本モジュールは PrestaShop からの返金、キャプチャ、取り消し（void）に対応していません（CorvusPay のサーバー API にはクライアント証明書が必要です）。また、保存済みカード、サブスクリプション、分割払い、サイト上のカードフォームにも対応していません。

注文

注文ステータス

まだ注文がありません: お客様は CorvusPay に送られましたが、確認済みの支払いを伴って戻ってきていません。存在するのはカートだけです。お客様が支払ったものの戻らなかった場合は、CorvusPay Merchant Center で決済を確認し、注文を手動で作成してください。

Payment accepted、Delivered、または CorvusPay payment on hold: Sale の決済が確認されました。ステータスは Order Status After Payment に従います。決済は CorvusPay の取引 ID で記録されます。CorvusPay が取引 ID を送信しない場合は CorvusPay の注文番号で記録され、その番号を使って Merchant Center で決済を探すことができます。注文のプライベートメモには、CorvusPay の注文番号、承認コード、カードの種類が表示されます。

CorvusPay payment on hold, authorized: Authorize only が選択されています。CorvusPay Merchant Center で決済をキャプチャ（完了）し、その後で注文を Payment accepted に設定してください。

CorvusPay payment on hold, amount/currency mismatch: 支払われた金額または通貨がカートと一致しません。たとえば、別のタブでカートが変更された場合などです。支払われた通貨が注文の通貨と同じである場合、実際に支払われた金額で決済が記録されます。CorvusPay Merchant Center で決済を確認するまで、発送しないでください。

CorvusPay payment on hold, payment after cancel: お客様がキャンセルした決済試行に対して、成功した決済が届きました。CorvusPay Merchant Center で注文を処理するか、決済を返金してください。

注文がある同じカートに対して、別の成功した決済が届いた場合、注文は変更されません。メモが表示され、CorvusPay Merchant Center を確認し、必要に応じて二重の決済を返金するよう求められます。

CorvusPay 決済ブロック

注文ページには CorvusPay payment ブロックが表示され、CorvusPay の注文番号、決済試行のステータス、取引タイプ（Sale または Authorize only）、金額（CorvusPay が報告した場合は受領額も）、承認コード、取引、カードの種類が表示されます。テスト決済には Test と表示されます。

返金: PrestaShop からの返金、キャプチャ、取り消し（void）には対応していません。CorvusPay Merchant Center で行い、その結果を PrestaShop に手動で記録してください。

ライセンスキー

このモジュールは、vibefox.net で取得した VibeFox ライセンスキーで動作します。License — VibeFox CorvusPay Gateway のライセンスブロックは、Modules > Module Manager > VibeFox CorvusPay Gateway > Configure ページで設定より上にある最初のブロックです。キーを License key に貼り付け、Activate をクリックします。その後、ブロックにはキーがマスク表示され、ステータス（ライセンスの有効期限日やドメインなど）と、ステータスを再確認する Check now、別のキーを入力する Change key、このショップからキーを削除する Remove key のボタンが表示されます。その下には Product: presta-payment-corvuspay の行と、vibefox.net アカウントを開く「アカウントでライセンスとドメインを管理」リンクがあります。キーを変更できるのは、このモジュールの Configure 権限を持つスタッフだけです。ブロックのテキストはバックオフィスの言語に従います（英語とロシア語を含みます）。

キーが受け付けられない場合、ブロックは理由を表示します。たとえば Key not found、This key belongs to another product、Domain limit reached、または日付付きの License expired on などです。ショップのアドレスを変更した後、またはアカウントでドメイン枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、モジュールは最後に確認したステータスのまま動作を続けます。

1 つのキーは 1 つのドメインでのみ使用できます。マルチストア構成の場合も、メインショップのドメインが対象です。ショップからキーを削除しても、ドメイン枠は解放されません。vibefox.net アカウントで枠を解放してください。

有効なキーがない場合、CorvusPay はチェックアウトでお客様に表示されません。それでも支払いが開始された場合、お客様には この支払い方法は利用できません。別の方法をお選びください。 と表示されます。PrestaShop のストアフロントは、あなたがバックオフィスにログインしていることを認識しないため、支払い方法はあなたにも表示されません。キーを購入する前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文は影響を受けません。すでに開始された支払いは、お客様が CorvusPay から戻ったときに引き続き確認されます。

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

トラブルシューティング

チェックアウトに CorvusPay が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在のモードの Store ID と Secret Key が入力されていること（テストモードでは Test Store ID と Test Secret Key、本番モードでは Live Store ID と Live Secret Key）、カートの通貨が CorvusPay でサポートされていることを確認してください。Payment > Preferences で、モジュールがカートの通貨、お客様の国、お客様のグループに対して許可されているかも確認してください。

決済は完了したが、注文が作成されなかった: Success URL が CorvusPay Merchant Center に入力されていないか、PrestaShop の Secret Key がショップと一致していない可能性があります。モジュールのページの Log フィールドで INVALID signature を探してください（エラーは常に記録されます）。お客様が戻る前にブラウザーを閉じた場合も、注文は作成されません。その場合は、Merchant Center で決済を確認し、注文を手動で作成してください。

お客様に「支払いを確認できませんでした」と表示される: Success URL のリクエストが拒否されました。必須フィールドが不足していた、CorvusPay の注文番号がこのショップで発行されたものではなかった、そのショップの Secret Key が空だった、または署名が一致しなかった、のいずれかです。何も変更されません。ログに理由が表示されます。

お客様に「お支払いを確認中です」が長時間表示される: 注文を作成できませんでした。たとえば、モジュールが無効になっていた、またはカートが無効になっていたことが考えられます。ログに理由が表示されます。Merchant Center で決済を確認してください。

お客様に「この注文金額は CorvusPay では決済できません」と表示される: 合計金額がゼロであるか、小数点以下の桁数が 2 を超えています。

お客様に「CorvusPay が設定されていません」または「CorvusPay は … での支払いを受け付けていません」と表示される: 現在のモードの Store ID または Secret Key が不足しているか、カートの通貨がサポートされていません。

注文が CorvusPay payment on hold になっている: 注文のプライベートメモを確認してください。Authorize only が選択されている、支払われた金額または通貨がカートと一致しなかった、お客様がキャンセルした後に決済が届いた、または Order Status After Payment が保留に設定されている、のいずれかが原因です。

アンインストール

Modules > Module Manager に移動し、VibeFox CorvusPay Gateway の横のメニューを開いて Uninstall を選択します。このモジュールのライセンスキーとライセンス状態は常に削除されます。Delete Data がオンの場合、モジュールの設定とログファイルは削除されます。オフの場合は、後で再インストールできるようすべての設定が保持されます。CorvusPay の取引データと注文ステータス CorvusPay payment on hold は常に保持されるため、再インストール後に古い注文の CorvusPay ブロックが再び表示されます。既存の注文は、決済のメモと取引 ID を保持します。

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