Easy Digital Downloadsには、PayPal連携が標準で組み込まれています。この決済ゲートウェイは、最新のPayPalチェックアウトエクスペリエンスを利用し、スマートボタンと、ユーザーが支払いプロセス全体を通じてサイトに留まる「PayPalで支払う」モーダルを使用します。このドキュメントでは、PayPalの設定を管理するために必要なすべてを説明します。
他のPayPalゲートウェイからアップグレードしますか？アップグレードノートをご覧ください。
注意：このPayPal連携にはSSL証明書が必要です。まだお持ちでない場合は、SSLの設定方法に関する記事をご覧ください。
PayPalを設定する
1. PayPalアカウントに接続する
このゲートウェイを使用して支払いを受け付けるには、PayPalアカウントが必要です。まだアカウントをお持ちでない場合は、オンボーディングプロセス中に作成するオプションが提供されます。
WordPress管理画面にログインし、ダウンロード » 設定 » 支払い » PayPalに移動します。ストアの現在のモード（サンドボックスまたはライブ）でPayPalに接続するためのボタンが表示されます。
ボタンをクリックすると、PayPalモーダルが開きます。ここでメールアドレスと国を入力するように求められます。既存のアカウントにログインするか、新しいアカウントを作成する手順を進めてください。
重要：PayPalページがモーダルで開くためには、ブラウザのポップアップを有効にする必要があります。モーダルが表示されない場合は、ブラウザのポップアップ設定を確認し、ブラウザを閉じてから再試行してください。それでもポップアップウィンドウが表示されない場合は、Chromeブラウザで試してみてください。
PayPalへの接続中にエラーが発生し、問題が解決しない場合は、接続モーダルが表示されないようにサーバーのルールが原因である可能性があります。これは、`hash_equals`関数に関連するエラーとして表示される場合があります。これを解決するには、あなたまたはあなたのホストが`Cross-Origin-Opener-Policy`を調整する必要があるかもしれません。「same-origin」の値は、この問題を引き起こす可能性があります。
テストモードで接続している場合は、サンドボックスアカウントの認証情報でログインする必要があります。まだPayPalサンドボックスアカウントをお持ちでない場合は、アカウントの作成方法に関する記事をご覧ください。
すべての手順を完了すると、次の成功メッセージが表示されるはずです：
ストアに戻るボタンをクリックすることを忘れないでください。このボタンをクリックしないと、オンボーディングプロセスを完了できず、最初からやり直す必要があります。
2. アカウントステータスを確認する
EDD管理設定に戻ると、「接続ステータス」エリアでPayPalへの接続が確認されます。3つの可能性があります：
成功
アカウントが正常に接続され、支払いを受け付ける準備が整いました。EDDが代わりにWebhookを作成しました。Webhookについては、Webhookセクションで詳しく読むことができます。
成功、Webhookに関する警告あり
これにより、PayPalアカウントが正常に接続され、支払いを受け付けられるようになります。ただし、EDDは代わりにWebhookを作成できませんでした。これはローカル環境では心配する必要はありませんが、ライブサイトで発生した場合は、EDDサポートに連絡して支援を受けてください。Webhookが何のためにあるのかについては、Webhookセクションで詳しく読むことができます。
エラー
このようなエラーメッセージが表示されることもあります。「支払い状況」のほとんどのエラーは、PayPalアカウントのいずれかの部分が支払いを受け取る準備ができていないことを意味します。これは、PayPalカスタマーサポートに連絡するか、PayPalアカウント内でメールアドレスを確認するなどの操作を行う必要があることを意味します。
エラーを修正したら、「支払い状況を再確認」をクリックして、PayPalでアカウントを再度確認してください。支払いを受け付け始める前に、すべてエラーを解決する必要があります。
3. PayPalゲートウェイを有効にする
接続したら、一般的なゲートウェイ設定でゲートウェイを有効にしてください。
ライブモードでも繰り返す
最初にテストモードで接続した場合、ストアをライブモードに切り替えたら、この接続プロセスを繰り返す必要があります。
Webhook
Easy Digital Downloadsは、自動的にWebhookを代わりに作成しようとします。Webhookは主に、PayPalダッシュボード内で発生したアクションをEDDに伝えるために使用されます。たとえば、PayPal内で支払いを返金した場合、EDDがそれを検出し、EDD内の支払い状況を自動的に更新します。
Webhookは支払いを処理するために必須ではありませんが、最も完全な統合のために推奨されます。
Webhookステータスを確認する
Webhookのステータスは、いつでも ダウンロード »設定 »支払い » PayPal に移動して確認できます。Webhookステータスと登録済みのイベントが一覧表示されます。
「Webhookを同期」ボタンは、Webhookのステータスを再度確認し、不足しているイベントを登録するだけです。通常、次の場合を除き、このボタンをクリックする必要はありません。
- サイトのURLを変更した場合。
- Webhookが完全に構成されていないという警告メッセージ、またはイベント不足に関する警告が表示された場合。
フォールバックIPN
Easy Digital Downloadsは現在、Webhookイベントがウェブサイトに配信されない可能性のあるシナリオを処理するフォールバックIPNサービスを使用できるようになります。
IPNを設定するには、PayPalアカウントにログインし、画面右上隅の歯車アイコンにカーソルを合わせて、アカウント設定を選択する必要があります。
画面左側の通知をクリックし、即時支払い通知の横にある更新をクリックします。
以前にIPNを有効にしていない場合は、IPN設定を選択ボタンが表示されます。IPN設定ページで、次の形式でウェブサイトのURLを追加します: https://yoursite.com/?edd-listener=eppe
リンク内のyoursite.comを実際のウェブサイトのURLに置き換えてください。
IPNメッセージを受信する（有効）ボックスをチェックしてから、保存をクリックします。
これで完了です！これは、アカウントを接続する際に PayPal のセットアップが使用するメインの Webhook のフォールバックとして機能します。
PayPal Commerce Pro
PayPal Commerce Pro は有料拡張機能で、顧客はサイトから直接、PayPal のサイトにリダイレクトされるのではなく、クレジットカードまたはデビットカード、および（お住まいの国によっては）Venmo、Apple Pay、Google Pay などの代替の支払い方法で支払うことができます。
インストールして有効化すると、PayPal の設定に「高度なクレジットカードおよびデビットカード支払いを有効にする」という新しい設定が表示されます。これは Downloads » Settings » Payments » PayPal にあります。
有効にすると、「デビットまたはクレジットカード」および「後払い」（PayPal アカウントでサポートされている場合）ボタンが、PayPal ボタンと共にチェックアウトページに表示されます。
チェックアウトエクスペリエンス
この支払いゲートウェイは、PayPal の最新のチェックアウトボタンを使用します。通常の「購入」ボタンの代わりに、顧客はチェックアウトフォームの最後に次のような表示を見ることになります。
ボタンをクリックすると、PayPal.com のモーダルウィンドウが開き、ユーザーに PayPal アカウントへのログインを求めます。顧客はサイトを離れることなく、チェックアウトプロセス全体を完了できます。
定期支払い連携
この PayPal ゲートウェイは、定期支払い拡張機能を完全にサポートしています。設定手順については、定期支払い PayPal セットアップドキュメントを参照してください。
ブラウザサポート
以下のデスクトップブラウザはサポートが保証されています。このリストにないブラウザでは、ボタンは引き続き機能する可能性がありますが、互換性は保証されません。
- Chrome バージョン 41 以降
- Firefox バージョン 43 以降
- Safari バージョン 8 以降
- Opera バージョン 12 以降
- Edge バージョン 14 以降
- * Internet Explorer バージョン 11 以降
* 注意: ボタンは IE11 でも機能するはずですが、互換性を確保するためにいくつかのポリフィルを読み込む必要があります。最適なチェックアウト体験のために、よりモダンなブラウザの使用をお勧めします。IE11 ポリフィルの読み込みを希望しない場合は、次のカスタムコードをサイトに追加することで無効にできます。
add_filter( 'edd_load_ie11_polyfills', '__return_false' );
このコードスニペットを追加すると、PayPal ゲートウェイは IE11 では機能しなくなります。
PayPal Checkout のブラウザ要件の詳細については、PayPal のブラウザサポートページを参照してください。
PayPal Sandbox アカウントの作成
PayPal Sandbox を使用すると、PayPal ゲートウェイを使用した Easy Digital Downloads での完全な購入プロセスをテストするために使用できるテストアカウントを設定できます。実際の請求は発生せず、実際の PayPal フローを模倣したテストアカウントであるため、好きなだけ長く使用できます。
サンドボックスアカウントを作成するには、https://developer.paypal.com にアクセスし、まだ PayPal アカウントが設定されていない場合は、ログインまたはサインアップをクリックしてください。既存の PayPal アカウントをお持ちの場合は、それを使用してログインできます。
ログインしたら、以下の手順に従ってサンドボックスアカウントを作成してください。
- テストツール > サンドボックスアカウントに移動します。
- 「アカウントを作成」をクリックします。
- 「ビジネス」を選択し、アカウントの国を選択して、「アカウントを作成」をクリックします。
- 再度「アカウントを作成」をクリックし、今回はアカウントの種類として「個人」を選択します。
上記の手順により、EDD内で接続するために使用するマーチャントアカウントと、支払いシミュレーションのチェックアウトフロー中に使用する個人アカウントが作成されます。
サンドボックスアカウントページで、表示/編集したいアカウントをクリックすると、作成時に設定されたデフォルトのパスワードを表示したり、カスタムパスワードを設定したりできます。
テストモードになっていることをどうやって確認できますか？
サイトがテストモードで動作していることを確認するには、ダウンロード »設定»支払いに移動し、ページ上部にあるテストモードのチェックボックスをオンにします。
注意
サイトを公開する前に、テストモードを無効にしてください。無効にしないと、売上が無効になります。テストモードを無効にした後は、ライブPayPalアカウントに接続する必要がある場合があります。
他のPayPalゲートウェイからのアップグレード
新しいPayPalゲートウェイへのアップグレードは、接続し、上記の設定手順に従ってから、古いゲートウェイを無効にするだけです。
以前にPayPal Standard、PayPal Express、PayPal Pro、PayPal Payments Advancedなどの古いPayPal統合のいずれかを使用していた場合、Easy Digital Downloadsバージョン2.11に更新すると、この新しいゲートウェイに切り替えるように求められます。
アップグレードはどのように機能しますか？
新しいゲートウェイに接続するまで、支払いはいずれかの既存のゲートウェイを使用してサイト経由で処理され続けます。新しいPayPal統合に接続するときは、以前に使用していたものとまったく同じPayPalアカウントを使用して接続する必要があります。接続プロセスが完了し、新しいゲートウェイを有効にすると、支払いは新しいPayPal統合経由で処理され始めます。古いゲートウェイを無効にして、新しいゲートウェイのみがアクティブになるようにしてください。
PayPal自体では、違いはわかりません。支払いは以前と同じ方法で引き続き行われます。サイトでのチェックアウトエクスペリエンスのみが更新されました。
定期支払いについてはどうですか？
定期支払い拡張機能を使用している場合、既存のサブスクリプションに影響を与えることなく、新しいPayPalゲートウェイに安全に切り替えることができます。古いサブスクリプションは通常どおり処理および更新され続けます。ただし、次の点に注意してください。
- 新しいゲートウェイがセットアップされたら、有効な支払いゲートウェイのリストから古いゲートウェイのチェックを外すことができます。
- PayPal ExpressおよびProの場合、古いPayPal IPNを構成したままにする必要があります（Express / Pro IPNドキュメント）。古いゲートウェイで作成されたサブスクリプションは、更新支払いをEDDに通知するためにIPNを引き続き使用するためです。PayPal StandardはIPNに依存しません。URLはIPNにハードセットされているためです。複数のストアでPayPalアカウントを使用しない場合は、将来PayPalが機能を変更した場合に備えて設定することをお勧めします（Standard IPNドキュメント）。ただし、必須ではありません。
- PayPal ExpressまたはPayPal Proを使用している場合は、そのプラグインを有効にしたままにする必要があります。ゲートウェイ自体は有効にする必要はありません（ダウンロード»設定»支払い）が、プラグインは有効にする必要があります。これは、ステップ2で述べたように、ゲートウェイが古いIPNを処理し続けられるようにするためです。
注意：Aelia Currency Switcherを使用していますか？
サイトでサポートされている通貨に対して、Aelia Payment Gatewaysの設定でPayPalを再追加する必要があります。そうしないと、チェックアウトでPayPalが利用可能なゲートウェイではなくなります。
新しい統合にアップグレードする必要がありますか？
古いPayPal統合はすべて廃止されます。今後、更新は受けられなくなります。さらに、古い統合の多くはPayPal側でも廃止されており、古いチェックアウトエクスペリエンスを表しています。
古い統合はEDD 2.xで引き続き機能するはずですが、古いPayPal拡張機能は3.0互換にするための更新が行われないため、3.0の前に新しいゲートウェイに切り替えることをお勧めします。
よくある質問
接続プロセス中にSANDHILLS DEVELOPMENT, LLCと表示されますが、これは予期されたことですか？
はい、Easy Digital DownloadsはSANDHILLS DEVELOPMENT, LLCの製品です。Easy Digital Downloads（SANDHILLS DEVELOPMENT, LLCの製品）ストアにPayPalアカウントを接続することに同意しています。残念ながら、PayPalでは製品名の代わりに会社名を使用する必要があります。
個人アカウントでPayPalに接続できますか？
EDDをPayPalに接続するには、ビジネスアカウントが必要です。個人PayPalアカウントにEDDを接続することはできません。ビジネスアカウントをお持ちでない場合は、別のビジネスアカウントを作成し、個人アカウントをビジネスアカウントにしたくない場合は複数のPayPalアカウントを持つことができます。
チェックアウトページに「予期しない認証エラー」と表示されるのはなぜですか？
これは、PayPalがストアに正しく接続されていないことが原因である可能性が高いです。ダウンロード»設定»支払い» PayPalの下のステータスを確認してください。また、ライブPayPalアカウントがテストモードでEDDに接続されていないこと、およびPayPalサンドボックスアカウントがライブPayPal接続に接続されていないこと（テストモードが無効でPayPalに接続）を確認してください。
PayPalがEDDに接続できないのはなぜですか？
これはいくつかの問題が原因である可能性があります。
– 別のブラウザまたはデバイスで接続してみてください。
– PayPalアカウントが、接続プロセス中のドロップダウンボックスに記載されているサポートされている国に関連付けられていることを確認してください。
– PayPalアカウントが完全にアクティブであることを確認してください。完了する必要のある保留中のアクションがPayPalにある可能性があります。PayPalアカウントの通知を確認するか、PayPalサポートに連絡してアカウントがアクティブであることを確認してください。
分割払いまたは4回払いボタンを追加または削除できますか？
サイトに分割払いまたは4回払いボタンを表示するには、PayPal Commerce Proが必要です。ボタンが表示されていて無効にしたい場合は、EDD PayPal設定で無効にすることができます。
当社の定期支払い拡張機能を使用して、特定の回数の支払いもサポートできます。
PayPalゲストチェックアウトが表示されないのはなぜですか？
PayPal.comのチェックアウトページから支払う場合、PayPalにログインせずにクレジットカードで支払うオプションが用意されている場合があります。これは「ゲスト」チェックアウトモードまたはPayPalアカウントオプションとして知られています。有効または無効にするには、こちらのPayPalの説明を参照してください。PayPalアカウントオプション設定を有効にする方法は次のとおりです。
- 右上隅にある自分の名前の上にカーソルを合わせます。
- ドロップダウンメニューでアカウント設定をクリックします。
- ページ左側の「製品とサービス」の下にあるウェブサイト決済をクリックします。
- 「ウェブサイトの基本設定」の横にある更新をクリックします。
- 「PayPalアカウントオプション」の下でオンを選択します。
PayPalを使用する場合、SSLは必要ですか？
はい、支払いはPayPalでオフサイトで処理されますが、ウェブサイトでSSLを有効にする必要があります。
支払いが完了しても、顧客がサイトにリダイレクトされません。
PayPalで支払う場合、支払いが完了するとウェブサイトにリダイレクトされることを期待します。これが正しく機能しない場合は、PayPalプロファイルで自動返信オプションを有効にする必要がある可能性があります。
PayPalアカウントにログインし、プロファイル設定に移動します。
設定で、ウェブサイトの基本設定をクリックします。
そこで自動返信を有効にするオプションがあります。
上記の例では、オフになっています。オンにするには、オンラジオボタンを選択し、下のフィールドに顧客をリダイレクトしたいアドレスを入力してください。
