Direct Bills
This page documents the direct bill extension to the Qerko API.
With direct bills, the POS maps QR codes directly to bills instead of relying on Qerko. No table entity exists between the bill and its QR code. When Qerko requests the list of bills for a QR code, the POS returns the associated bills.
The POS is responsible for maintaining the QR-code-to-bill mapping, while Qerko provides the QR code and the customer-facing interface. The extension must be enabled for the restaurant before it can be used. Contact Qerko support to activate it in your testing environment.
You can combine both approaches: some QR codes can remain mapped by Qerko, while others use the POS mapping described here.
Examples
-
In a restaurant, a customer receives a card that they present when ordering. The POS maps the card to a QR code provided by Qerko, which the customer later uses to pay.
-
At a street food stand, the POS records a custom amount. The customer scans a Qerko QR code and pays the entered amount without listing individual items.
Methods
searchBill
searchBills(qrIdentifier: string, idCustomer: string): Bill[]Qerko requests a list of bills mapped to a QR code.
Use this method only with 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 POS-side loyalty programs. |
Need help? Contact techsupport@qerko.com for assistance.