Pay at table

Pay at table enables you to link your POS with the honei Terminal. This allows partnering restaurants to process payments swiftly and with greater flexibility.

Tab sync flow

Payment flow

How honei will retrieve a tab from your POS?

A tab refers to the contents of a table along with the payments related to that content.

When the tab is known, every minute, honei's servers will send a GET request to get that tab by "tabId", from now on until closed

We must first get to know that tab, so the first request on that tab must reference the table. We use the "tableId" field to do it

GET {yourApiURL}/tab

Query Param	Example Value
tabId	123
tableId	1

Response

200 OK

 {
        "tabId": "3722",
        "openDate": 1737622036000,
        "status": "open", // "open","closed" or "cancelled"
        "closeDate": null, // only provide if status is not open
        "numberOfGuests": 3,
        "total": 11.8,
        "totalPaid": 3,
        "totalDue": 9.8,
        "items": [
            {
                "tabItemId": "12977",
                "name": "Patatas bravas",
                "unitPrice": 5.4,
                "price": 5.4,
                "modifierOptions": []
            },
            {
                "tabItemId": "12978", 
                "name": "Patatas bravas",
                "unitPrice": 5.4,
                "price": 6.4,
                "modifierOptions": [
                    {
                       "name": "salsa extra",
                       "supl": 1
                    }
                ]
            }
        ],
        "payments": [
           {
                "paymentId": "67921035f2bbefb64e449337",
                "amount": 1,
                "tip": 0,
                "paidDate": 1737625653495,
            },
                       {
                "paymentId": "67921035f2bbefb64e449337",
                "amount": 2,
                "tip": 1,
                "paidDate": 1737625653495,
            }
        ]
    }

404 Not Found

Sending a payment to the POS

Once the waiter chooses to partially or fully cover the tab, we will send the following POST request to the POS.

POST {yourApiURL}/payment

Body:

{
    "tabId": "12321035f2bbefb64e449123",
    "paymentId": "67921035f2bbefb64e449337",
    "amount": 1,
    "tip": 0,
    "paidDate": 1737625653495,
}

All requests must return code 200