Skip to content

Getting started

This takes about ten minutes and uses only the sandbox.

1. Create an account

Register at /register and confirm your email. Any TechTur POS account can register applications.

2. Register a sandbox application

In the Developer console choose Register application, keep Sandbox, and pick scopes (for example business:read products:read products:write inventory:read orders:write orders:read). You get a clientId and a clientSecret. The secret is shown once — store it in your secrets manager.

Sandbox applications are approved for public scopes immediately. Live applications, and any platform:* scope, are reviewed by TechTur.

3. Create a sandbox business

Create sandbox business in the console. It comes with VAT registration (test number), products with barcodes, stock and two customers. Sandbox businesses are invisible to live applications and excluded from every live figure.

4. Get a token

For a quick start, open your application and use Test token: it connects your app to the sandbox business and mints a 24-hour access token. In production you will use OAuth instead — see Authentication.

5. Call the API

curl -H "Authorization: Bearer $TOKEN" \
  https://pos.techtursolutions.com/api/v1/businesses/$BUSINESS_ID/products

or with the SDK:

import { TechturPos } from "@techtur-pos/sdk";
const pos = new TechturPos({ baseUrl: "https://pos.techtursolutions.com", accessToken: process.env.TOKEN! });
const { data } = await pos.products.list(businessId);

6. Next