PayPal API SSL handshake failure errorの解決方法【2025年最新版】

エラーの概要・症状

PayPal APIを利用しているときに発生する「SSL handshake failure error」は、主にAPIへの接続が正常に確立できない場合に表示されます。このエラーは、SSL/TLSの設定が適切でない、またはPayPalのサーバーとの接続に問題があることを示しています。

このエラーが発生すると、以下のような症状が現れます：

ユーザーにとっては、取引の遅延やキャンセルのリスクが高まり、ビジネスの信頼性を損なう可能性があります。特に、オンラインショップを運営している場合、このエラーは致命的な影響を及ぼすことがあります。

「SSL handshake failure error」が発生する主な原因はいくつかあります。以下に代表的な原因を詳細に説明します。

PayPalはTLS（Transport Layer Security）の最新バージョンをサポートしていますが、古いバージョンのSSL/TLSを使用している場合、接続が確立できずエラーが発生します。特にTLS 1.0やSSL 3.0はもはや安全でないと見なされ、使用が推奨されていません。

使用しているSSL証明書が無効または期限切れの場合にも、このエラーが発生します。PayPal APIは信頼できる証明書を要求するため、不適切な証明書は接続を妨げます。

サーバーの設定（例えば、 php.iniやウェブサーバーの設定ファイル）が不適切であると、SSL handshakeが失敗することがあります。特に、必要なモジュールが無効化されている場合に問題が発生することが多いです。

2016年1月19日以降、PayPalはPOODLE脆弱性に対する対策を強化しました。このため、古いSSL/TLSプロトコルの使用が制限され、接続が失敗することがあります。

これらの原因を理解することで、エラー解決への第一歩を踏み出すことができます。

最初に試すべきは、SSL/TLSバージョンを設定することです。具体的には、PayPal APIを呼び出す際に、TLSのバージョンを指定することが重要です。以下の手順に従って設定を行います。

   curl_setopt($ch, CURLOPT_SSL_CIPHER_LIST, 'TLSv1');

この設定変更が有効であることを確認するために、以下の手順を行います：