Direct Bills
This page describes the extension to the Qerko API for direct bills.
With direct bills, QR codes are mapped to bills by the POS, not by Qerko, so there is no table between bills and QR codes. Qerko asks the POS for a list of bills mapped to a QR code. The POS responds with a list of bills associated with that QR code.
The POS must handle the QR code and bill mapping itself. Qerko only provides the QR code and the interface for customers. This extension must be enabled for the restaurant; otherwise, it will not be functional. If you are interested in implementing this extension, contact Qerko to enable it for your testing restaurant.
It is possible to have some QR codes mapped by Qerko and others mapped by the POS according to this extension.
Examples
-
In a restaurant, a customer receives a card that is then used to order items. The POS maps this card to a QR code provided by Qerko, which can be used to pay when the customer is ready to leave.
-
At a street food stand, you enter a custom amount to pay into your POS. The customer scans a Qerko QR code and pays the entered amount. No items need to be specified in the POS.
Methods
searchBill
searchBills(qrIdentifier: string, idCustomer: string): Bill[]Qerko requests a list of bills mapped to a QR code.
This method is used only in the directBill extension.
| Parameter | Type | Description |
|---|---|---|
| qrIdentifier | string | Identifier of the QR code scanned by the customer. Example: “000001” |
| idCustomer | string/null | Deprecated and currently always null. Identifier of the customer at the table, used for loyalty programs on the POS side. |
Need help? If you get stuck or have questions, email us at techsupport@qerko.com—we’re here for you!