Genius version 5.0 and later supports a HTTPs interface in addition to its traditional HTTP interface. Only the protocol scheme (https vs. http) and port (8443 vs 8080) differ from traditional Genius implementations. All other details regarding how your POS communicates with the terminal are unchanged - all API calls, URIs, messages, and request/response payloads are identical, excepting the protocol scheme and port. For more details, please see Alternate Device Communication Methods in our Genius documentation.
Genius supports a HTTPS interface so users can communicate with the CED using TLS to secure the connection. Combined with Genius's CORS support, this feature is especially useful for partners who have developed browser based Points of Sale. The terminal will generate appropriate certificates as required in order to serve the TLS connection, and all certificates generated by the CED will be signed by the Cayan CA.
This means that if merchants install the Cayan CA, then their client machines will trust the certificates that are served by the terminal.
Installing the Cayan CA
The Cayan Root Certificate can be downloaded from http://cayan.com/Site/Media/Cayan/Cayan.crt. Instructions differ between Operating Systems and Browsers, but installation is generally straight forward. Generally, you just need to download the certificate, double click it, and follow the prompts on your screen.
Installation instructions are provided below for some major Windows-based browsers. Firefox appears to use its own local certificate store, while Internet Explorer and Chrome appear to use the standard Windows certificate store. This means that if your POS is a desktop application, you will probably need to follow the Internet Explorer / Chrome installation instructions.
Go to http://cayan.com/Site/Media/Cayan/Cayan.crt
If you see:
Then you've already got the Cayan CA installed and you don't have anything further to do. Otherwise, you'll see:
Ensure that "Trust this CA to identify websites" is checked, then click "OK", and you're done.
Internet Explorer / Chrome
Go to http://cayan.com/Site/Media/Cayan/Cayan.crt and you'll be offered to download the Cayan.crt file, download it and save it somewhere on your hard drive.
Locate the file on your hard drive and right-click on it and choose "Install Certificate".
Select to install the certificate on the local machine and click next.
When asked "Windows can automatically select a certificate store, or you can specify a location for the certificate", choose "Place all certificates in the following store" and hit "Browse":
When prompted, choose "Trusted Root Certification Authorities" and click "OK":
Then click "Next" on the following screen.
Finally click "Finish" to complete the installation.