VibeFox Redsys for WooCommerce — ヘルプ

要件

WordPress：6.2 以降。

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

PHP：8.0 以降。

Redsys 加盟店アカウント：貴行（Redsys 仮想 POS を提供したアクワイアラ）から、加盟店コード（FUC）、端末番号、そして各環境の SHA-256 秘密キーが表示される Redsys 管理画面へのアクセスを受け取ります。テスト環境のキーは本番環境のキーとは別です。端末でオンライン通知（HTTP）を有効にしておく必要があります。不明な点は貴行にご確認ください。

ストアの通貨：プラグインが対応する通貨のいずれか（設定を参照）で、かつ貴行がその通貨で Redsys 端末を有効にしていること。ほとんどの端末は EUR のみを受け付けます。

到達可能なサイト：支払い通知を届けるため、Redsys がログインやファイアウォールによる遮断なしにインターネットから貴サイトへアクセスできる必要があります。

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

インストール

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

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

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

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

5. 加盟店コード、端末番号、各環境の秘密キーを入力します（設定を参照）。

6. Enable/Disable をオンにします。Test Mode をオンにした状態でテスト支払いを行い、その後 Test Mode のチェックを外して実際の支払いを受け付けます。

設定

すべての設定は 1 つのページにあります：WooCommerce > Settings > Payments > Redsys。フィールドの上では、加盟店コードが未入力または数字以外を含む場合、秘密キーが有効な Redsys SHA-256 キーではない場合、現在のモードのキーが空の場合（この場合、チェックアウトで支払い方法が非表示になります）、ストアの通貨が対応していない場合に、ページが警告します。テストモードがオンのときは、Test mode is active: payments go to the Redsys test environment (SIS-T), no real money is charged. と表示されます。保存後は、警告が新しい設定にすぐ反映されます。支払い方法の一覧では、加盟店コード、端末、現在のモードのキーが有効になるまで Redsys に設定が必要と表示されます。

一般

Enable/Disable: Enable Redsys Gateway で支払い方法のオン／オフを切り替えます。デフォルト：オフ。

Title: チェックアウトでお客様に表示される支払い方法の名前。デフォルト：Credit/Debit Card (Redsys)。

Description: チェックアウトで支払い方法の下に表示される文章。デフォルト：Pay securely with your credit or debit card via Redsys。

Redsys アカウント

貴行から、加盟店コード、端末、各環境の SHA-256 秘密キーが表示される Redsys 管理画面へのアクセスを受け取ります。このセクションには Redsys 管理画面へのリンクがあります。

Merchant Code (FUC): Redsys の加盟店コード。最大 9 桁。保存時に数字以外の文字は削除されます。

Terminal Number: 貴行が割り当てた端末番号。最大 3 桁。デフォルト：1。空欄は 1 として保存されます。

Secret Key (SHA-256) — live: 本番環境の Base64 SHA-256 秘密キー。テストモードがオフのときに使用されます。

テストモード（SIS-T）

Redsys のテスト環境には独自の秘密キーがあります。このセクションには Redsys の公開テストデータが表示されます：加盟店コード 999008881、端末 1、キー sq7HjrUOBfKmC576ILgskD5srU870gJ7、カード 4548 8100 0000 0003、有効期限 12/49、CVV 123。テストモードでは実際の料金は請求されません。

Test Mode: Enable test mode をオンにすると、支払いと返金は Redsys のテスト環境（SIS-T）に送信され、テストキーで署名されます。デフォルト：オン。実際の支払いを受け付けるにはチェックを外します。オンの間、チェックアウトでは支払い方法の下に TEST MODE: Redsys test environment, no real money is charged. と表示されます。

Secret Key (SHA-256) — test: テスト環境の Base64 SHA-256 秘密キー。ご自身のテストキー、または上記の公開テストキーを使用してください。

決済ページと注文

Commerce Name: Redsys 決済ページに表示されるストア名。最大 25 文字。デフォルト：サイト名を 25 文字に切り詰めたもの。

Order Status After Payment: 支払い成功後に設定される注文ステータス。ステータスは一度だけ設定されるため、お客様に届くメールは 1 通だけです。

支払い通知

Redsys は、すべての支払いをストアの通知アドレスに報告します。アドレスは https://your-site/wc-api/rdsg_redsys/ の形式で、このセクションに表示されます。プラグインは支払いごとにこのアドレスを Redsys に送るため、Redsys 管理画面に入力する必要はありません。端末でオンライン通知（HTTP）が有効になっている必要があります。支払い成功後も注文が支払い待ちのままの場合は、貴行に確認してください。有効な署名のない通知は拒否されます。通知がなければ、注文は支払い済みになりません。

詳細設定

Debug log: Enable debug logging をオンにすると、支払い、通知、返金の詳細が WooCommerce > Status > Logs に書き込まれます（ソース：wcp_redsys_gateway）。エラーはこのオプションがオフでも常に記録されます。キー、署名、カード情報は一切記録されません。デフォルト：オフ。

Delete Data: Delete the gateway settings when the plugin is deleted。オンの場合、プラグインを削除するとゲートウェイ設定とプラグインのログが削除されます。デフォルト：オフ。

対応通貨

EUR, USD, GBP, JPY, CHF, CAD, AUD, NZD, NOK, SEK, DKK, PLN, CZK, HUF, BGN, RON, ILS, INR, MYR, SGD, THB, SAR, ZAR, RUB, BRL, MXN, ARS, CLP, COP, PEN, CNY, TWD。これ以外の通貨では支払い方法は表示されません。Pay for order ページでは、注文の通貨が基準になります。

チェックアウト

お客様は支払い方法（デフォルトは Credit/Debit Card (Redsys)）を選び、注文を確定します。注文は支払い待ちに設定され、お客様には Redirecting to Redsys for payment. Please wait... が表示された後、貴行の Redsys 決済ページに移動します。ブラウザが自動で移動しない場合は、お客様が Pay via Redsys をクリックします。Redsys ページでお客様は、3-D Secure によるカード決済、または Bizum や貴行が端末で有効にしたその他の方法で支払います。ページはストアの言語（スペイン語、英語、カタルーニャ語、フランス語、ドイツ語、イタリア語、ポルトガル語など）を使用し、それ以外の言語では英語になります。

金額は注文通貨の最小単位で送信されます。たとえば EUR 43.45 は 4345 として、JPY や CLP は小数点なしで送信されます。支払いは注文番号とサイト名を含む Order として説明されます。在庫は支払いが確定した時点で減少し、それ以前には減りません。

支払い後、お客様はストアの注文受付完了ページに戻ります。注文は、Redsys が署名付き通知で確認した後にのみ支払い済みとなります。通知が届くまで、ページには Redsys is confirming your payment. If you completed the payment, your order will be updated in a few moments — please do not pay again. と表示されます。

お客様がキャンセルした場合、または支払いが拒否された場合、Redsys はお客様をストアに戻します。チェックアウトからの注文は、WooCommerce の標準的な方法でキャンセルされ、カートは保持されます。管理画面で作成した注文（支払いリンク）の場合、お客様には The Redsys payment was not completed. You can try again or choose another payment method. というメッセージとともに Pay for order ページが表示され、注文はキャンセルされません。ストアのリダイレクトページには、Cancel order & restore cart、または管理画面で作成した注文の場合は Choose another payment method も表示されます。

お客様は、未払いの注文を Pay for order ページから再度支払うことができます。試行のたびに新しい Redsys 注文番号が発行されます。そのうちのどれかから行われた支払い（たとえば 2 つ目のブラウザタブからの支払い）も引き続き認識されます。

注文を Redsys に送信できない場合、お客様には短いメッセージが表示され、別の支払い方法を選択できます：Redsys payments are not configured correctly. Please choose another payment method or contact us.、通貨が受け付けられないことを示すメッセージ、または The order total must be greater than zero.

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

本プラグインは、Redsys ページ上で即時に承認・売上確定される一回限りの支払いに対応します。貴店のサイト上のカードフォーム（InSite または iframe）、カードの保存、ワンクリック決済やトークン化、定期購入や継続課金、後日売上確定する事前承認、SOAP 通知には対応していません。

注文と返金

注文ステータス

Pending payment: お客様は Redsys に移動したものの、まだ支払っていないか、Redsys の通知がまだ届いていません。注文メモには Awaiting Redsys payment. と表示されます。

Processing, Completed or On Hold: 支払いが確認されました。ステータスは Order Status After Payment に従います。注文メモには Redsys 注文番号（Ds_Order）、承認コード、応答コードが表示され、テスト支払いには [TEST] が付きます。注文の取引 ID は Redsys 注文番号です。

On hold after payment: Redsys が注文合計と異なる金額または通貨を報告した場合、ストアが本番モードの間にテスト支払いが届いた場合（実際の料金は請求されていません）、または注文のキャンセル後に支払いが届いた場合です。注文メモに理由が記載されます。Redsys 管理画面で支払いを確認してから、注文を発送するか支払いを返金してください。

Failed: 支払いが Redsys で拒否されたか、キャンセルされました。注文メモには応答コードと、よくあるコードについては Insufficient funds、Card expired、Cancelled by the customer のような短い理由が表示されます。まだ支払いを待っている注文だけが失敗になります。支払い済みまたは終了した注文は、拒否された試行によって変更されることはありません。試行はメモに記録されるだけです。

Cancelled: お客様が支払いをキャンセルしたか、貴店または WooCommerce の在庫保持タイムアウトによって注文がキャンセルされました。

すでに支払い済みまたは返金済みの注文に、別の二回目の支払いが届いた場合、注文は変更されません。メモで、Redsys 管理画面において重複した支払いを返金するよう案内されます。Redsys が支払いがまだ処理中であると報告した場合、メモが追加され、注文は最終結果を待ちます。

返金

注文を開き、Refund をクリックし、金額を入力して、Redsys 支払い方法の返金ボタン（デフォルトは Refund via Credit/Debit Card (Redsys)）をクリックします。全額返金と一部返金に対応しています。返金は、支払いが行われた環境（テストまたは本番）の Redsys REST API に送信され、その環境のキーで署名され、応答の署名が検証されます。Redsys が返金を受け付けない場合、WooCommerce がエラーを表示し、返金は記録されません。返金が成功すると、Redsys 注文番号と理由とともに注文メモに追加されます。

Redsys 管理画面で行われた返金は、WooCommerce の返金としては記録されません。Redsys がそれらについて通知を送ると、注文にメモが追加されます。必要に応じて、Redsys の返金ボタンを使わずに WooCommerce で手動返金を作成してください。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに Redsys が表示されない：ライセンスが有効であること、Enable/Disable がオンであること、加盟店コードと端末が入力されていること、現在のモードに有効なキーがあることを確認してください。テストモードでは Secret Key (SHA-256) — test、本番モードでは Secret Key (SHA-256) — live です。ストアの通貨（Pay for order ページでは注文の通貨）が対応通貨の一覧にあるか確認してください。設定ページには、これらの問題ごとに警告が表示されます。

支払いは完了したが、注文が Pending payment のまま：Redsys の通知が貴店に届いていません。貴行に、端末でオンライン通知（HTTP）が有効になっているか確認してもらってください。支払い通知 に表示されているアドレスが、ログイン、メンテナンスページ、ファイアウォールによる遮断なしにインターネットから到達可能か確認してください。Debug log をオンにして、WooCommerce > Status > Logs（ソース：wcp_redsys_gateway）を確認してください。

通知が Forbidden を返す：署名が、支払いを開始した環境の秘密キーと一致しなかったか、通知内の加盟店コードが貴店のものではありません。設定の秘密キーと加盟店コードが、貴店の端末のものであることを確認してください。

通知が Order not found を返す：通知は正しく署名されていましたが、このストアのどの注文もその Redsys 注文番号を使用していません。

通知が Busy を返す：同じタイミングで別の通知によって注文が処理されていました。Redsys は通知を再試行します。

通知が Bad request を返す：リクエストに Redsys のパラメータがないか、壊れていました。想定された形式で Redsys から送られたものではありません。

注文が On hold after payment になっている：注文メモを確認してください。支払われた金額または通貨が注文と異なっていた、ストアが本番モードの間にテスト支払いが届いた、または注文のキャンセル後に支払いが届いた可能性があります。注文を発送するか、支払いを返金してください。

本番モードではテスト支払いで注文は確定しない：Test Mode がオフの間、テスト支払いで注文が支払い済みになることはありません。代わりに、注文はメモ付きで保留になります。テスト支払いには、テストモードとテストキーを使用してください。

返金が失敗する：エラーを確認してください。Redsys refund: the merchant code or the TEST secret key is not configured.（または LIVE）は、支払い環境のキーが設定されていないことを意味します。Redsys のエラーコードはメッセージに説明があります。たとえば SIS0057（金額が支払いの残額を超えている）、SIS0056（元の支払いが見つからない。環境または端末が異なる）、SIS0042（署名エラー。この環境のキーを確認）、SIS0026（不明な加盟店コードまたは端末）、SIS0027（端末に通貨が設定されていない）。Redsys に接続できない場合、返金は行われません。しばらくしてから再試行してください。

端末がリストにない通貨を受け付けている：開発者は rdsg_currency_codes フィルターで通貨のリストを変更できます。通貨は、銀行が端末で有効にした場合にのみ追加してください。

バージョン 1.0 からの更新後：テストモードで使っていたキーは、現在 Secret Key (SHA-256) — test に入っています。Test Mode のチェックを外す前に、本番キーを入力してください。バージョン 1.0 で作成された注文も、引き続き通知と返金を受け取ります。

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

アンインストール

プラグインを無効化してもすべてのデータは保持されます。削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。ゲートウェイ設定とプラグインのログは、Delete Data がオンだった場合にのみ削除されます。そうでなければ、後の再インストールのために残されます。注文に保存された Redsys のデータは、支払いを記録し返金に必要なため、常に保持されます。既存の注文は、支払いメモと取引 ID を保持します。

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