Kártyás elfogadási útmutató

3.1. Webes áthívásos megoldás#

A webes áthívásos megoldás a következő API-készletet kínálja: WEB Hosted API

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

1. 1.A vásárló a kiválasztott termékek után a fizetési mód kiválasztó oldalra kerül.
2. 2.Ha a vásárló a kártyás fizetést választja, akkor a kereskedő weboldala a POST /orders végpont meghívásával fizetési linket hoz létre, melyben megadja, hogy a vásárló hova legyen visszairányítva a vásárlás után (returnUrl), majd átirányítja a vásárlót a kapott linkre (paymentLink).
3. 3.A vásárló a kapott linkre kerül, ahol megadja a kártya adatait és fizet.
4. 4.A vásárló a fizetés után a returnUrl paraméterrel megadott URL-re kerül, a sessionResult és a sessionId query paraméterekkel.
5. 5.A kereskedő a sessionResult és a sessionId adatok segítségével meghívja a GET /sessions/{sessionId}/result végpontot, és a fizetés eredményét megjeleníti a vásárlónak.

3.2. Ismétlődő fizetés (Recurring / Tokenizáció)#

A webes áthívásos megoldás támogatja a kártyatokenizációt, amely lehetővé teszi a vásárló kártyaadatainak biztonságos tárolását és későbbi terhelését vásárlói interakció nélkül (pl. előfizetések, ismétlődő díjak).

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

1. 1.A kereskedő a POST /orders végpontot hívja meg az enableRecurring: true és a shopperReference paraméterekkel. A shopperReference egy egyedi vásárlóazonosító (pl. felhasználó ID a kereskedő rendszerében). Nem tartalmazhat személyes adatot (PII).
2. 2.A vásárló a szokásos módon fizet a hosted fizetési oldalon.
3. 3.A fizetés után a kereskedő a GET /transactions/{orderCode} végponttal lekéri a tranzakció adatait. Ha a tokenizáció sikeres volt, a válaszban megjelenik a recurring blokk a storedPaymentMethodId mezővel.
4. 4.A későbbi terhelésekhez a kereskedő a POST /recurring-charge végpontot hívja meg a storedPaymentMethodId és a shopperReference megadásával. Ez server-to-server hívás, nem igényel vásárlói interakciót.

3.3. Webes beágyazott megoldás#

A webes beágyazott megoldás a következő oldalon van részletezve: WEB In Site

3.4. Webhook értesítések a webes fizetésekről#

A webes fizetések állapotváltozásairól (authorizáció, capture, cancel, refund, chargeback) a Paynance szerver-szerver értesítést küld a kereskedő által megadott URL-re. Az értesítéseket HMAC-SHA256 aláírással küldjük, sikertelen kézbesítés esetén újrapróbálkozunk. A kézbesítések a kézbesítési naplóban követhetők. Így a fizetés eredménye akkor is megérkezik, ha a vásárló nem tér vissza a returnUrl-re.

A webhook a Paynance felületen, a Webshop beállítások → Webhook (fizetési értesítések) menüpontban kapcsolható be.

4.1. 3D Secure 2#

4.2. American Express (Amex)#

4.3. Maestro#

4.4. Mastercard#

4.5. Visa#

5.1. 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 bankkártyás fizetési mód is.

A folyamat a következő:

1. 1.A kereskedő kiválasztja a bankkártyás fizetési módot.
2. 2.A megjelenő összegbeviteli képernyőn megadja a fizetendő összeget.
3. 3.opcionális A vásárló megadja a borravaló összegét.
4. 4.A vásárló a kártyája vagy a telefonja készülékhez érintésével fizet.
5. 5.A fizetés után a vásárló egy eredményoldalra jut, ahol a nyugta gombnyomásra (opcionális: automatikusan) nyomtatódik.
6. 6.Végül a beállított idő eltelte után az alkalmazás visszaáll a fizetésimód-választó képernyőre.

5.2. 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. 1.A terminál a fizetési kérelemre vár.
2. 2.A kereskedő rendszere meghívja a POST /transactions/sale végpontot, ahol megadja a fizetendő összeget.
3. 3.opcionális A vásárló megadja a borravaló összegét. Ezt vagy a terminálon teszi meg, vagy a kereskedő rendszerében, és a kereskedő küldi el a terminálra a POST /set-tip-amount segítségével. Ha a kereskedő szabályozza, akkor a POST /done-tip-amount meghívásával jelzi a terminálnak, hogy a borravaló összegét megadták.
4. 4.A vásárló a kártyája vagy a telefonja készülékhez érintésével fizet.
5. 5.A fizetés után a vásárló egy eredményoldalra jut, ahol a nyugta gombnyomásra (opcionális: automatikusan) nyomtatódik.
6. 6.Végül a beállított idő eltelte után az alkalmazás visszaáll a fizetésimód-választó képernyőre.
7. 7.A kereskedő rendszere a GET /sessions/{sessionId} meghívásával lekéri a fizetés eredményét. Amíg a végpont 202-es HTTP-kóddal tér vissza, addig újra meg kell hívni. Végül a fizetés sikeresnek vagy sikertelennek bizonyul.

5.3. 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. 1.A kereskedő alkalmazása felajánlja a vásárlónak a bankkártyás fizetési módot, és a vásárló azt választja.
2. 2.Ekkor a kereskedő alkalmazása a sale deeplink segítségével átadja a vezérlést a SoftPOS alkalmazásnak.
3. 3.A SoftPOS alkalmazás megkapja a vezérlést.
4. 4.opcionális A vásárló megadja a borravaló összegét.
5. 5.A vásárló a kártyája vagy a telefonja készülékhez érintésével fizet.
6. 6.opcionális A fizetés után a vásárló egy eredményoldalra jut, ahol a nyugta gombnyomásra (opcionális: automatikusan) nyomtatódik.
7. 7.Végül a SoftPOS alkalmazás a fizetési kérelemben megadott alkalmazásba tér vissza a fizetés eredményével.