Environments

Development environment

API: https://sandbox.qerko.com/api/v2/pos/ (opens in a new tab)

Development environment is accessible publicly so nothing stands in your way to start integrating.

Development setup

1. Install Qerko app

2. The app works in production mode by default. To switch the app into development mode, you have to type qerko-toggle-test into the Email field on the login screen and press the Continue button. A TEST mark will appear in the top part of the screen which indicates that the app has been switched to development mode. (You can switch it back to production mode by repeating this procedure.)

3. When the app is successfully switched to development mode, you can register your development account and add a test credit card.
   Before payment testing, let our tech-support know, they will enable the necessary payment gateways for your testing restaurant.

ČSOB (CZ)

PayU (SK, DE, AT)

Adyen (HU)

You may want to visit our payment gateway doc (in czech language) (opens in a new tab) for more options.

For PayU testing payments, contact our tech-support at techsupport@qerko.com in order to activate the testing payments.

Payments are simulated, so feel free to pay anything.

4. Register your development restaurant at Restaurant Admin (opens in a new tab). It will take you to Create new restaurant form after registration. But you can create any number of restaurants afterwards.

5. In the restaurant administration you need to create an API key. There is a link API keys admin in the left column (accessible by the icon in the top left corner on a smartphone).

6. All set:

You have an API key for POS authorization. You have set up the app on your smartphone. You have added the credit card into the app. You can use any non-empty string as a Pos-Id in the development environment.

Let’s roll.

Development tools

Qerko provides a few goodies which can be used for development and testing purposes.

Demo POS

https://sandbox.qerko.com/demo2/ (opens in a new tab) (alias DEMO2)

This is a simple POS which serves as our testing environment. Feel free to use it to see how things work. DEMO2 uses websocket and current API v2.

API Tester

https://sandbox.qerko.com/api/v2/pos/ (opens in a new tab)

This is a simple tool which sends requests to the API. Use it to test raw requests and responses.

Production environment

API: https://qerko.com/api/v2/pos/ (opens in a new tab)

Production environment works the same way as the development environment, but payments are not simulated any more. You have to make these steps to enter the production environment:

1. Switch URL to production: https://qerko.com/api/v2/pos/ (opens in a new tab)

2. Start using production Pos-Id which will be assigned to you by tech-support at techsupport@qerko.com. The process of assigning a production Pos-Id is mostly made up of testing the documented functionalities in the sandbox environment - having it tested on your own and ready for our testing will be greatly appreciated. We recommend hardcoding the Pos-Id into your POS or distributing the value with the POS. It is not supposed to be user configurable.

If your company develops multiple POS solutions, each one will be assigned a unique Pos-Id.

In the Development environment a POS can use any non-empty string as stated in the Development setup.

3. Switch Qerko app back to production mode by logging out and following the procedure at point 2 in Development setup.