Unsupported Protocol Errors

Problem

You see one of the following errors when WHMCS attempts to connect to a remote service like a payment gateway via a secure connection:

Error code 35 Unknown SSL protocol

or

Unsupported SSL protocol

or

sslv3 alert handshake failure

or

tlsv1 alert protocol version

Cause

This error may occur when WHMCS attempts to connect to a remote service like a payment gateway via a secure connection.

You may also see a Secure TLS Support in cURL warning at Configuration () > System Health.

When you see these errors, the server is attempting a secure connection using an outdated SSL protocol. Due to security risks, most providers now require connections to use up-to-date TLS protocols.

WHMCS is cryptographic-protocol-agnostic and we do not specify a protocol version when establishing cURL connections to external services. cURL will automatically negotiate the best available cryptographic protocol based on the server configuration and the service.

Any restrictions to the cryptographic protocol WHMCS can use are a result of the server configuration and not WHMCS itself.

For more information about cURL errors, see libcurl Errors.

Solution

Work with your hosting provider or system administrator to ensure that remote cURL connections use TLS 1. protocols by default. Ensure that they do not use outdated SSL, TLS 1.0, and TLS 1.1 protocols.

To help identify the cause of this error, you can:

  • Update to an active version of WHMCS.
  • Ensure that WHMCS is using a supported PHP version for your version of WHMCS.
  • Ensure that the version of cURL on your server can support the correct cryptographic protocol for the service you want to connect to.
  • Ensure that the SSL library on your server can support the correct cryptographic protocol for the service you want to connect to.
  • Test your website using a service like ssltest.

Last modified: October 9, 2024