Linking a shop

Connect a real shop without anyone copying a key. Your POS shows a short code, the shop owner types it into the Nunua Pro Business app, and your POS collects the shop's key.

How linking works

1. Your POS asks for a codeWith your partner key, and shows it on the till or in your settings screen.
2. The owner enters itIn the Business app, signed in as the shop's owner.
3. Your POS collects the keyIt polls the code until the owner has entered it, and receives the shop key once.

Ask for a code

Call POST /pos-partner/v1/link-codes with your partner key. The optional label helps the owner recognise which till asked.

// Request
{ "label": "Till 2" }

// Response
{ "code": "K7QM-2XPD", "expires_at": "2026-11-03T10:30:00+03:00", "ttl_minutes": 15 }

Show the code in large type. It avoids look-alike characters, so it is easy to read aloud.

The owner enters it

In the Business app: Products menu → POS & CSV import → I have a code from my POS, then type the code and tap Connect. Point the owner there from your POS screen.

Collect the key

Poll GET /pos-partner/v1/link-codes/{code} every few seconds while the code is on screen.

// Still waiting for the owner
{ "status": "pending" }

// Linked: the key appears in this response ONCE
{ "status": "linked", "shop": { "id": 812, "name": "Mama T Supermarket" }, "api_key": "npk_live_..." }

// Not entered in time: ask for a new code
{ "status": "expired" }

Rules

• A code works once and expires after 15 minutes.
• A shop that already has a POS connected must disconnect it first.
• Store each key with the shop it belongs to: one key per shop, one shop per branch.
• The owner can pause, rotate or disconnect the link from the same screen at any time. See rotating and revoking for what your POS sees.