API võtme aktiveerimine ja teenustekoodide lisamine

API võti võimaldab ühendada Stebby sinu kassa-, broneerimis- või müügisüsteemiga (näiteks Mobi, Noom, CompuCash, Booklux jt).

NB! API võtit saab kasutada vaid Teenusepakkuja kontol, mille pakett on Standard või Gold.

Kuidas aktiveerida API võti?

1. Logi sisse oma Teenusepakkuja kontole.
2. Ava Müük ja teenused → Müügikohad.
3. Vali soovitud müügikoht ning klõpsa Muuda müügikohta.
4. Suundu lehekülje lõppu ja aktiveeri valik API võti on aktiveeritud.
5. Sisesta kasutatava kassa-, broneerimis- või müügisüsteemi nimi (näiteks CompuCash, Noom, Mobi, Booklux…).
6. Vajuta + märgile, et luua uus API võti.

Kui sul on juba varasemalt loodud API võti, soovitame uuele võtmele lisada nime lõppu aastaarvu (näiteks „CompuCash 2026“), et erinevaid võtmeid oleks lihtsam eristada. Pärast uue võtme edukat integreerimist soovitame vana võtme eemaldada.

Nupu Näita võtmeid alt näed kõiki oma müügikohaga seotud API võtmeid.

Millist ostu autentimisviisi kasutada?

API V4 toetab kahte erinevat kasutusviisi.

Token (soovitatav veebimüügiks)

Token-põhine lahendus on mõeldud veebipoodidele ja iseteeninduskeskkondadele.

Kasutaja tuvastatakse turvaliselt Stebby kaudu ning kasutaja annab sinu süsteemile loa enda nimel Stebby tehinguid sooritada. Selle tulemusena ei pea kasutaja sisestama oma isikukoodi sinu veebilehele ja Teenusepakkuja ei pea hoidma tundlikke isikuandmeid oma süsteemis.

Token-lahendus võimaldab:

• turvalist kasutaja tuvastamist;
• Stebby vahendite kasutamist otse ostukorvis;
• vajadusel kombineerida Stebby makset ja lisatasu veebipoe poolel;
• vältida piletikoodide või sooduskoodide käsitsi sisestamist;

Täpsemalt saad lugeda: Identification flow

EST_PIN (kassasüsteemidele)

EST_PIN on mõeldud füüsiliste kassasüsteemide jaoks, kus kassapidaja otsib klienti isikukoodi alusel otse kassast.

See funktsionaalsus ei ole uutel API võtmetel vaikimisi aktiveeritud. Kui soovid kasutada kasutajate otsimist kassasüsteemist, kirjuta meile aadressil info@stebby.eu.

Kuidas lisada teenusekoode?

Pärast liidestuse seadistamist tuleb igale müüdavale teenusele lisada kassasüsteemi teenusekood.

1. Ava Teenusepakkuja kontol Müük ja teenused → Müügikohad.
2. Vajuta vastava müügikoha juures nupule Muuda müügikohta ja seejärel avanenud vaates nupule Halda müügikoha teenuseid.
3. Sisesta teenuse reale kassasüsteemi poolt antud kood väljale API kood.
4. Veendu, et koodi ees ega taga ei oleks tühikuid.
5. Salvesta iga kood eraldi rea lõpus oleva rohelise linnukese abil.

Pärast teenusekoodide salvestamist saab kassasüsteemist müüa teenuseid vastavalt määratud koodidele.

Kuidas leida tehnilist dokumentatsiooni?

API dokumentatsioon ja tehnilised juhendid arendajatele on leitavad Stebby API dokumentatsioonist.

Kui vajad EST_PIN õigusi või abi seadistamisel, võta ühendust aadressil info@stebby.eu.