WooCommerce で PayPal 決済を受け付けるには、PayPal が開発・提供している無料の公式プラグイン「WooCommerce PayPal Payments」を使います。PayPal のボタンに加えて、地域とアカウントの条件を満たせばクレジットカード・デビットカードの入力欄や Apple Pay・Google Pay も表示できます。この記事の内容は、2026年11月時点で WooCommerce.com の PayPal Payments のドキュメントと、WordPress.org で配布されているプラグイン（バージョン 4.2.2）で確認したものです。画面の項目名は英語で書いています。日本語で表示している場合は表記が異なることがあります。
必要なもの
| 項目 | 要件 |
|---|---|
| WordPress | 6.5 以上 |
| WooCommerce | 9.6 以上（インストールして有効化済み） |
| PHP | 7.4 以上 |
| PayPal | ビジネスアカウントを推奨。個人アカウントは一部の地域でしか販売に使えず、カード入力欄（Advanced Card Processing）や Apple Pay・Google Pay などは使えない |
日本のストアで日本円（JPY）を受け取る場合、PayPal では日本円は小数点以下の無い通貨として扱われます。「WooCommerce → 設定 → 一般」の通貨の設定で、小数点以下の桁数を 0 にしておきます。
プラグインをインストールする
- 管理画面の「プラグイン → 新規追加」で「WooCommerce PayPal Payments」を検索し、作者が PayPal のものをインストールして有効化します。
- 有効化すると、設定画面へのリンクが表示されます。「WooCommerce → 設定 → 決済」の一覧からも、PayPal の設定を開けます。
WP-CLI を使う場合は次のとおりです。
wp plugin install woocommerce-paypal-payments --activateまずサンドボックス（テスト環境）で接続する
本番のお金を動かす前に、PayPal のサンドボックスでテストします。
サンドボックスのアカウントを用意する
- PayPal Developer に PayPal アカウントでログインします。
- ダッシュボードの Sandbox のアカウント一覧を開きます。テスト用のビジネスアカウント（売り手）と個人アカウント（買い手）が用意されています。無ければ作成します。
- 各アカウントのメールアドレスとパスワードを控えます。サンドボックスのアカウントは、本物の PayPal アカウントとは別のものです。
WooCommerce と接続する
- PayPal Payments の設定画面で「See advanced options」を開きます。
- 「Enable Sandbox Mode」をオンにして「Connect Account」を押し、サンドボックスのビジネスアカウントでログインして接続を許可します。
- 自動で接続できない場合は、PayPal Developer で REST API のアプリを作り、表示された Sandbox の Client ID と Secret を「Manual Connect」の欄に入れて接続します。
テストの注文を通す
- ログアウトした状態（または別のブラウザー）で商品をカートに入れ、チェックアウトで PayPal のボタンを押します。
- サンドボックスの個人アカウント（買い手）でログインして支払います。
- WooCommerce の「注文」で、注文のステータスが「処理中」（ダウンロード商品などは「完了」）になることを確認します。
- 返金のテストもしておきます。注文の画面で「返金」を押し、PayPal 経由で返金できるかを確かめます。
ステータスが「保留中」のまま変わらない場合は、PayPal からの通知（Webhook）が届いていない可能性があります。下の「うまく動かないとき」を見てください。
本番のアカウントに接続する
テストが終わったら、サンドボックスの接続を外して本番のアカウントに接続します。
- PayPal Payments の「Settings」タブで、サンドボックスの接続を「Disconnect」で外します。
- 設定画面の「Activate PayPal Payments」を押します。
- アカウントの種類（Business Account または Personal Account）を選びます。
- 販売する商品の種類（Virtual Products / Physical Goods、定期購入を売る場合は Subscriptions）を選びます。定期購入には WooCommerce Subscriptions が必要です。
- 使う支払い方法（Custom Card Fields、Digital Wallets など）を選びます。
- 「Connect to PayPal」を押し、本番の PayPal ビジネスアカウントでログインして接続を許可します。
接続後、少額の商品で実際に1件決済し、返金まで確認すると安心です。
設定画面のタブ
| タブ | 主な内容 |
|---|---|
| Overview | 接続状態、次にやること、各機能の設定ボタン |
| Payment Methods | 使う支払い方法のオン・オフ（PayPal、カード、Apple Pay、Google Pay など） |
| Settings | 接続情報と切断、請求書番号の接頭辞（Invoice Prefix）、決済の確定のしかた（Order Intent）、ログ、Webhook |
| Styling | ボタンの表示場所・形・色・ラベル |
Settings タブの「Invoice Prefix」には、ストアごとに別の文字（例: SHOP1-）を入れておきます。同じ PayPal アカウントを複数のストアで使うと、注文番号が重なって決済が拒否されることがあるためです。
ボタンの表示場所と見た目
「Styling」タブで、PayPal のボタンを表示する場所を選べます。場所は Cart（カート）、Classic Checkout（従来型のチェックアウト）、Express Checkout、Mini Cart（ミニカート）、Product Page（商品ページ）です。形（長方形か丸い角）、ラベル、色（Gold・Blue・Silver・Black・White）も変えられます。
商品ページやカートにボタンを出すと、買い手はチェックアウト画面での住所の入力を省いて PayPal で支払えます。送料の計算が複雑なストアでは、チェックアウト画面だけに表示する方が混乱が少なくなります。
うまく動かないとき
- 「Settings」タブの「Logging」をオンにして、問題を再現してから「WooCommerce → ステータス → ログ」を開き、
woocommerce-paypal-paymentsのログを確認します。ログは30日間保存されます。 - 注文のステータスが変わらない場合は、「Settings」タブの Webhook の項目で「Resubscribe」を押して登録し直し、「Simulate」でテストの通知を送ります。サイトに Basic 認証をかけている、ファイアウォールで PayPal からのアクセスを止めている、といった場合も通知が届きません。
- チェックアウトで PayPal のボタンが表示されない場合は、キャッシュ系のプラグインや JavaScript を最適化するプラグインの設定で、PayPal のスクリプトを除外して確かめます。
決済のエラー全般の切り分けは「WooCommerceで決済が失敗するときの確認方法」も参考にしてください。
PHP から設定の状態を確かめる
WP-CLI で、登録されている決済方法と有効・無効を一覧にできます。PayPal Payments の PayPal ボタンの ID は ppcp-gateway、カード入力欄は ppcp-credit-card-gateway です。
wp eval 'foreach ( WC()->payment_gateways()->payment_gateways() as $id => $gateway ) { echo $id . "\t" . $gateway->enabled . PHP_EOL; }'PayPal の取引 ID は、WooCommerce の注文の「取引 ID」として保存されます。PHP からは wc_get_order( $order_id )->get_transaction_id() で取り出せます。注文のデータが WooCommerce の注文用テーブル（HPOS）に保存されている場合もあるので、wp_postmeta を直接読まずに、この関数を使います。
旧 PayPal Standard を使っている場合
WooCommerce に以前から入っていた「PayPal Standard」は、WooCommerce 5.5 から新しいストアでは表示されなくなり、WooCommerce は PayPal Payments への移行を案内しています。WooCommerce の開発者ブログ（2026年6月）によると、PayPal Payments 4.1.0 以降でアカウントを接続すると、PayPal Standard は自動で無効になり、表示されなくなります。
- PayPal Standard で決済している定期購入（WooCommerce Subscriptions）がある場合は、PayPal Standard は残され、対象の定期購入が通知されます。定期購入は自動では移行されないので、扱いを WooCommerce のサポートに確認してから進めます。
- 移行の前に、WooCommerce.com のドキュメントにある「Upgrade Readiness Tool」で、今の設定と問題になりそうな点を確認できます。
- PayPal Standard と PayPal Payments を同時に有効にすると、チェックアウトに PayPal が2つ並ぶので、どちらかに揃えます。
注意点
- PayPal の手数料、使える支払い方法（後払いの Pay Later は日本では対象外）、カード入力欄を使えるかどうかは、国とアカウントによって違います。PayPal の管理画面と公式の案内で確認してください。
- 本番に切り替えたあとは、サンドボックスの Client ID や Secret が残っていないか、Settings タブの接続状態（Sandbox の表示が無いこと）を確認します。
- ストア全体の初期設定は「WooCommerceの初期設定」でまとめています。