Hospitality Vertical for Developers

API Quickstart

Fetch menu lists, create guest check-in sessions, and send orders in three steps.

# 1. Verify Guest Seating Session curl -X POST https://api.softknack.com/v1/hospitality/check-in \ -H "Content-Type: application/json" \ -H "X-Table-OTP: 991823" \ -d '{ "tableId": "tbl_ac_04", "locationId": "loc_chn_01", "partySize": 2 }' # Response: # { # "sessionId": "hsp_sess_88a91c", # "tableId": "tbl_ac_04", # "status": "verified", # "jwt": "eyJhbGciOi..." # }

import axios from 'axios'; // 1. Verify Guest Seating Session const response = await axios.post('https://api.softknack.com/v1/hospitality/check-in', { tableId: 'tbl_ac_04', locationId: 'loc_chn_01', partySize: 2 }, { headers: { 'X-Table-OTP': '991823' } }); console.log(response.data);

import requests # 1. Verify Guest Seating Session url = "https://api.softknack.com/v1/hospitality/check-in" headers = { "X-Table-OTP": "991823" } payload = { "tableId": "tbl_ac_04", "locationId": "loc_chn_01", "partySize": 2 } response = requests.post(url, json=payload, headers=headers) print(response.json())

Signed Webhooks

Adapter updates send HMAC envelopes to your webhook endpoints. Verify headers via X-Nexus-Signature.

Event Type	Description	Trigger Condition
`guest.session.started`	Guest scanned table and verified OTP	Fires upon successful Redis OTP validation
`table.state.dirty`	Table orders sent, table marked dirty	Fires when the first cart order commits to Billing
`table.bill.settled`	Table paid, release trigger fired	Fires when checkout payment commits, releasing table space

Downstream Guarantees

The adapter architecture guarantees secure, lightweight table synchronization.

01 Multi-tenant scope

Table layouts and order routes isolate datasets strictly using tenant keys.

02 Stateless routing

Stores no customer carts inside adapter tables; orders route directly to Billing.

03 Redis verification

Single-use OTP codes invalidate in 120s to block cross-table check-in hijacking.

04 Real-time SSE

Streams updates immediately to kitchen operator displays without polling delay.

05 Decline capping

Stops menu suggestions when decline count hits three, avoiding guest fatigue.

06 Trigger releases

Clears active reservation blocks instantly on billing settlement commits.

Adapter APIs & MCP schemas

Stateless Adapter Architecture