Developers Guides Paths Food & Beverage
Food & Beverage
Restaurant and café POS: your app on the terminal, tips, split bills, receipts at the counter, and payment links for orders taken online.
19 guides in reading order. Read them on the site, or take the whole path as one markdown file for your coding agent.
Add this to your codebase
Paste it into Claude Code, Codex, Cursor or any coding agent. It points the agent at this guide in machine-readable form, so it writes against the real API instead of a guess. Wire up the MCP server once and it can read the rest of the platform too.
-
Inter-App Integration
Run your POS on the terminal beside the payment app and hand off each payment with a native app switch. The usual shape for a restaurant till.
-
CheckoutX SoftPOS
The same app switch on a phone or tablet, for servers taking payment at the table without a dedicated terminal.
-
Device Registration
How a terminal is registered to a store before it can take a payment or receive your app.
-
Create an Order
The order is the unit of everything: line items, VAT, and the payment initiated in the same call.
-
Payment Lifecycle
The states a payment moves through, so your POS shows the right thing while the customer taps.
-
Tips Configuration
Tipping on the terminal screen, configured per merchant, store or terminal.
-
Partial Payments
Split a bill across cards, cash and Swish on one order.
-
Refund an Order
Refund a sale by creating a return order with negative quantities.
-
Receipts
Email a receipt, show a link as a QR code, or print on the terminal.
-
Receipt Printing
Print from a Surfboard template or send ESC/POS, on the terminal or a FinPrinter in the kitchen.
-
ESC/POS Printing
Your own receipt layout on the terminal printer, for kitchen slips and branded receipts.
-
Merchant Onboarding
Board each restaurant through the Partner API with a prefilled KYB link.
-
Store Management
One store per location, with its terminals under it.
-
Webhooks
Learn the outcome of every payment without polling, with retries and signature checks.
-
Settlements & Reporting
Settlement reports and adjustments for the merchant, and charges you bill them.
Building something else?
The other paths, or ask the assistant on the guides page what to read for your build.
- 01 Retail Store POS on Surfboard terminals: product catalog with barcodes and stock, a compliant cash register for Sweden, returns, gift cards and receipts. Open the path
- 02 Hospitality Hotels and venues: a deposit online, the balance at reception, pre-authorisation and later capture, stored cards for no-shows, and invoices for corporate guests. Open the path
- 03 SoftPOS only Tap to Pay on iPhone and Android with no hardware: your app beside the CheckoutX app on the same device, then orders, refunds and receipts from your own app. Open the path