VibeFox PayFast for WooCommerce — ヘルプ

要件

WordPress：6.2 以降。

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

PHP：8.0 以降。

通貨：南アフリカ・ランド（ZAR）。WooCommerce > Settings > General で設定します。PayFast はランドでのみ決済されます。最低注文金額は R5.00 です。

PayFast アカウント：PayFast ダッシュボードの Settings > Developer Settings にある、お使いの PayFast アカウントの加盟店 ID（Merchant ID）と加盟店キー（Merchant Key）。パスフレーズの設定を強くお勧めします。PayFast でパスフレーズを設定している場合は、同じパスフレーズをプラグインに入力する必要があります。テストには PayFast サンドボックスの認証情報が必要です。

到達可能なサイト：支払い通知 URL はインターネットから到達可能である必要があります。メンテナンスモード、ベーシック認証、ファイアウォールによるブロックがあってはいけません。

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

インストール

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

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

3. WooCommerce > Settings > General で、ストアの通貨を南アフリカ・ランドに設定します。

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

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

6. 加盟店 ID、加盟店キー、パスフレーズを入力します。テストの場合は Test mode をオンのままにして、サンドボックスの認証情報を入力します。

7. Enable/Disable をオンにして保存します。テスト決済を行い、実際の支払いを受け付けるにはテストモードをオフにします。

設定

すべての設定は 1 つのページにあります：WooCommerce > Settings > Payments > PayFast。フィールドの上で、このページは次の場合に警告を表示します。現在のモードの認証情報が空である場合（この場合、チェックアウトで PayFast は非表示になります）、ストアの通貨が ZAR でない場合、本番モードで公開サンドボックスの加盟店 ID 10000100 を使用している場合、パスフレーズが設定されていない場合。テストモードがオンの間は、Test mode is on: orders are paid in the PayFast sandbox, no real money is charged. と表示されます。支払い方法の一覧では、現在のモードの加盟店 ID と加盟店キーが入力されるまで、PayFast は設定が必要として表示されます。

一般

Enable/Disable：Enable PayFast で支払い方法のオン・オフを切り替えます。初期値：オフ。

Title：チェックアウトで購入者に表示される支払い方法の名前。初期値：PayFast。

Description：チェックアウトで支払い方法の下に表示されるテキスト。初期値：Pay securely by card, Instant EFT and other methods on the PayFast payment page.

PayFast アカウント（本番）

PayFast ダッシュボードの Settings > Developer Settings で、加盟店 ID と加盟店キーを確認できます。そこでパスフレーズを設定している場合は、まったく同じものをここに入力してください。

Merchant ID：本番用の PayFast 加盟店 ID です。

Merchant Key：本番用の PayFast 加盟店キーです。すべての支払いフォームとともに PayFast に送信されます。

Passphrase：PayFast の Settings > Developer Settings にあるソルトのパスフレーズです。強くお勧めします。支払いと通知に署名します。

サンドボックス（テストモード）

テストモードでは、支払いは PayFast サンドボックスに送られ、実際の料金は請求されません。PayFast サンドボックスにログインすると、サンドボックスの認証情報が表示されます（公開テスト加盟店は 10000100 / 46f0cd694581a です）。

Test mode：Use the PayFast sandbox and the sandbox credentials below。チェックアウトでは、購入者に TEST MODE: payments go to the PayFast sandbox, no real money is charged. と表示されます。初期値：オン。

Sandbox Merchant ID：サンドボックスアカウントの加盟店 ID です。

Sandbox Merchant Key：サンドボックスアカウントの加盟店キーです。

Sandbox Passphrase：サンドボックスアカウントにパスフレーズが設定されている場合のみ入力します。

テストモードのままバージョン 1.0 から更新した場合、既存の認証情報はサンドボックスのフィールドにコピーされます。テストモードをオフにする前に、本番の認証情報を確認してください。

支払い通知（ITN）

PayFast は、すべての支払いを、このセクションに表示される URL へのサーバー間通知によって確認します。その形式は次のとおりです：https://your-site/wc-api/payfast_pay/。このアドレスはすべての支払いとともに送信されるため、PayFast 側で設定する必要はありませんが、インターネットから到達可能である必要があります。

送信元の確認：Accept live notifications only from PayFast servers。アドレスは PayFast の DNS レコードから取得されます。サイトが訪問者のアドレスを隠すプロキシや CDN の背後にある場合にのみ、この設定をオフにしてください。署名とサーバーによる確認は常に行われます。サンドボックスの通知はアドレスでは確認されません。初期値：オン。

詳細設定

Debug log：Log payment steps をオンにすると、各ステップが WooCommerce > Status > Logs に書き込まれます。ソースは wcp_payfast_pay です。エラーは常に記録されます。パスフレーズや顧客の詳細は書き込まれません。初期値：オフ。

Uninstall：Delete the gateway settings and logs when the plugin is deleted。初期値：オフ。

チェックアウト

購入者は支払い方法（初期値は PayFast）を選んで注文します。購入者は注文の Pay for order ページに移動し、そこには Thank you for your order. You are being redirected to PayFast to complete the payment. と表示されます。署名付きの支払いフォームは自動的に PayFast に送信されます。ブラウザが自動で進まない場合、購入者は Pay with PayFast をクリックします。Cancel order をクリックすると注文がキャンセルされます。フォームには、ZAR での注文合計、Order # と注文番号、購入者の氏名とメールアドレス、注文キーが含まれます。ページを開くたびに作り直されるため、購入者は PayFast から戻った後に再度開くことができます。

PayFast のページで、購入者はカード、Instant EFT、または PayFast アカウントの他の方法で支払います。その後、PayFast が支払い通知（ITN）をストアに送信します。注文は、通知がすべての検証に合格した場合にのみ支払い済みになります。

購入者が注文受付ページに戻っても、注文は変更されません。通知が届くまで、ページには PayFast is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. と表示されます。注文が保留中の場合は、Your payment is being reviewed. We will contact you if anything else is needed. と表示されます。

購入者が PayFast のページでキャンセルした場合、注文は WooCommerce の標準的な方法でキャンセルされます。購入者が支払わずに離脱した場合、注文は未払いのままになり、Pay for order ページから再度支払うことができます。

この支払い方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで動作します。現在のモードの認証情報がない場合、ストアまたは注文の通貨が ZAR でない場合、合計額が R5.00 未満の場合は非表示になります。WooCommerce の高性能注文保存（HPOS）に対応しています。

プラグインは ZAR での単発決済のみを受け付けます。WooCommerce からの返金、サブスクリプション、保存済み（トークン化された）カード、予約注文、分割決済には対応していません。

注文

注文ステータス

Pending payment：購入者は PayFast に移動しましたが、支払い通知はまだ届いていません。

Processing：PayFast が支払いを確認しました。これは支払い後の WooCommerce の標準ステータスです。ダウンロード可能な仮想商品のみの注文は完了になります。注文メモには PayFast の支払い ID が表示されます。これは注文のトランザクション ID でもあります。サンドボックスの支払いには、実際の料金は請求されていないというメモが付きます。PayFast の手数料と正味金額は注文に保存されます。

On hold：PayFast が支払いを保留中と報告しました。または、支払われた金額が注文合計と異なる、または注文の通貨が ZAR でない場合。あるいは、すでにキャンセルされた注文に対して支払いが届いた場合。注文メモに理由が記載されます。注文と PayFast ダッシュボードを確認し、その後、出荷するか、PayFast で支払いを返金してください。

Failed：注文が未払いの間に、PayFast が支払いを失敗と報告しました。購入者は再度支払うことができます。

Cancelled：購入者が PayFast のページでキャンセルしたか、あなたが注文をキャンセルしたか、WooCommerce の在庫保持タイムアウトによって注文がキャンセルされました。

同じ支払いに対する繰り返しの通知では、何も変わりません。すでに支払い済みの注文に別の完了した支払いが届いた場合、メモで重複分を PayFast から返金するよう通知されます。返金済みの注文に対する支払いは、メモを追加するだけです。ゲートウェイが本番モードの間に受け取ったサンドボックスの支払いは、メモを追加しますが、注文を支払い済みにはしません。

返金

WooCommerce からの返金はサポートされていません。PayFast ダッシュボードで支払いを返金し、その後 WooCommerce で手動返金を作成してください。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに PayFast が表示されない：ライセンスが有効であること、Enable/Disable がオンであること、現在のモードの加盟店 ID と加盟店キーが入力されていること、ストアの通貨が ZAR であること、注文合計が R5.00 以上であることを確認してください。何かが不足している場合、設定ページに警告が表示されます。

支払いは完了したのに、注文が支払い待ちのままになる：PayFast が支払い通知を届けられなかったか、通知が拒否されました。Debug log をオンにして、WooCommerce > Status > Logs（ソース wcp_payfast_pay）を確認してください。典型的な原因は次のとおりです。サイトがインターネットから到達できない（メンテナンスモード、ベーシック認証、ファイアウォール）。PayFast とプラグインでパスフレーズが異なる。または、本番モードでプロキシや CDN の背後にある場合の送信元の確認。その場合は Source check をオフにしてください。

通知の応答が Invalid signature：プラグインのパスフレーズが、このモードで PayFast に設定されたものと一致していません。

通知の応答が Invalid source：通知が PayFast のアドレスから届いていない、またはプロキシや CDN が実際のアドレスを隠しています。サイトがプロキシや CDN の背後にある場合は、Source check をオフにしてください。

通知の応答が Merchant mismatch または Order mismatch：支払いは別の PayFast アカウントに対して行われたか、この注文のものではありません。何も変更されません。

通知の応答が Confirmation unavailable または Busy：サーバー確認のために PayFast に接続できなかったか、同じ注文に対する別の通知が同時に処理中でした。PayFast は通知を再送します。

通知の応答が Not configured：注文が支払われたモードの認証情報がありません。

購入者に PayFast accepts payments from R5.00 と表示される：注文合計が PayFast の最低額を下回っています。

注文が On hold：PayFast が、注文と一致しない支払いを確認しました（金額が異なる、または通貨が ZAR 以外）。あるいは、すでにキャンセルされた注文に対して支払いが届きました。注文メモと PayFast ダッシュボードを確認してください。

サンドボックスの支払いで注文が支払い済みにならなかった：ゲートウェイは本番モードです。本番モードでは、サンドボックスの支払いが注文を支払い済みにすることはありません。注文のメモにその旨が記載されます。

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

アンインストール

プラグインを無効化しても、すべてのデータは保持されます。削除するには、Plugins ページで無効化してから削除してください。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。ゲートウェイの設定、プラグインのその他のオプション、キャッシュされた PayFast のアドレス、ログは、Delete the gateway settings and logs when the plugin is deleted がオンになっている場合にのみ削除されます。それ以外の場合は、後で再インストールするために保持されます。既存の注文は、支払いメモとトランザクション ID を保持します。

PayFast は、その所有者の商標です。このプラグインは PayFast と提携しておらず、PayFast からの支持も受けていません。