Developers Guides Paths SoftPOS only
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.
13 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.
Go with CheckoutX and the inter-app integration. CheckoutX is the certified payment application, so the PCI and Apple submissions and the compliance that follows sit with Surfboard, not with you, and your app is a normal app that hands off each payment with an app switch. The SDKs put Tap to Pay inside your own app instead, and that moves the submissions to PCI and Apple, the security reviews, and the ongoing compliance work onto your product.
-
CheckoutX SoftPOS
Pair the CheckoutX app with your own app on the same phone or tablet. No SDK, no card data in your app, nothing to certify.
-
Inter-App Integration
The app-switch contract CheckoutX uses for registration, payment and NFC scanning, from a native app or a browser-based POS.
Also available, not on the recommended route
- Tap to Pay on iPhone SDK: The iOS SDK, if Tap to Pay has to live inside your own iPhone app and you are prepared to carry the Apple and PCI submissions yourself.
- Android SoftPOS SDK: The Android SDK, on the same terms: your app becomes the payment application, and its compliance becomes yours.
-
Create an Order
Orders with line items and VAT, with the payment initiated in the same call.
-
Payment Lifecycle
The payment states your app has to handle.
-
Tips Configuration
Tipping on the phone screen.
-
Refund an Order
Refunds as return orders.
-
Receipts
Email the receipt or show a link as a QR code, since there is no printer.
Building something else?
The other paths, or ask the assistant on the guides page what to read for your build.
- 01 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. Open the path
- 02 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
- 03 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