AlkemyTouchpoint / Integration kit

START HERE · LOCAL MOCK

Make your first
Touchpoint request.

Explore the API, send a complete basket and follow the integration sequence. The mock and Swagger UI are ready to use here.

Run the first item →Explore all endpoints
Simulation, clearly scoped. Fixed responses and synthetic data. No live POS, payment, fiscal operation or real credential. The mock does not store basket state.

01 / FIRST REQUEST

Open. Execute. Inspect.

1

Open the first case

Use the button above. Case 02 opens the calculate alias with its request and selector already matched.

2

Press Execute

The public demo key is preloaded. The request contains SCO-01, a basket identity and the first item.

3

Check HTTP 200

Expect one accepted line a1, total: 2 and totalSaving: 1. Inspect the complete response below the request.

02 / FOLLOW THE SEQUENCE

Build the basket. Then finish.

Each link opens a matching request and selector in Swagger. Send the full basket at each step; preserve its identity and use the latest digest for finish.

  1. 02First itemStart a basket
  2. 03Second itemKeep accepted lines
  3. 04Third itemComplete the basket
  4. 14LoyaltyObtain the new digest
  5. 10FinishSubmit the digest from 14
  6. 10rRetrySame identity and digest

The supplied requests already carry coherent values. This demonstrates the wire sequence, not live state or idempotency. Manual POS actions are described separately in the guide.

03 / CHECK THE FAILURE PATHS

See what your client must handle.

For HTTP 403, open Authorize in Swagger and clear the demo key. For HTTP 400, select MOCK_ONLY_INVALID_SELECTOR for X-Mock-Case on an integration alias while keeping valid authorization. Restore the demo by reloading the page.

04 / SCENARIO CATALOG

Every input. Every expected output.

Use a scenario endpoint for a single case, or an integration preset to exercise calculate/finish.

CaseScenarioHTTPTry itJSON files

Keep the reference close.

The guide covers authentication, sequences, all startup methods and the transition to a real installation.