# Nearily for iiko — Loyalty Plugin for iikoFront

> A free Nearily plugin for iikoFront: stamps and cashback in one tap on the order screen, rewards land on the order as a discount. Download, install and setup.

- Page: https://nearily.com/iiko
- Markdown: https://nearily.com/iiko.md
- Language: English (en)
- Other languages: [Русский](https://nearily.com/ru/iiko.md) · [Türkçe](https://nearily.com/tr/iiko.md) · [Қазақша](https://nearily.com/kk/iiko.md)
- Site index for AI: https://nearily.com/llms.txt

---
Integration

## Loyalty in iiko: stamps and cashback in one tap

Nearily loyalty right on the till. The barista enters the guest’s code on the iikoFront order screen — the visit counts, and a due reward is applied to the order as a discount.

[Download the plugin](https://nearily.com/downloads/nearily-iiko-plugin.zip)

or via the short link

### What the plugin does

#### One tap on the order

A Nearily button on the order screen: the guest’s 4-digit code, phone number or QR — and the visit is counted.

#### Rewards apply themselves

When a reward is due, the till offers it — a free drink or cashback lands on the open order as a discount.

#### Settings from the server

Loyalty rules come from Nearily and refresh on their own — no visits to the till, no restarts.

### Install

Four steps on the till. Takes about five minutes.

1

#### Download and extract the archive

Download `nearily-iiko-plugin.zip` — inside is a `Nearily` folder with the plugin and a short install note.

2

#### Copy the folder into iikoFront

Copy the whole `Nearily` folder into `C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Nearily\`. The path may differ per installation — what matters is that it lands in your iikoFront’s `Plugins` folder.

3

#### Restart iikoFront

Close iikoFront completely and open it again — the plugin loads only at startup.

4

#### Check the button

Open an order — a **Nearily** button appears on the order screen. If the settings are not filled in yet, the button itself tells you what is missing.

### Setup

What the cafe owner does — once, together with Nearily.

1

#### Request your access from Nearily

Write to [hello@nearily.com](mailto:hello@nearily.com) or to your Nearily manager. We register the cafe on the platform and issue the till’s credentials: the cafe id and a secret key (issued once per cafe).

2

#### Fill in config.json

In the plugin folder, rename `config.example.json` to `config.json` and fill in the two values you received — `cafeId` and `sharedSecret`. Leave `baseUrl` as it is.

3

#### Discount types in iikoOffice

In iikoOffice (Retail sales → Discount and surcharge types) create two entries, both with the «can be applied manually» checkbox: a fixed discount for the free drink and a flexible-sum discount for cashback. Send us the GUID of each — they are configured centrally, nothing goes into `config.json`.

4

#### Everything else is automatic

Loyalty rules and the remaining settings the plugin fetches from the Nearily server at startup and keeps refreshing while the till runs. Changes reach the till on their own — no visits, no restarts.

### Good to know

#### Lives inside iikoFront

The plugin runs right on the till, in iikoFront 8.x. No extra hardware, no tablets at the counter.

#### Internet required

The till needs internet access to reach Nearily. Settings are cached, so a brief outage does not break the button.

#### Button missing?

Most often: the folder is in the wrong place, config.json is missing or has a typo, or iikoFront was not restarted. Details are in the iikoFront log (Front.Net\\Logs).

#### Updates itself

The plugin checks for updates and downloads a new version in the background. It takes effect the next time iikoFront starts — no need to interrupt a shift. If the till runs for weeks without a restart, the entry dialog’s title says an update is ready: the file is already on the till, waiting for a convenient moment.

#### The updates screen

Tap “Nearily” on the order screen and type 000000 on the “Code or phone” tab. The plugin shows the running version, any downloaded update, and offers to check for updates right now. Guest codes are always 4 digits, so there is nothing to confuse it with.

#### Support

Stuck on anything? Write to hello@nearily.com — we help with the install and the setup.

### Questions about the iiko plugin

#### How much does the plugin cost?

The plugin is a free download. The Free plan for cafés costs nothing, forever. Cafe Pro is 999 ₽ ($11) a month and Cafe Ultra 1,999 ₽ ($22) a month — Cafe Ultra includes the iiko integration at no extra cost. All prices: nearily.com/pricing.

#### Which iikoFront version does it need?

The plugin runs right on the till, in iikoFront 8.x.

#### Does the till need internet?

Yes: the till reaches Nearily over the internet. Settings are cached, so a brief outage does not break the button.

#### Do I need extra hardware?

No. The plugin lives inside iikoFront — no tablets or separate devices at the counter.

#### How does a guest get a stamp or cashback?

The barista taps the Nearily button on the order screen and enters the guest’s 4-digit code or phone number, or uses the QR — the visit counts. When a reward is due, the till offers it and it lands on the order as a discount.

#### How is the plugin updated?

By itself: it checks for updates and downloads the new version in the background, and the version takes effect the next time iikoFront starts.

[Nearily for cafés](https://nearily.com/for-cafes) · [Pricing](https://nearily.com/pricing)

### Want to connect your cafe?

Write to us — we set the cafe up, help with the install and issue the till’s settings.

[Write to us](https://nearily.com/for-cafes#apply)
