VibeFox SimplePay for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

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

PHP: 8.0 以降。

ストアの通貨: HUF、EUR、USD のいずれか。SimplePay はそれ以外の通貨を受け付けないため、それらの通貨では決済方法は表示されません。

SimplePay の加盟店アカウント: SimplePay では、通貨ごとに個別の加盟店アカウントが発行され、本番とサンドボックスでも別々のアカウントになります。各アカウントについて、SimplePay の加盟店管理画面（本番は admin.simplepay.hu、サンドボックスは sandbox.simplepay.hu）から、アカウント > 技術データにある MERCHANT と SECRET KEY が必要です。HUF のみで販売する場合は、HUF アカウントだけで十分です。それ以外のキーは必要ありません。

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

インストール

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

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

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

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

5. 販売する各通貨について、SimplePay アカウントの MERCHANT と SECRET KEY を入力します。テスト用はサンドボックスのアカウント、実際の決済は本番のアカウントを使用します（設定を参照）。

6. 設定ページに表示される IPN URL を、SimplePay の加盟店管理画面にある各加盟店アカウント（本番とサンドボックス）にコピーします。

7. Enable/Disable を有効にし、Sandbox mode を有効にした状態でテスト決済を行ってから、Sandbox mode のチェックを外して実際の決済を受け付けます。

バージョン 1.0 から更新すると、1.0 の単一の Merchant ID と Secret key は、有効だったモード（サンドボックスまたは本番）のストア通貨のアカウントに移行されます。更新後にアカウントを確認してください。

設定

すべての設定は 1 ページにまとまっています: WooCommerce > Settings > Payments > SimplePay (OTP)。入力欄の上には、ストアの通貨が SimplePay でサポートされていない場合や、現在のモードでストア通貨の加盟店アカウントがない場合に警告が表示されます。どちらの場合も、その通貨の注文では決済方法は表示されません。Sandbox mode が有効な間は、ページに Sandbox mode is on: payments go to the SimplePay sandbox, no real money is charged. と表示されます。決済方法の一覧では、現在のモードに加盟店アカウントが 1 つ以上登録されるまで、SimplePay に設定が必要であることが示されます。

一般

Enable/Disable: Enable SimplePay Gateway で決済方法のオン/オフを切り替えます。デフォルト: オフ。

Title: チェックアウトで購入者に表示される決済方法の名前。デフォルト: SimplePay (Card Payment)。

Description: チェックアウトで決済方法の下に表示されるテキスト。デフォルト: Pay securely with your credit or debit card via SimplePay。ハンガリーの加盟店は、チェックアウトで SimplePay のデータ転送に関する宣言（Adattovábbítási nyilatkozat）を表示する必要があります。そのリンクと一緒にここに入力できます。

Sandbox mode: Use the SimplePay sandbox は、決済を SimplePay のサンドボックスに送信し、サンドボックスのアカウントを使用します。API のアドレスと加盟店アカウントの両方が切り替わります。実際の料金は請求されません。デフォルト: オン。チェックを外すと、本番のアカウントで実際の決済を受け付けます。

本番の加盟店アカウント

Sandbox mode がオフのときに使用されるアカウントです。ストアが販売する通貨のアカウントを入力します。MERCHANT と SECRET KEY の値は、SimplePay の加盟店管理画面（admin.simplepay.hu）のアカウント > 技術データにあります。アカウントは両方の欄に入力されている場合にのみ使用されます。

HUF account — Merchant ID: 本番の HUF アカウントの MERCHANT。

HUF account — Secret key: 本番の HUF アカウントの SECRET KEY。

EUR account — Merchant ID と EUR account — Secret key: 本番の EUR アカウントについても同様です。

USD account — Merchant ID と USD account — Secret key: 本番の USD アカウントについても同様です。

サンドボックスの加盟店アカウント

Sandbox mode がオンのときに使用されるアカウントです。入力欄は本番のアカウントと同じです: HUF account — Merchant ID、HUF account — Secret key、および EUR と USD の同じ組み合わせ。値は、SimplePay のサンドボックス加盟店管理画面（sandbox.simplepay.hu）のアカウント > 技術データから取得してください。

IPN URL

IPN は、決済の状態が変わったときに SimplePay からストアに送られるメッセージです。注文が支払い済みになる通常の方法です。設定ページには、ストアの IPN URL が表示されます。形式は次のとおりです: https://your-site/wc-api/simplepay_payment_callback/。この URL を、SimplePay の加盟店管理画面で、本番とサンドボックスのすべての加盟店アカウントに設定してください。サイトで URL に言語プレフィックスを使用している場合や、他のアドレスをリダイレクトしている場合は、設定に表示されたとおりに URL を正確にコピーしてください。リダイレクトされた IPN は失われるためです。

IPN は、そこで指定された加盟店アカウントの SECRET KEY で署名されている必要があります。有効な署名のない IPN は拒否されます。プラグインは、有効な IPN のすべてに対して、SimplePay が要求する署名形式で確認応答を返します。次の IPN ステータスは注文を変更します:

FINISHED: 決済が成功しました。金額と通貨の確認の後、注文は支払い済みになります。

NOTAUTHORIZED, FRAUD: 決済が拒否されました。注文は失敗になります。

TIMEOUT, CANCELLED: 決済の制限時間が過ぎたか、購入者がキャンセルしました。注文はキャンセル済みになります。

失敗とキャンセル済みは、まだ支払い待ちの注文について、最新の決済試行に対してのみ設定されます。その他のステータスはログに記録されるだけで、注文は変更されません。IPN がない場合、注文は購入者が決済成功後にストアに戻ってきたときにのみ確定されます。

注文

Order Status After Payment: 決済成功後に設定される注文ステータス。ステータスは即座に設定され、二度目のステータス変更はありません。

WooCommerce default (Processing; Completed for virtual/downloadable orders): デフォルトです。

Completed: 支払い済みのすべての注文が完了になります。

詳細設定

Logging: Enable logging は、API 呼び出し、IPN、戻りを WooCommerce > Status > Logs に、ソース wcp_simplepay_gateway として書き込みます。キーと購入者データは記録されません。エラーは、この設定がオフでも常に記録されます。デフォルト: オフ。

Delete Data on Uninstall: Remove all plugin data when uninstalling。オンの場合、プラグインを削除すると、ゲートウェイの設定とプラグインのログが削除されます。注文データは常に保持されます。デフォルト: オフ。

チェックアウト

購入者は決済方法（デフォルトは SimplePay (Card Payment)）を選んで注文します。プラグインは、注文通貨での注文合計について、現在のモードでその通貨の加盟店アカウントを使って SimplePay のカード決済を開始し、購入者を SimplePay の決済ページに送ります。決済ページには、カード決済について加盟店アカウントで許可されている内容が表示されます。購入者のメールアドレスと、入力が完了している場合は請求先住所が SimplePay に渡されます。決済ページは、SimplePay がサポートしている場合はサイトの言語を使用し、そうでない場合は英語を使用します。開始した決済は 30 分以内に完了できます。

決済が成功すると、購入者はストアの注文受付ページに戻ります。戻ってきただけでは注文は支払い済みになりません。プラグインは、署名付きのリクエストで SimplePay に取引の状態を照会するため、IPN が遅れても注文は確定します。注文受付ページには、Successful transaction. SimplePay transaction ID: と ID が表示されます。決済がまだ確認されていない場合は、Your payment is being confirmed by SimplePay. SimplePay transaction ID: と ID が表示されます。

決済が失敗するか、キャンセルされるか、タイムアウトした場合、購入者はチェックアウトに戻されます。カートが空の場合は、Pay for order ページに戻されます。そこでは、取引 ID を含む SimplePay のメッセージが表示されます。例: Cancelled payment. You cancelled the payment または Timeout. The time allowed to complete the payment has expired。決済に失敗した場合、購入者は入力内容を確認し、カードを発行した銀行に問い合わせるよう求められます。購入者は再試行できます。新しい試行ごとに独自の SimplePay 参照番号が割り当てられます。例: 123、123-2、123-3。

SimplePay が決済を開始できない場合、購入者には The SimplePay payment could not be started. Please try again or choose another payment method. と表示されます。注文通貨の加盟店アカウントがない場合のメッセージは SimplePay is not available for the currency of this order. Please choose another payment method. です。技術的な理由は注文メモとログに追加されます。ログイン中のストア管理者には、メッセージ内でも表示されます。

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

本プラグインは、SimplePay のページで請求される 1 回限りのカード決済のみに対応しています。保存済みカードやワンクリック決済、定期購読や定期課金には対応しておらず、オーソリとキャプチャを分けることもできません。

注文と返金

注文ステータス

Pending payment: 購入者は SimplePay に移動しましたが、まだ支払っていないか、SimplePay がまだ決済を確認していません。注文メモには、開始された取引、金額、モード（サンドボックスまたは本番）が表示されます。

Processing or Completed: 決済が確認されました。ステータスは Order Status After Payment に従います。注文メモには取引 ID と、決済を確認したのが IPN かステータス照会かが表示されます。SimplePay の取引 ID は注文の取引 ID として保存されます。遅れて届いた成功した決済は、失敗またはキャンセル済みだった注文も完了させます。

On hold: 決済を開始した後に注文合計または通貨が変更されたため、支払われた金額が注文と一致しません。注文メモには両方の金額が表示されます。注文を確認して処理するか、決済を返金してください。

Failed: SimplePay が、最新の決済試行が承認されなかったか、不正であったと報告しました。

Cancelled: SimplePay が、最新の決済試行がタイムアウトしたか、キャンセルされたと報告しました。

返金済みまたは完了済みの注文が、遅れて届いた IPN によって再び開かれることはありません。すでに支払い済みの注文に対して 2 回目の決済が成功した場合、その注文は再度変更されません。メモには、SimplePay の管理画面で確認し、重複している場合は返金するよう表示されます。

返金

注文を開き、Refund をクリックして金額を入力し、Refund via SimplePay (OTP) をクリックします。全額返金と一部返金に対応しています。HUF の返金は整数のフォリントでなければなりません。返金は、決済時に使用した加盟店アカウントとモード（サンドボックスまたは本番）で送信されるため、そのアカウントが設定に残っている必要があります。SimplePay が返金を受け付けない場合、WooCommerce はエラーを表示し、返金は記録されません。返金が成功すると、SimplePay の返金取引 ID と、入力した場合は理由が注文メモに追加されます。

SimplePay の加盟店管理画面で行われた返金は WooCommerce に同期されません。Refund via SimplePay (OTP) を使わずに、WooCommerce に手動で記録してください。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに SimplePay が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、注文通貨が HUF、EUR、USD のいずれかであること、そしてその通貨について現在のモードで Merchant ID と Secret key の両方が設定されていることを確認してください。Sandbox mode がオンの間はサンドボックスのアカウント、オフの間は本番のアカウントです。ストア通貨のアカウントがない場合、設定ページに警告が表示されます。

決済は完了したが、注文が Pending payment のまま: IPN がストアに届いていません。SimplePay の加盟店管理画面で、使用している加盟店アカウント（本番またはサンドボックス、注文の通貨）の IPN URL を確認してください。設定に表示されている URL と完全に一致している必要があり、サーバーはインターネットから到達可能である必要があります。購入者が支払い後にストアに戻った場合も、注文は確定します。

IPN が Invalid signature を返す: IPN が設定にない加盟店アカウントを指定しているか、その Secret key が正しくありません。MERCHANT と SECRET KEY を、SimplePay の加盟店管理画面に表示されているとおりに正確に入力してください。SimplePay は、確認されていない IPN を再送します。

IPN が Order not found または Unknown transaction を返す: IPN は、このストアが開始していない注文または取引に関するものです。注文は変更されません。

IPN が Busy, retry を返す: 注文が同時に別のリクエストによって確認されていました。SimplePay が IPN を再試行します。

購入者が注文時にエラーを見る: 注文メモを開くか、WooCommerce > Status > Logs を確認してください。ソースは wcp_simplepay_gateway です。誤った secret key の場合は Invalid response signature from SimplePay. Check the secret key of the merchant account. と表示されます。SimplePay のエラーは SimplePay error code(s): に続けてコードが表示されます。

サンドボックスと本番を切り替えた後: 新しい決済は、新しいモードのアカウントを使用します。切り替え前に開始された注文は、開始されたときの加盟店アカウントとモードを保持します。そのため、その IPN、ステータス照会、返金はそのアカウントを使用します。そうした注文が開いている間、または返金の可能性がある間は、古いモードのアカウントを設定に残しておいてください。

決済後に注文が On hold になる: 注文メモを読んでください。決済を開始した後に注文合計または通貨が変更されています。注文を処理するか、決済を返金してください。

返金に失敗する: メッセージを読んでください。SimplePay refunds in HUF must be whole amounts. は、HUF の金額に小数点があったことを意味します。メッセージに、この決済の加盟店アカウントが設定されていないと表示される場合は、決済時に使用したアカウント（通貨とモード）を再入力してください。SimplePay が別の金額を返金していた場合、メッセージは SimplePay の管理画面で返金を確認するよう求めます。

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

アンインストール

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

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