TablelistPro Logo

Integrations

Billfold POS

3 min read

Connect Billfold so TablelistPro can sync live POS spend and itemized tickets to reservations as orders change in Billfold.

You'll need permission to manage organization settings. See Adding Integrations and Integration security and your data.

What the Billfold integration does

Billfold pushes signed order webhooks to TablelistPro. When an order includes your reservation's POS code, TablelistPro attaches or updates the POS ticket on that reservation and refreshes customer spend.

With Billfold connected, you can:

  • Sync live spend while a tab is still open — item adds and payment changes flow in as Billfold sends updates
  • Match orders to reservations with the reservation POS code on the Billfold order
  • See itemized receipts on the reservation (line items, quantities, prices, discounts)
  • Track ticket totals — subtotal, tax, tip, and total
  • Capture payment details — amount, tip, tender type, card last 4, and cardholder name when Billfold sends them
  • Keep open/closed state in sync as tickets open, close, reopen, go unpaid, or get refunded

TablelistPro handles these Billfold order events: order created, order changed, order paid, order unpaid, and order refunded.

In Billfold Admin, make sure your webhook subscription includes order_changed and order_unpaid. Without those, open-tab item changes won't reach TablelistPro for live spend updates.

How orders link to reservations

Each reservation gets a short POS code. Billfold must send that code on the order (for example as pos_code, posCode, or tablelist_reservation_id in the order's client parameters or metadata) so TablelistPro can find the right reservation.

For how POS codes show on chits and day-to-day ticket sync, see Point-of-Sale.

Set up the integration

  1. Open the sidebar, click Settings, then Integrations.
  2. Click +, choose Billfold, and wait for the setup panel to open (or open an existing Billfold integration to edit).
  3. Click Save so the integration exists in TablelistPro and gets an integration-scoped webhook URL.
  4. Set the integration to Active.
  5. Copy the Webhook URL shown in the panel and paste it into Billfold where they ask for your Tablelist webhook endpoint.
  6. In Billfold Admin, open Developers -> API -> Webhooks, copy the webhook Secret Key, and paste it into Webhook Secret in TablelistPro.
  7. Click Save again.

You don't need an API key in TablelistPro for Billfold webhooks today. The integration-specific webhook URL plus webhook secret are what secure the connection.

The webhook URL points at Tablelist's API (/v1/webhooks/billfold/:integrationId). Billfold signs each request, and Tablelist verifies the signature with your saved webhook secret.

After the first save, Webhook Secret is masked. Leave it blank on later edits to keep the existing secret.

Related settings