New Truststore and Endpoints

New Truststore and Endpoints

Introduction

In order to guarantee the highest level of security, we want our merchants that are using our QTILL Checkout Enterprise solution, to carry out a certain adaptation which includes a new truststore certificate and the new endpoints for QTILL Checkout Enterprise.

As of January 24th 2021, the new endpoints have to be placed in the production system as the old ones won’t be accessible anymore.

Integration

Endpoints

  • Within qtill.properties values have to changed within QTILL_HOST_URL.

  • Settings accept only one URL.

Old Endpoints New Endpoint Notes

https://checkout.wirecard.com/enterprise

https://api.qenta.com/enterprise

https://checkout.wirecard.com/enterprise-demo

https://api.qenta.com/enterprise-demo

Be aware to use standard https port 443 and keep firewall settings in mind during updates.

Examples

Old configuration
QTILL_HOST_URL=https://checkout.wirecard.com/enterprise-demo
New configuration
QTILL_HOST_URL=https://api.qenta.com/enterprise-demo
Addtional Changes in QTillSettings:
QTillSettings settings = QTillSettings(new URL("https://api.qenta.com/enterprise"));

Truststore

The new endpoint is using a server certificate from a different certificate authority. Therefore, the existing truststore file has to be replaced with the one in the following archive. Keep in mind that the certificate expires on November 2021. We will provide a new one in the course of time.

Click here to download the truststore file.

Name of the old Truststore Name of the new Truststore Notes

wce-trust.jks

qtill-trust-old.jks

No changes to the password. The password from productive truststore has to be used!

Examples:

Old configuration
TRUSTSTOREFILE=/usr/local/qenta/qtill/wce-trust.jks
TRUSTSTOREPASSWORD=<your productive truststore password>
New configuration
TRUSTSTOREFILE=/usr/local/qenta/qtill/qtill-trust-old.jks
TRUSTSTOREPASSWORD=<your productive truststore password>
Additional changes in settings:
settings.setTruststoreFile(new File("qtill-trust-old.jks"));
settings.setTruststorePassword("<truststore password>");

Click here to return to the start page for the upcoming changes in January 2021.