Bankkártyás fizetés SumUp Solo eszközzel („SumUp Reader“ termináltípus)¶

A SumUp Solo egy kártyaolvasó, amely saját maga csatlakozik az internethez WLAN-on vagy mobilhálózaton keresztül. A DiKAS a SumUp felhőn keresztül vezérli: a pénztár elküldi az összeget a SumUp-nak, az összeg megjelenik a Solo eszközön, a vendég fizet – és a DiKAS könyveli a fizetést, amint a SumUp megerősíti. Nincs szükség IP-címre, hardverügynökre vagy routerbeállításra. Ez az oldal a SumUp hozzáférési adataitól az első tesztfizetésig vezeti végig, és elmagyarázza, mire kell figyelni sztornónál, borravalónál és napi zárásnál.

Támogatott eszközök¶

Eszköz	Csatlakoztatás a DiKAS-ban	Állapot
SumUp Solo (WLAN/mobilhálózat)	SumUp Reader termináltípus, párosítás párosítókóddal a SumUp felhőn keresztül	✅ Támogatott
Több Solo egy SumUp-fiókhoz	Eszközönként külön terminál a DiKAS-ban	✅ Támogatott
SumUp Air (Bluetooth)	—	❌ Jelenleg nem támogatott
Telefon vagy táblagép mint kártyaolvasó (SumUp Tap to Pay)	—	❌ Jelenleg nem támogatott

Ha telefont vagy táblagépet szeretne kártyaolvasóként használni, a DiKAS más megoldásokat kínál, például a Softpay megoldást. Hogy melyik megoldás illik az üzletéhez, azt a Hardver → Bankkártya-terminálok áttekintés mutatja.

Országok és pénznem

Hogy a SumUp hol kínálja és aktiválja a Solo eszközt, azt a SumUp határozza meg. A DiKAS abban a pénznemben könyvel, amely a SumUp fülön meg van adva (például EUR vagy CHF). Ha a mező üres, az üzlet fő pénzneme érvényes.

Előfeltételek¶

Egy beállított, a SumUp által aktivált kereskedői fiók.
Egy SumUp Solo internet-hozzáféréssel (WLAN, opcionálisan mobilhálózat – a mobilhálózatot a SumUp külön aktiválja).

Négy adat a SumUp-fiókból:

Adat	Mi ez	Mező a DiKAS-ban
API-kulcs	Titkos kulcs, `sup_sk_` kezdetű	API-kulcs
Merchant Code	A kereskedői fiók azonosítója, pl. `MXXXXXXX`	Merchant Code
Affiliate Key	Kulcs az alkalmazás hozzárendeléséhez	Affiliate Key
App-ID	Az alkalmazásazonosító, amelyet az Affiliate Key létrehozásakor a SumUp-nál megadtak	Affiliate App-ID

Egy felhasználó, aki hozzáfér az Adminisztráció → Beállítások menühöz.
Az eszköz állapotának megjelenítéséhez a DiKAS-ban: Solo firmware 3.3.39.0 vagy újabb. Egy megszakított fizetés szabályos lezárásához a Solo eszközön: 3.3.28.0 vagy újabb. A régebbi firmware továbbra is működik, csak ezek nélkül a kiegészítő funkciók nélkül.

Az Affiliate Key és az App-ID összetartozik

A Solo eszközön történő fizetéshez az Affiliate Key és az Affiliate App-ID teljes egészében meg kell legyen adva. Az App-ID sem nem Merchant Code, sem nem terminál- vagy olvasóazonosító, hanem pontosan az az érték, amellyel az Affiliate Key-t a SumUp-nál létrehozták. A Solo puszta párosításához az Affiliate Key-re nincs szükség, minden fizetéshez viszont igen.

Hol található a SumUp-fiókban?

Az API-Key és az Affiliate Key a SumUp fejlesztői területén (developer.sumup.com) hozható létre. Az App-ID-t ilyenkor rögtön jegyezze fel.

Beállítás 7 lépésben¶

Tartsa be a sorrendet

A SumUp fül a beállításokban csak azután jelenik meg, hogy egy SumUp Reader típusú terminált elmentettek. Ezért a terminál áll az elején. Ha a fül ezután nem jelenik meg azonnal, töltse újra egyszer az oldalt.

Terminál létrehozása: nyissa meg az Adminisztráció → Beállítások → Hardver → Fizetési lehetőségek menüt, és válassza a Terminál hozzáadása lehetőséget.
Adjon meg egy egyértelmű nevet (például „Solo pult 1“), a Típus mezőnél válassza a SumUp Reader bejegyzést, majd kattintson a Mentés gombra. A A terminálnak saját nyomtatója van opciót a DiKAS ilyenkor maga kapcsolja ki – a Solo nem nyomtat, a kártyabizonylatot a pénztár nyomtatja.
Hozzáférési adatok megadása: nyissa meg az Adminisztráció → Beállítások → Hardver → SumUp menüt. Adja meg az API-kulcs, a Merchant Code, az Affiliate Key, az Affiliate App-ID és a Pénznem értékét. Kattintson jobbra fent a Mentés gombra, és várja meg a „SumUp-konfiguráció mentve“ üzenetet. Az API-Key titkosítva tárolódik, és többé nem jelenik meg; ezután a mezőnél csak „(beállítva)“ áll.
A Solo csatlakoztatása a WLAN-hoz: kapcsolja be a Solo eszközt. Ha még be van jelentkezve egy SumUp-fiókba, jelentkezzen ki a Settings → About → Log out menüponttal – egy bejelentkezett eszköz nem párosítható. Ezután a felső menüben nyissa meg a Connections → Wi-Fi pontot, válassza ki az üzlet WLAN-ját, és adja meg a jelszót.
Párosítókód létrehozása: a Solo eszközön a felső menüben válassza a Connections → API → Connect pontot. Az eszköz megjelenít egy párosítókódot, amely csak kb. 5 percig érvényes. A kód 8 vagy 9 jegyű.
Párosítás a DiKAS-ban: a Hardver → Fizetési lehetőségek menüben a terminál sorában kattintson az Olvasó párosítása gombra (kapcsolat ikon). A „SumUp-olvasó párosítása“ ablakban adja meg a kódot, és válassza a Párosítás lehetőséget. A DiKAS a párosítás előtt elmenti a terminált, meghívja a SumUp-ot, és a SumUp által kiosztott Reader-ID-t maga írja be az azonos nevű mezőbe. Ezután megjelenik az „Olvasó párosítva és mentve: …“ üzenet.
Ellenőrzés: a terminál sorában válassza az Állapot ellenőrzése (WiFi ikon) lehetőséget. A zöld azt jelenti: párosítva és online. Ezután végezzen egy kis tesztfizetést – az összegnek meg kell jelennie a Solo eszközön, és sikeres fizetés után a DiKAS lezárja a nyugtát.

Frissítés után

Ha a DiKAS-t éppen frissítették vagy újraindították, egy fizetés tesztelése előtt töltse újra egyszer az oldalt, és ellenőrizze a SumUp-adatokat.

Hálózat

A Solo a kapcsolatot kifelé építi fel (titkosítva, 443-as port). Egy vendég-WLAN is elegendő, amíg van internet. Bejelentkezési oldalt (captive portal) vagy szigorúan szűrő WLAN-t a Solo nem tűr – ilyenkor használjon másik WLAN-t vagy mobilhálózatot. Ha WLAN és mobilhálózat is elérhető, a Solo a WLAN-t használja. A pénztárnak és a Solo eszköznek nem kell ugyanabban a hálózatban lennie, mindkettőnek csak internetre van szüksége.

A Solo már párosítva van a SumUp-fiókban?

Ha a Solo már párosítva van a SumUp-fiókban, a Reader-ID-ja közvetlenül is beírható a terminálsor Reader-ID mezőjébe. A széleken lévő szóközöket a DiKAS mentéskor eltávolítja.

Több Solo és több pénztár¶

Egy SumUp-fiókhoz több Solo párosítható, és ezek egyszerre is feldolgozhatnak fizetéseket:

A hozzáférési adatokat csak egyszer adja meg a SumUp fülön – ezek a fiók összes Solo eszközére érvényesek.
Minden Solo eszközhöz hozzon létre külön terminált a Hardver → Fizetési lehetőségek menüben (SumUp Reader típus, egyértelmű név, pl. „Solo terasz“), és párosítsa egyenként az összes Solo eszközt. A párosítókódot mindig frissen, az adott eszközön hozza létre.
Terminál hozzárendelése a pénztárhoz:
- központilag munkahelyenként az Adminisztráció → Beállítások → Üzemeltetés → Munkahelyek alatt, a Kártyaterminál mezőben (a fül csak akkor jelenik meg, ha a munkahelyek aktívak), vagy
- közvetlenül az eszközön, a pénztárbeállítások Terminál mezőjében (választható: Alapértelmezett (név), egy adott terminál vagy -- Nincs terminál --).
Választás minden fizetésnél: ha egy eszközön több kezelő több terminálon osztozik, a pénztárbeállításokban a Terminál kiválasztása minden bankkártyás fizetésnél opció a fizetés elé egy választást illeszt. A Felkínálás a választékban beállítással határozható meg, mely terminálokat kínálja fel ez az eszköz. A beállítás csak az adott eszközre érvényes.
Minden Solo eszköznél végezze el az Állapot ellenőrzése lépést és egy kis tesztfizetést, és ellenőrizze, hogy az összeg a megfelelő Solo eszközön jelenik-e meg.

Saját választás nélkül egy eszköz az üzlet alapértelmezett termináljával fizettet. Több pénztár osztozhat egy Solo eszközön; a Solo azonban egyszerre mindig csak egy fizetést fogad. Ahol egyidejűleg fizettetnek, ott minden munkahelyhez saját Solo tartozik.

Minden Solo eszköznek saját Reader-ID kell

Ha egy terminálbejegyzést lemásolnak, az átveszi az eredeti Reader-ID-ját – ekkor két pénztár ugyanazt a Solo eszközt szólítaná meg. A DiKAS ezt ennek ellenére elmenti, de mentés után megjeleníti a „Ugyanaz a SumUp Reader-ID több terminálnál is meg van adva …“ megjegyzést, és az Állapot ellenőrzése egy sárga figyelmeztető ikont mutat ezzel a kiegészítéssel: „A Reader-ID a(z) … terminálnál is meg van adva“. A lemásolt terminálnál párosítsa újra a Solo eszközt.

Így zajlik egy fizetés¶

Fizetéskor válassza a kártyás fizetést. Több terminál esetén először válassza ki a terminált.
A Bankkártyás fizetés párbeszédablak felül megnevezi a terminált, és a „Feldolgozás folyamatban…“ üzenetet mutatja a „Kérjük, érintse a kártyát a terminálhoz, vagy helyezze be“ megjegyzéssel. Ezzel egy időben az összeg megjelenik a Solo eszközön.
A vendég a Solo eszközhöz érinti a kártyát, behelyezi, vagy megadja a PIN-kódot. A DiKAS kb. 2 másodpercenként kérdezi le az eredményt a SumUp-tól, legfeljebb 120 másodpercig.
Siker esetén a párbeszédablak a „Sikeres fizetés“ üzenetet mutatja a tranzakcióazonosítóval; a DiKAS könyveli a fizetést, és lezárja a nyugtát. Ha a fizetést elutasítják, a párbeszédablak a „A fizetés elutasítva“ üzenetet jeleníti meg.

Kártyabizonylat: a Solo eszköznek nincs saját nyomtatója. Ha a A terminálnak saját nyomtatója van opció ki van kapcsolva (a DiKAS létrehozáskor így állítja be), a pénztár a kártyabizonylatot a nyugtára nyomtatja.

Borravaló: a Solo eszközön megadott borravalót a SumUp nem jelzi vissza a pénztárnak. Ezért a borravalót a pénztárnál rögzítse, mielőtt elindítja a kártyás fizetést.

Megszakítás vagy időtúllépés: ha a pénztár megszakítja a fizetést, vagy lejár a várakozási idő, a DiKAS lezárja a műveletet a Solo eszközön (3.3.28.0 vagy újabb firmware esetén), és még egyszer lekérdezi az eredményt a SumUp-tól. Ha a fizetés ugyanabban a pillanatban mégis sikerült, a DiKAS könyveli – a kártyát tehát soha nem terhelik meg úgy, hogy ne keletkezne nyugta. Ha az összeg ennek ellenére a Solo eszközön marad (például mert a Solo éppen offline), ellenőrizze a SumUp irányítópulton, hogy a fizetés sikerült-e.

Sztornó, jóváírás és napi zárás¶

Művelet	Így működik a SumUp-pal
Kártyás fizetéssel rendelkező nyugta sztornózása	Sztornózza a nyugtát a Menü → Számlák alatt. A DiKAS az eredeti SumUp-tranzakcióra hivatkozva téríti vissza az összeget a kártyára. Ha ez a hivatkozás hiányzik, a művelet egy látható tisztázandó esettel zárul, és semmi sem kerül könyvelésre.
Kártyás jóváírás eredeti fizetés nélkül	Nem lehetséges. A SumUp csak egy meglévő fizetésre térít vissza. A DiKAS ezt jelzi: „Hivatkozás nélküli kártyás jóváírás a SumUp-nál nem lehetséges – kérjük, a SumUp alkalmazáson/a SumUp irányítópulton keresztül térítse vissza.“ Másik megoldásként sztornózza az eredeti nyugtát.
Napi zárás / terminálzárás a terminálon	Elmarad. A DiKAS ezt jelzi: „A SumUp nem ismeri a terminálzárást – a kifizetések automatikusan történnek (SumUp irányítópult).“ A SumUp kifizetései a SumUp irányítópulton láthatók.

Bővebben a sztornókról és jóváírásokról: Fizetési módok és Bizonylatok.

Korlátok¶

Csak a SumUp Solo a SumUp felhőn keresztül; a Bluetooth-olvasók és a telefon mint kártyaolvasó nem tartoznak ehhez a megoldáshoz.
Internet a pénztárnál és a Solo eszközön kötelező – internet nélkül ezen a terminálon nincs kártyás fizetés.
Nincs kártyás jóváírás eredeti fizetés nélkül, nincs terminálzárás az eszközön.
Az eszközön megadott borravaló nem kerül át a pénztárba.
Egy fizetés legfeljebb 120 másodpercig vár az eredményre.
Az összeget a rendszer két tizedesjegyre kerekíti (CLP, COP és HUF esetén tizedesjegyek nélkül), és nagyobbnak kell lennie 0-nál.

Hibák és elhárításuk¶

Amit lát	Ok és megoldás
„SumUp-hozzáférés elutasítva: kérjük, ellenőrizzen egy aktív API Secret Key kulcsot (sup_sk_…) a SumUp kereskedői fiókban.“	Az API-Key érvénytelen, visszavonták, vagy nem titkos kulcs. A SumUp fejlesztői területén ellenőrizzen egy aktív kulcsot (`sup_sk_…`), majd adja meg újra a SumUp fülön, és mentse.
„A megadott SumUp API-kulcs olyan karaktert tartalmaz, amely nem továbbítható …“	Másoláskor egy nem törhető szóköz vagy speciális karakter is bekerült. Illessze be újra a kulcsot a SumUp fülön.
„SumUp hiba: BadRequest“ párosításkor	A SumUp elutasította a kérést – többnyire a párosítókód lejárt vagy hibás. A Solo eszközön indítsa újra a Connections → API → Connect pontot, és azonnal adja meg az új kódot.
A párosítókódot a rendszer nem fogadja el	A kód csak kb. 5 percig érvényes, vagy a Solo még be van jelentkezve. A Solo eszközön jelentkezzen ki a Settings → About → Log out menüponttal, indítsa újra a Connections → API → Connect pontot, és azonnal párosítson a DiKAS-ban.
„A(z) … SumUp terminál nincs konfigurálva (hiányzik az API-kulcs/Merchant Code a beállításokban vagy a Reader-ID a terminálnál).“	A SumUp fülön hiányzik az API-Key vagy a Merchant Code, vagy a terminálnak nincs Reader-ID-ja, mert még nem párosították. Egészítse ki az adatokat, mentse, és párosítsa a Solo eszközt.
„Hiányzik a SumUp Affiliate Key és az Affiliate App-ID …“	Adja meg mindkét értéket a SumUp fülön, kifejezetten kattintson a Mentés gombra, és csak ezután fizettessen.
„A(z) … SumUp terminál nem található.“	A terminált nem mentették, vagy törölték. A Hardver → Fizetési lehetőségek alatt ellenőrizze a nevet és a típust, mentse, és párosítsa újra.
„A(z) … olvasó nem található.“ (Állapot ellenőrzése)	A Reader-ID nem tartozik a SumUp-fiókhoz. Ellenőrizze a megadott azonosítót, vagy párosítsa újra a Solo eszközt.
„A párosítás lejárt – párosítsa újra az olvasót …“	A párosítókódot túl későn erősítették meg. Hozzon létre új kódot a Solo eszközön, és párosítson újra a DiKAS-ban az Olvasó párosítása gombbal.
„A párosítás az eszközön még nincs megerősítve – erősítse meg a párosítókódot a Solo eszközön, majd ellenőrizze újra.“	A párosítás elindult, de a Solo eszközön nem fejeződött be. Erősítse meg a kódot az eszközön, majd kattintson az Állapot ellenőrzése gombra.
„Az olvasó offline – ellenőrizze a WLAN-t a Solo eszközön (Connections → Wi-Fi).“	A Solo eszköznek nincs internetkapcsolata. Ellenőrizze a Solo eszközön, hogy a WLAN csatlakozik-e (internethez, nem csak a hálózathoz), és szükség esetén indítsa újra az eszközt. Ezután kattintson az Állapot ellenőrzése gombra.
„SumUp hiba: UnprocessableEntity“ fizetéskor	A SumUp elutasítja a kérést, például mert a Solo offline. Kattintson az Állapot ellenőrzése gombra, ellenőrizze a WLAN-t a Solo eszközön, és indítsa újra a fizetést.
„SumUp: időtúllépés – nincs válasz az olvasótól.“	120 másodperc után sem érkezett eredmény. Ellenőrizze a Solo eszközt és az internetet. Ha a vendég mégis fizetett, a DiKAS az utólagos ellenőrzésnél maga könyveli a fizetést; kétség esetén az újbóli fizettetés előtt nézze meg a SumUp irányítópulton.
„SumUp fizetés: FAILED.“ (EXPIRED, CANCELLED is)	A Solo befejezte a műveletet, például mert a kártyát elutasították, vagy lejárt az idő. Indítsa újra a fizetést, szükség esetén másik kártyával.
„SumUp: a fizetés megszakítva.“	A pénztár megszakította a fizetést. A művelet a Solo eszközön lezárul; szükség esetén indítsa újra a fizetést.
Az összeg a rossz Solo eszközön jelenik meg	A munkahelyhez vagy az eszközhöz másik terminál van rendelve. Javítsa az Üzemeltetés → Munkahelyek → Bankkártya-terminál alatt, illetve a pénztárbeállítások Terminál mezőjében.
Sárga figyelmeztető ikon: „A Reader-ID a(z) … terminálnál is meg van adva“	Két terminál osztozik egy Reader-ID-n. Az egyiket párosítsa újra a saját Solo eszközével.
Az állapot zöld, de nincsenek adatok az akkumulátorról vagy a firmware-ről	A Solo eszközön 3.3.39.0 előtti firmware fut. A fizetés működik; csak a kiegészítő adatok hiányoznak. Frissítse a firmware-t a Solo eszközön.

Biztonság

A titkos API-Key kulcsot a DiKAS titkosítva tárolja. A hozzáférési adatokat ne továbbítsa e-mailben vagy üzenetküldőn, és feltételezett elvesztés esetén vonja vissza őket a SumUp-fiókban.

Következő lépés¶

→ Fizetési módok és bankkártyás fizetés – a folyamat a pénztárnál, sztornó és jóváírás → Hardver → Bankkártya-terminálok – az összes kártyás fizetési megoldás áttekintése