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.
Recommended Integration Procedure
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
istrue
(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.