Link Search Menu Expand Document

Common issues and solutions

Below are a list of common issues that Spaaza has encountered with previous integrations together with suggested solutions:

Working with Spaaza on a POS running on Windows XP with TLS 1.0

Some POS devices still run on Windows XP. This is a problem for using the Spaaza API because Windows XP only supports up to TLS 1.0 and even then it doesn't support any cipher which the Spaaza API supports.

Windows XP has a maximum of Internet Explorer 8 which only supports up to TLS 1.0 (after SSL 2.0 and SSL 3.0) and then only with a limited range of TLS ciphers:

Unfortunately none of these ciphers match those available by Spaaza due to our security policy.

An easy way to demonstrate the problem is to use the SSLLabs website's useful tools to show which ciphers our API supports and then compare with the ones supported by Windows XP.

This SSLLabs site will probe a website and show which ciphers are supported.

The screenshot below shows which TLS 1.0 ciphers are supported:

SSLLabs also has a page which shows which TLS ciphers are supported by which browsers/user agents. You can see the setup for IE8 on Windows XP here

You can also test your browser by using it to go to this page

The screenshot below shows which TLS ciphers are supported in TLS 1.0:

As you can see there is no match between TLS versions and ciphers supported by the Spaaza API and by IE8 running on Windows XP.

The Workaround

There is a way to install the TLS updates in Windows XP, as described in this article

The steps are as listed below.

  • Installing TLS 1.2 on Windows XP

  • Enable TLS 1.2 on Windows XP

  • To enable TLS 1.2 on Windows XP:

  • Download PosReady.zip

  • Extract the .zip file

  • Double click and import PosReady.reg

  • Download TLS 1.x on Windows 7.zip

  • Extract the .zip file

  • Double click and import Enable TLS 1.x on Windows 7.reg

  • Download KB4019276

  • Run the .exe and install the update

  • Restart the system