Quote

SZÉP kártya elfogadási útmutató

This guide is currently available in Hungarian only.

1. Szerződéskötés a SZÉP kártya elfogadásról#

A SZÉP kártya elfogadás elsődleges feltétele, hogy a kereskedő az adott típusú SZÉP kártya elfogadója legyen. Ehhez a kibocsátó bankkal kell szerződnie, ebben segít a következő tájékoztató:SZÉP kártya elfogadási segédlet (PDF)

2. SZÉP kártya elfogadásának beállítása#

Miután a partner megkötötte a SZÉP kártya elfogadáshoz szükséges szerződéseket, a Paynance ügyfélszolgálatától kérheti a szolgáltatás bekapcsolását: support@paynance.hu

3. SZÉP kártya elfogadás#

Miután a partner megkötötte a szükséges szerződéseket, és a Paynance ügyfélszolgálata bekapcsolta a szolgáltatást, a kereskedő a következő módokon fogadhat SZÉP kártyás fizetést:

3.1. Webes megoldás#

A webes megoldás a következő API-készletet használja: SZEP API

A folyamat a következő lépésekből áll:

  1. A vásárló a kiválasztott termékek után a fizetési mód kiválasztó oldalra kerül.
  2. A kereskedő weboldala a GET /providers/{terminalReference} meghívásával lekéri az elfogadható SZÉP kártya típusokat, és felkínálja őket a vásárlónak.
  3. A vásárló kiválasztja a SZÉP kártya típusát.
  4. A kereskedő weboldala meghívja a POST /instant-payments végpontot, ahol megadja, hogy a vásárló a SZÉP kártyás fizetés után hova érkezzen vissza (responseUrl), majd a válaszban kapott URL-re (url) irányítja a vásárlót.
  5. A vásárló a fizetési oldalon megadja a kártyaadatait, és fizet.
  6. A vásárló a fizetés után a responseUrl paraméterrel megadott URL-re kerül, a TransactionId query paraméterrel.
  7. A kereskedő a GET /transactions/{reference} meghívásával lekéri a fizetés eredményét, és megjeleníti a vásárlónak.

3.2. Terminálon#

A support beállítását követően a SoftPOS alkalmazásban a többi fizetési mód mellett megjelenik a SZÉP kártyás fizetési mód is.

A folyamat a következő:

  1. A kereskedő kiválasztja a SZÉP kártyás fizetési módot.
  2. A megjelenő összegbeviteli képernyőn megadja a fizetendő összeget.
  3. Továbblépéskor az alkalmazás felajánlja, milyen típusú SZÉP kártyával történjen a fizetés. A vásárló kiválasztja a kártya típusát, és a következő képernyőn megjelenik a QR-kód.
  4. A vásárló a mobilja kamerájával leolvassa a QR-kódot, majd megnyitja a benne található linket, amely a kártyaadat-beviteli oldalra vezet. Itt a vásárló fizet, majd a fizetés után egy eredményoldalra jut.
  5. Közben a terminál is megkapja a fizetés eredményét, és az eredményképernyőn megjeleníti a kereskedőnek.
  6. Beállítástól függően a nyugta automatikusan vagy gombnyomásra nyomtatódik.

3.3. Terminálon API-on keresztül#

Ezt a megoldást a következő API-készlet kínálja: ECR API

A folyamat a következő lépésekből áll:

  1. A terminál a fizetési kérelemre vár.
  2. A kereskedő rendszere a GET /szep-providers/{terminalId} meghívásával lekéri, hogy a terminál mely SZÉP kártya típusokat tudja elfogadni.
  3. A vásárló elmondja, milyen típusú SZÉP kártyával szeretne fizetni.
  4. A kereskedő rendszere meghívja a POST /transactions/szep végpontot, ahol megadja, hogy a vásárló milyen típusú SZÉP kártyával szeretne fizetni (provider paraméter).
  5. A terminál fogadja a fizetési kérelmet, és megjeleníti a vásárlónak a QR-kódot.
  6. A vásárló a mobilja kamerájával leolvassa a QR-kódot, majd megnyitja a benne található linket, amely a kártyaadat-beviteli oldalra vezet. Itt a vásárló fizet, majd a fizetés után egy eredményoldalra jut.
  7. Közben a terminál is megkapja a fizetés eredményét, és az eredményképernyőn megjeleníti a kereskedőnek.
  8. Beállítástól függően a nyugta automatikusan vagy gombnyomásra nyomtatódik.
  9. Eközben a kereskedő rendszere a GET /transactions/szep/{reference} meghívásával lekéri a fizetés eredményét. Amíg a tranzakció PENDING állapotú, a végpontot ismételten meg kell hívni, amíg a fizetés sikeresnek vagy sikertelennek nem bizonyul.

3.4. Terminálon deeplinken keresztül#

Ezt a megoldást a következő deeplink-készlet kínálja:SoftPOS deeplink

A folyamat a következő lépésekből áll:

  1. A kereskedő alkalmazása felajánlja a vásárlónak a SZÉP kártyás fizetési módot, valamint az elfogadható kártyatípusokat. A vásárló választ.
  2. A kereskedő alkalmazása a szep deeplink segítségével átadja a vezérlést a SoftPOS alkalmazásnak.
  3. A terminál fogadja a fizetési kérelmet, és megjeleníti a vásárlónak a QR-kódot.
  4. A vásárló a mobilja kamerájával leolvassa a QR-kódot, majd megnyitja a benne található linket, amely a kártyaadat-beviteli oldalra vezet. Itt a vásárló fizet, majd a fizetés után egy eredményoldalra jut.
  5. Közben a terminál is megkapja a fizetés eredményét, és az eredményképernyőn megjeleníti a kereskedőnek.
  6. Beállítástól függően a nyugta automatikusan vagy gombnyomásra nyomtatódik.
  7. Végül a SoftPOS a fizetési kérelemben megadott alkalmazásba tér vissza a fizetés eredményével.