DocumentationIntroduction

Introduction

Welcome to the Qerko integration guide. If you are starting a new integration, we are ready to assist. To arrange a personal introduction call, contact us at techsupport@qerko.com and we will be happy to schedule it.

The steps below outline the typical integration journey.

Environment

Set up your development environment by following the environment guide.

Connection

Create the connection. Select the option that fits your architecture:

  • WebSocket - ideal for POS systems running on local hardware behind a NAT, such as a desktop application in the restaurant.
  • Long-Polling - suitable for similar deployments when WebSockets are not available.
  • Webhooks - recommended for cloud-based POS systems. Qerko sends webhooks to your service and expects a response.

First method

Once the connection to Qerko is in place, begin with getTableList(). You can verify the implementation by loading the QR codes pairing page, which calls getTableList() on every load.

See the QR codes pairing flow for detailed guidance.

Pair QR codes

When your tables appear in Qerko’s Restaurant Admin, assign QR codes to them.

Scan QR code

After pairing, scan a QR code with the Qerko mobile app. See the development setup section for additional details.

What’s on the table?

When the QR code is scanned, Qerko calls getTableContents(). Continue by returning the table contents.

Payment

When Bill entries appear in the Qerko app, implement getBill(…), paymentStart(…), paymentProcessed(…), and paymentClosed(…).

Refer to the payment flow for the complete sequence.

Congratulations!

You have completed the payment flow. To extend the integration, continue with Orders. We look forward to supporting your next steps.

We hope your integration progresses smoothly. If you have questions or encounter an issue, email techsupport@qerko.com and we will be glad to help.

Certification

When the integration is ready, send a certification request to techsupport@qerko.com. We will schedule a video call to test payments and orders with you. After a successful review, Qerko will issue a Pos-Id for your integration. This Pos-Id enables access to the production environment.

To be certified, your integration must implement all required flows and include the following features:

  • QR code pairing - Send a list of tables (see getTableList()).
  • Payments with bill splitting - Ensure Bill.allowPartialPayment is true (see Bill).
  • Payments with discounts - Handle the Payment.discount field (see Payment).
  • Payments with vouchers - Handle the Payment.parts field (see Payment).

Certification is granted only when all of these requirements are met.

Good luck with your build, and happy coding!


Need help? Contact techsupport@qerko.com for assistance.