2026年5月20日

WooCommerceにPayPalを設定して決済を有効にする方法

プラグイン関連

はじめに

WooCommerceのPayPal決済には「PayPal Payments（推奨）」と旧来の「PayPal Standard」の2種類があります。現在はPayPal Paymentsプラグインが公式推奨で、スマートボタン・クレジットカード・Pay Later（後払い）に対応しています。

症状・原因

WooCommerceにPayPal決済を追加したい
PayPalの設定画面でAPIキーがわからない
サンドボックスでテスト決済を行いたい
PayPal Standard（旧方式）からPayPal Paymentsへ移行したい

解決手順

ステップ1：PayPal Paymentsプラグインをインストールする

# WooCommerce PayPal Payments をインストール・有効化
wp plugin install woocommerce-paypal-payments --activate

# インストール確認
wp plugin list --search=paypal --format=table

管理画面の場合：

WooCommerce → 設定 → 決済:
→「PayPal」の「有効化」をクリック
→「セットアップ」ボタンから接続ウィザードを起動

ステップ2：PayPalアカウントと接続する

「PayPal に接続」ボタンをクリック:
→ PayPalビジネスアカウントでログイン
→ 許可を承認
→ 自動的にクライアントID・シークレットが設定される

手動設定の場合:
→「高度な設定」→「手動でAPIキーを入力」
→ PayPal Developer Console から:
  - Client ID: AaBbCc... (本番用)
  - Client Secret: EeXx... (本番用)

ステップ3：サンドボックスでテストする

WooCommerce → 設定 → 決済 → PayPal:
→「サンドボックスモード」: ON
→ サンドボックス Client ID・Secret を入力
  （PayPal Developer Console → My Apps & Credentials）

テスト用アカウント:
→ developer.paypal.com → Sandbox → Accounts
→ 購入者アカウント（Personal）でテスト決済

# PayPal設定をWP-CLIで確認
wp option get woocommerce_ppcp-gateway_settings --format=json

# 主要な設定キー
# enabled: yes/no
# sandbox_on: 1/0
# client_id: クライアントID
# client_secret: シークレット（暗号化済み）

ステップ4：決済ボタンの表示設定をカスタマイズする

PayPal 設定 →「スマートボタン」タブ:
→ ボタン色: ゴールド / ブルー / シルバー / ブラック
→ ボタン形状: 角丸 / 角張り
→ ボタンラベル: PayPal / Checkout / Pay / Buy Now

表示場所:
→ 商品ページ: ON
→ カートページ: ON
→ チェックアウト: ON（必須）
→ ミニカート: ON/OFF

ステップ5：PayPal Standard（旧方式）を設定する

# 旧PayPal Standard の設定確認
wp option get woocommerce_paypal_settings --format=json

WooCommerce → 設定 → 決済 → PayPal Standard:
→ 有効化: ON
→ PayPalメールアドレス: your@email.com
→「PayPal Sandbox」: テスト時ON

IPN（即時支払い通知）URL:
→ https://example.com/?wc-api=WC_Gateway_Paypal
→ PayPal アカウント → 設定 → 通知 → IPN に登録

ステップ6：決済ログを確認する

# WooCommerceのログファイルを確認
wp eval "echo WC_Log_Handler_File::get_log_file_path('woocommerce-paypal-payments');"

# ログディレクトリを確認
ls wp-content/uploads/wc-logs/ | grep paypal

# 注文ステータスを確認
wp post list --post_type=shop_order --post_status=wc-pending --format=table

# 特定注文のPayPalトランザクションID確認
wp post meta get {ORDER_ID} _paypal_transaction_id

ステップ7：PHPで決済ゲートウェイ情報を取得する

// 利用可能な決済ゲートウェイを確認
$gateways = WC()->payment_gateways()->get_available_payment_gateways();
foreach ($gateways as $id => $gateway) {
    echo $id . ': ' . $gateway->title . ' (' . ($gateway->enabled === 'yes' ? 'ON' : 'OFF') . ')' . PHP_EOL;
}

// PayPal設定を取得
$paypal_settings = get_option('woocommerce_ppcp-gateway_settings', []);
$sandbox = $paypal_settings['sandbox_on'] ?? '0';
echo $sandbox ? 'サンドボックスモード' : '本番モード';

注意事項

PayPal Paymentsと旧PayPal Standardを同時に有効化しないでください
本番環境に切り替える前に必ずサンドボックスでテスト決済を完了させてください
IPN（PayPal Standard）を使用する場合、URLエンコードの問題が起きやすいためPayPal Paymentsを推奨します

まとめ

WooCommerceのPayPal決済は「PayPal Payments」プラグインを使いOAuth接続するのが現在の推奨方法です。サンドボックスモードでテスト後に本番切り替えを行い、wp option get woocommerce_ppcp-gateway_settings でWP-CLIから設定確認できます。

Post Views: 9