VibeFox PayPal for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

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

PHP: 8.0 以降。

HTTPS: 本番環境で支払いを受け付けるには、サイトで HTTPS を使用することをお勧めします。

PayPal アカウント: PayPal Developer Dashboard で REST API アプリを作成した PayPal Business アカウント。アプリの Client ID と Secret が必要です。サンドボックスアプリと本番アプリでは認証情報が異なります。ウェブフックは不要です。プラグインは、購入者がチェックアウトにいる間に各支払いをサーバー上で確認します。

通貨:PayPal がサポートする通貨のいずれか: AUD、BRL、CAD、CHF、CNY、CZK、DKK、EUR、GBP、HKD、HUF、ILS、JPY、MXN、MYR、NOK、NZD、PHP、PLN、SEK、SGD、THB、TWD、USD。

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

インストール

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

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

3. PayPal Developer Dashboard で REST API アプリ（サンドボックスまたは本番）を作成し、その Client ID と Secret をコピーします。

4. 設定を開きます: WooCommerce > Settings > Payments > PayPal (Smart Buttons) > Manage。または、プラグイン一覧ページのプラグイン名の下にある Settings をクリックします。

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

6. 使用するモードの認証情報を入力し、Capture または Authorize を選択して、Enable/Disable をオンにして保存します。

7. PayPal のサンドボックス購入者アカウントでテストしたら、Sandbox mode のチェックを外し、本番の認証情報を入力します。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > PayPal (Smart Buttons)。支払い方法が有効なのに、選択中のモードの Client ID または Secret が空である場合や、ストアの通貨が PayPal でサポートされていない場合には、フィールドの上に警告が表示されます。どちらの場合も、支払い方法はチェックアウトで非表示になります。支払い方法の一覧では、サンドボックスモードのとき PayPal に Test mode バッジが表示され、選択中のモードの認証情報が入力されるまで設定が必要な状態として表示されます。

一般

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

Title: チェックアウトで購入者に表示される支払い方法の名称。デフォルト: PayPal。

Description: チェックアウトで支払い方法の下に表示されるテキスト。デフォルト: Pay with your PayPal account or a card via PayPal。

API 認証情報

PayPal Developer Dashboard で REST API アプリを作成し、その Client ID と Secret をコピーします。このセクションには、サンドボックスアプリと本番アプリへのリンクがあります。選択中のモードのフィールドだけが表示されます。

Sandbox mode: Enable sandbox (test) mode。支払いはサンドボックスの認証情報を使って PayPal サンドボックスに送信され、実際の金銭は動きません。デフォルト: on。実際の支払いを受け付けるにはチェックを外します。

Sandbox Client ID: サンドボックス用 REST API アプリの Client ID。

Sandbox Secret: サンドボックス用 REST API アプリの Secret。

Live Client ID: 本番用 REST API アプリの Client ID。

Live Secret: 本番用 REST API アプリの Secret。

支払い

Payment action: 購入者が支払いを承認したときの動作。デフォルト: Capture。

Capture: 購入者にすぐ請求し、注文は処理中になります。

Authorize: 資金は確保されるだけで、注文は保留になります。注文画面の Order actions メニューから支払いをキャプチャまたは取り消してください。PayPal の承認は 29 日以内であればキャプチャできます。

詳細設定

Debug log: Log API requests (errors are always logged)。エントリは WooCommerce > Status > Logs に、ソース wcp_paypal_gateway として保存されます。認証情報や購入者のデータが記録されることはありません。デフォルト: off。

Delete data on uninstall: Delete the gateway settings when the plugin is deleted。注文に保存されている支払いデータ（注文内の PayPal ID）は常に保持されます。デフォルト: off。

チェックアウト

購入者が PayPal（デフォルトでは PayPal）を選択すると、PayPal ボタンが Place order の代わりに表示されます。サンドボックスモードでは、チェックアウトに サンドボックスモード: PayPal のサンドボックス購入者アカウントで支払ってください。実際の金額は請求されません。 と表示されます。ボタンをクリックすると、貴店のサーバーでカート合計（または Pay for order ページの注文合計）に対する PayPal 注文が作成されます。金額は常にブラウザではなくサーバー上で計算されます。

購入者は、PayPal アカウントまたは PayPal が提供するその他の支払い元を使って、PayPal のウィンドウで支払いを承認します。その後、チェックアウトには PayPal での支払いが承認されました。注文を完了しています… と表示され、注文が送信されます。貴店のサーバーは PayPal 注文を読み取り、承認済みであること、今回のチェックアウトで作成されたこと、他の注文で使われていないこと、そして金額と通貨が注文と一致することを確認します。その後にのみ支払いがキャプチャ（または承認）され、購入者は注文受付ページに移動します。

承認後にカート合計が変わった場合、何もキャプチャされません。購入者には PayPal での支払いを承認した後で注文合計が変更されました。PayPal ボタンをもう一度クリックして、新しい合計を承認してください。 と表示されます。チェックアウトの項目が不足している場合は承認が保持され、修正後に購入者が Place order をクリックすると支払いが完了します。PayPal が支払いを拒否した場合は、購入者に PayPal ボタンをクリックして別の支払い方法を選ぶよう求められます。購入者が PayPal のウィンドウを閉じた場合は、チェックアウトに PayPal での支払いをキャンセルしました。 と表示されます。

キャプチャ中に PayPal から応答がない場合、購入者には PayPal での支払いをまだ確認できません。しばらくしてから再度お試しください。二重に請求されることはありません。 と表示されます。再試行では同じ承認が使われ、PayPal が前回の試行を完了していた場合はその支払いが使われ、新しい承認はキャプチャされません。

この支払い方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで動作します。PayPal のスクリプトは独自の名前空間で読み込まれるため、ページ上の他の PayPal プラグインと競合しません。WooCommerce の高パフォーマンス注文保存（HPOS）に対応しています。

このプラグインには、PayPal のウェブフック、Pay Later メッセージ、カード入力欄、Venmo の設定、Apple Pay、Google Pay、Fastlane、保存済みの支払い方法やサブスクリプション、商品ページやカートページのボタンはありません。PayPal から取得した住所ではなく、WooCommerce のチェックアウトで入力された配送先住所が使われます。

注文と返金

Order statuses

Pending payment: 注文は作成されましたが、支払いはまだキャプチャされていません。たとえば、PayPal から不明な応答を受け取った後などです。

Processing: キャプチャが完了しました。ダウンロード可能な仮想商品だけを含む注文は、WooCommerce の標準設定どおり完了になります。注文メモには、金額、PayPal 注文、キャプチャが表示されます。取引 ID は PayPal のキャプチャ ID で、注文画面からは PayPal アカウント内の支払い（サンドボックスまたは本番）にリンクします。

On hold: 支払いは承認済みで、キャプチャを待っています（支払い操作 Authorize）。または、支払いの審査など、キャプチャが PayPal 側で PENDING になっています。または、支払われた金額や通貨が注文と一致しません。または、PayPal の応答から支払いを読み取れませんでした。注文メモに理由が記載されます。

Failed: PayPal がキャプチャまたは承認を拒否しました。

Cancelled: 承認は Void PayPal authorization で取り消されました。

注文操作

注文を開き、Order actions で操作を選択して矢印をクリックします。

Capture PayPal payment: 注文合計について、承認済みの支払いをキャプチャします。キャプチャが完了すると、注文は処理中になります。承認がキャプチャされていない間に表示されます。

Void PayPal authorization: 確保された資金を解放し、注文をキャンセルします。

Check PayPal payment status: PENDING 状態のキャプチャを再取得します。COMPLETED の場合は注文が処理中になり、DECLINED または FAILED の場合は失敗になります。金額や通貨が異なる形でキャプチャが完了した場合、注文は保留のまま、不一致を示すメモが追加されます。

返金

注文を開き、Refund をクリックして金額を入力し、Refund via PayPal をクリックします（ボタンには支払い方法のタイトルが表示されます）。全額返金と一部返金に対応しています。返金は支払いが行われた PayPal 環境（サンドボックスまたは本番）に送信されるため、その環境の認証情報が設定されている必要があります。返金理由は購入者向けのメモとして PayPal に渡されます。PayPal が返金を受け付けない場合、WooCommerce にエラーが表示され、返金は記録されません。返金が成功すると、PayPal の返金 ID とステータスが注文メモに追加されます。PENDING の返金は、後で PayPal によって完了されます。

承認のみの支払いは返金できません。代わりに Void PayPal authorization を使用してください。PayPal アカウント内で行われた返金、紛争、取り消しは WooCommerce と同期されません。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに PayPal が表示されない:ライセンスが有効であること、Enable/Disable がオンであること、選択中のモードの Client ID と Secret が入力されていること、ストアの通貨が PayPal でサポートされていること、カート合計が 0 より大きいことを確認してください。認証情報や通貨に問題がある場合、設定ページに警告が表示されます。www.paypal.com をブロックするブラウザ拡張機能があると、ボタンも非表示になります。

支払いは完了したのに、注文が支払い待ちのまま:プラグインにはウェブフックがないため、支払いはチェックアウト中にのみ確認されます。これは、キャプチャ中に PayPal から応答がなかった場合に発生します。注文メモを確認し、PayPal アカウントで支払いを確認したうえで手動で注文を完了するか、購入者に再試行してもらってください。再試行で二重に請求されることはありません。

PayPal が現在利用できない:認証情報が正しくないか、別のモードのものです。正しいアプリの Client ID と Secret をコピーし直してください。

PayPal の承認をこのチェックアウトに照合できませんでした:セッションの期限切れなどにより、このチェックアウトセッションで PayPal 注文が作成されていません。購入者は PayPal ボタンを再度クリックしてください。

支払い後に注文が保留になっている:注文メモを確認してください。支払いは承認済みです（Capture PayPal payment でキャプチャしてください）。または、キャプチャが PayPal 側で PENDING です（後で Check PayPal payment status を使用してください）。または、支払われた金額や通貨が注文と一致しませんでした。

承認のキャプチャが失敗する:承認から 29 日以上経過しているか、すでに取り消されている可能性があります。注文メモに PayPal のエラーが表示されます。

返金が失敗する:注文に PayPal のキャプチャがない（承認のみ）か、支払いが行われた環境の認証情報が未設定です。開発者は wc_plg_supported_currencies フィルターで通貨リストを変更できます。

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

アンインストール

プラグインを無効化してもすべてのデータは保持されます。削除するには、Plugins ページで無効化してから削除してください。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。ゲートウェイの設定とキャッシュされた PayPal アクセストークンは、Delete data on uninstall がオンの場合にのみ削除されます。それ以外の場合は、後で再インストールする際のために残ります。既存の注文は、支払いメモ、取引 ID、PayPal ID を保持します。

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