Szoftver 3D biztonságos integrációs útmutató Dokumentáció
Integrációs útmutató 3D Secure
01.01.2021-től a kétfaktoros hitelesítést kötelező követelményként alkalmazzák minden e-kereskedelmi kártyás fizetési tranzakció esetében. E kötelezettség teljesítése érdekében a
a hitelkártya-hálózatok üzemeltetői az úgynevezett 3D Secure eljárást alkalmazzák. Önnek, mint kereskedőnek kötelező, hogy ezt az eljárást az ügyfelektől kezdve elvégezhesse
01.01.2021. Az alábbiakban megtalálhatja az integráció különféle módjainak leírását és azt, hogy miként kell a 3D Secure eljárást megvalósítani számukra.
Kérjük, válassza ki a használt integrációs módszert
- A hCO fizetési űrlapot használja?
- A hPF fizetési űrlapot használja?
- Feldolgozza a kifizetéseket az Unzer rendszer által biztosított űrlap használata nélkül?
Kérjük, vegye figyelembe: Fontos az is, hogy milyen módon történjen terhelés vagy előzetes engedélyezés (fenntartás). Még akkor is, ha a kártya adatainak regisztrálásához az Unzer GmbH fizetési űrlapját használja, a 3D Secure folyamat pénztár nélkül történik, amikor a kártya adatait először terhelik meg vagy engedélyezik. Ebben az esetben az Unzer által biztosított űrlap nélküli integráció harmadik módja érvényes.
Kérjük, vegye figyelembe még:
Ismétlődő fizetések (előfizetéses fizetések) használata esetén olvassa el a „3D biztonságos és visszatérő fizetés” című részt.
3D Secure eljárás a hCO checkout űrlap használatakor
A hCO checkout űrlapot már a 3D Secure eljáráshoz tervezték. Az eljárás végrehajtásához az Ön részéről nincs szükség további intézkedésre. Te azonban
meg kell győződnie arról, hogy rendszere képes kezelni fizetési rendszerünk megfelelő válaszait arra az esetre, ha a 3D Secure folyamat elindulna. Az aszinkron válaszban a
fizetési rendszert a szerverére, a tranzakció eredményét továbbítják, és ott azt ki kell értékelni a visszaküldés előtt URL továbbítják a fizetési rendszerbe.
Ebből a célból a következő paramétereket kell értékelni.
- FELDOLGOZÁS.RETURN.CODE = 000.200.000
- PROCESSING.RETURN = Tranzakció + függőben van
- FELDOLGOZÁS.RESULT = ACK
Magyarázat: A tranzakció állapota „függőben van”, a PROCESSING.RESULT paraméter
csak előzetes eredményt képvisel. Amíg a 3D Secure folyamat végrehajtásra kerül, az állapot
függőben maradnak.
A tranzakció végeredménye akkor is
- FELDOLGOZÁS.RETURN.CODE = 000.000.000
- FELDOLGOZÁS.RESULT = ACK
or - PROCESSING.RETURN.CODE = irgendein 000.000.000 000.200.000 XNUMX XNUMX XNUMX XNUMX
- FELDOLGOZÁS.RESULT = NOK
Az első esetben a tranzakció sikeresen lezárult, a második esetben összességében kudarcot vallott. Ez utóbbinak különféle okai lehetnek, beleértve a hitelesítés megtagadását. Fogsz
részletesebb információkat a „FELDOLGOZÁS.RETURN” és a „FELDOLGOZÁS.RETURN.CODE” paraméterekben kap.
Javasoljuk, hogy futtasson tesztet mindkét üzenetre. Az alábbiakban további információkat talál a teszt elvégzéséről és a hitelkártya adatairól.
3D Secure eljárás a hPF fizetési űrlap használatakor
A hPF fizetési űrlap szintén a 3DS eljárás használatára készült. Az eljárás végrehajtásához az Ön részéről nincs szükség további intézkedésre. A leírás szerint
a hCO megvalósításához a fizetési rendszer válasza két lépésben történik, ezért a rendszernek ellenőriznie kell a PROCESSING.RETURN.CODE értékét
paraméter a válasz feldolgozásakor.
Ebből a célból a következő paramétereket kell értékelni.
- FELDOLGOZÁS.RETURN.CODE = 000.200.000
- PROCESSING.RETURN = Tranzakció + függőben van
- FELDOLGOZÁS.RESULT = ACK
Magyarázat: A tranzakció állapota „függőben van”, a PROCESSING.RESULT paraméter csak előzetes eredményt képvisel. Amíg a 3D Secure folyamat végrehajtásra kerül, az állapot
függőben maradnak.
A tranzakció végeredménye akkor is
- FELDOLGOZÁS.RETURN.CODE = 000.000.000
- FELDOLGOZÁS.RESULT = ACK
or - PROCESSING.RETURN.CODE = irgendein 000.000.000 000.200.000 XNUMX XNUMX XNUMX XNUMX
- FELDOLGOZÁS.RESULT = NOK
Az első esetben a tranzakció sikeresen lezárult, a második esetben összességében kudarcot vallott. Ez utóbbinak különféle okai lehetnek, beleértve a hitelesítés megtagadását. Fogsz
részletesebb információkat a „FELDOLGOZÁS.RETURN” és a „FELDOLGOZÁS.RETURN.CODE” paraméterekben kap.
Javasoljuk, hogy futtasson tesztet mindkét üzenetre. Az alábbiakban további információkat talál a teszt elvégzéséről és a hitelkártya adatairól.
3D Secure eljárás közvetlen csatlakozással
Ha nem az Unzer (korábban heidelpay) által biztosított fizetési űrlapot használja a hitelkártyás fizetések feldolgozásához, vagy ha egyszerűen regisztrál egy kártyát az egyik űrlap használatával, és az előzetes engedélyezést (foglalást) vagy terhelést dolgozza fel a regisztráció hivatkozásaként, közvetlen kommunikáció a fizetési rendszerrel, akkor meg kell valósítania a 3D Secure folyamatot.
Aszinkron tranzakciós folyamat:
Ez egy aszinkron folyamat, amelyben a szerver továbbítást fogad URL (Átirányítás URL) fizetési rendszerünkből. A szervernek erre kell továbbítania az ügyfelet URL hogy a hitelesítést a 3D Secure eljárással végezhesse el. Ennek a 3D Secure hitelesítésnek az eredményét a kártyakibocsátó bank közvetlenül jelenti az Unzer felé.
A sikeres hitelesítést követően a tranzakciót az Unzer rendszer tovább feldolgozza az Ön által már ismert módon azáltal, hogy a rendszernek átfogó eredményt küld a rendszernek, amelyre válaszol
átirányítással URL. A fizetési rendszer ezt az átirányítást használva visszairányítja az ügyfelet a rendszerére URL a rendszer
Kérjük, vegye figyelembe: Ebben a munkafolyamatban a rendszere két választ kap a fizetési rendszertől:
- „Függőben” állapotú (FELDOLGOZÁS.RETURN.CODE = 000.200.000 és FELDOLGOZÁS.RETURN = Tranzakció + függőben) és az átirányítási paraméterek az ügyfél kártyakibocsátó bankjába
- Az egyik a terhelés vagy a foglalás végeredményével. Két átirányítás is létezik URLEbben a folyamatban megemlítettük az egyiket a fizetési rendszerből, ahová az ügyfelet át kell irányítani, hogy hitelesítsen a kártyakibocsátó banknál, és egyet a rendszeréből, amikor megkapja a végeredményt, hogy az ügyfelet visszairányítsa a rendszerébe.
A következő változtatásokat hajtják végre a szokásos eljárásban. Felhívjuk figyelmét, hogy más aszinkron fizetési módok, például a Paypal bevezetése miatt ezek egy része
folyamatok már létezhetnek a megvalósításban.
- Válasz URL
A fizetési rendszer első hívásában (a diagram 2. sz.) Egy „Válasz URL”Át kell adni a frontend csoportban.
Kérjük, vegye figyelembe: Az IDENTIFICATION.REFERENCEID paraméter csak akkor releváns, ha regisztrációra vagy más, már létező tranzakcióra hivatkozik - Átirányítás feldolgozása URL Ha hitelesítésre van szükség, irányítson át URL és az átirányítási csoport egyéb paramétereit továbbítja a fizetési rendszer válasza (a diagram 5. sz.).
- Az ügyfél továbbítása az átirányításhoz URL
Ha az átirányítási csoport átirányítással válaszol URL, az ügyfél böngészőjét erre kell átirányítani URL (6. sz. a diagramon) hitelesítés végrehajtásához. Az átirányítási csoport további paramétereit át kell vinni a külsőre webwebhelyet POST paraméterként.
Kérjük, vegye figyelembe: A „PROCESSING.REDIRECT.xxx” csoportban további paramétereket csak 3D Secure 1-es verzióval adunk vissza (még ott is változhat a szám és az elnevezés), míg a 3D-s 2-es verziónál csak a PROCESSING.REDIRECT.URL az alább látható módon tér vissza: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run Ez azt jelenti, hogy a paraméterek típusától és számától függetlenül az ügyfélböngészőnek át kell irányítania a PROCESSING.REDIRECT könyvtárba.URL.
Az alábbiakban egy egyszerű kódot találsz, plample, hogyan lehet végrehajtani egy ilyen átirányítást. Az rész célja, hogy tájékoztassa azokat a végfelhasználókat, akiknek rendszerei nem támogatják a Javascriptet, vagy le van tiltva. Nyomatékosan javasoljuk, hogy az átirányítást az ügyfél aktív böngészőablakon belül végezze el, és ne használjon felugró ablakokat vagy új böngészőablakokat, mivel ez
irritálja az ügyfeleket, és vezesse őket arra, hogy zárják be az átirányított oldalt.
- Aszinkron eredményellenőrzés
A hitelesítés eredményét aszinkron módon küldi el a szerver. A fizetési rendszer érvényesnek számít URL válaszként. (12. és 13. sz. Ábra). Sikeres vagy elutasított
fizetések, egy másik URL itt válaszolhat a rendszere. - Az ügyfél visszatérési útvonala
A fizetési rendszer átirányítja az ügyfelet a URL a kereskedő rendszere biztosítja, miután a hitelesítési folyamat és a fizetési tranzakció befejeződött.
Kérjük, vegye figyelembe: A 4. és 5. lépés pontosan ugyanúgy jár el, ahogyan Ön már ismeri a meglévő NONE 3D Secure tranzakciókat.
3D biztonságos és ismétlődő fizetés
1. január 2021-jétől a 3D Secure kötelező lesz minden e-kereskedelmi kártya tranzakcióhoz. Mivel azonban ez alig alkalmazható az ismétlődő fizetésekre, a banki
a rendszereknek külön munkafolyamatuk van erre.
Ebből a célból a bankok különbséget tesznek
- CIT = az ügyfél által kezdeményezett tranzakciók
- MIT = kereskedő inicializált tranzakciói
A kereskedői számláján lévő kártya első tranzakcióját 3-től a 01.01.2021D Secure segítségével kell hitelesíteni. Az ilyen sikeres hitelesítés kötelező követelmény a
annak érdekében, hogy később további foglalásokat nyújtson be ugyanazon a kártyán a 3D Secure nélkül. Az ügyfelet ezért az első terhelésre továbbítani kell a kártyakibocsátó bankjához
a fent leírt eljárásnak megfelelően, és ott kártyabirtokosként hitelesíti magát. Ha a megrendeléskor nincs betervezve terhelés, plampA próbaidőszak miatt legalább egy eurós foglalást (előengedélyezést) kell végrehajtani a 3D Secure szolgáltatással az ügyfél jelenlétében. Ennek a foglalásnak a rögzítése nem szükséges.
A meglévő ügyfelek számára azonban nem szükséges 3D Secure hitelesítést pótolni. Ha az első sikeres terhelésre 01.01.2021 előtt került sor, akkor az ügyfélrekord is feltételezhető
sikeresen hitelesítették. Új ügyfelek számára 01.01.2021-től viszont a 3D Secure hitelesítés kötelező az első terhelésnél vagy foglalásnál (előzetes engedélyezés).
Figyelem: Ebben a vonatkozásban a bankrendszer a kártyaadatokat nézi, nem az ügyféladatokat. Tehát ha egy meglévő ügyfél 01.01.2021. után új kártyát használ, plample mert az előző
az egyik lejárt, vagy mert megváltoztatta a kártyakibocsátó bankot, ez egy új, ismétlődő ciklus a bankok szempontjából view és az első foglaláskor hitelesíteni kell a 3D Secure szolgáltatással.
Miután ezt a kezdeti hitelesítést sikeresen végrehajtották, minden további tranzakció mentesül a 3D Secure használatának kötelezettsége alól. A 3D Secure nélküli ismétlődő fizetés előfeltételei tehát:
- Legalább egy sikeres terhelés vagy foglalás (előzetes engedélyezés) létezik, amelyet vagy a 3D Secure segítségével hajtottak végre, vagy pedig 01.01.2021. XNUMX. XNUMX-je előtt történt.
- benyújtáskor meglévő regisztrációra és terhelésre hivatkoznak
Annak érdekében, hogy a fizetési rendszer tudassa, hogy ez ismétlődő fizetés, el kell küldeni a RECURRENCE.MODE = REPEATED paramétert is. Ez jelzi a rendszernek, hogy a
az ismétlődő fizetést be kell jelenteni a bankrendszereknek.
Kérjük, vegye figyelembe: Ha a RECURRENCE.MODE = REPEATED paramétert adja meg, amikor új kártyát tölt be először, akkor a 3D Secure továbbítás ennek ellenére is végrehajtásra kerül.
A 3D Secure megvalósításának tesztelése
Fizetési rendszerünkön keresztül bármikor tesztelheti a 3D Secure kapcsolatot. Ehhez használja a „CONNECTOR_TEST” módot egy tranzakcióhoz, amint az a példában láthatóamples fent.
A teszt csatlakozási adatai:
| BIZTONSÁG.KÜLDŐ | 31HA07BC8142C5A171745D00AD63D182 |
| BEJELENTKEZÉS | 31ha07bc8142c5a171744e5aef11ffd3 |
| FELHASZNÁLÓ.PWD | 93167DE7 |
| Tranzakció.csatorna | 31HA07BC8142C5A171749A60D979B6E4 |
| A 3. 2D-s verzióhoz konfigurált pénznemek | EUR, USD, SEK |
| A 3. 1D-s verzióhoz konfigurált pénznemek | GBP, CZK, CHF |
A rendszerátjáró végpontja bármelyik
SGW átjáró:
- https://test-heidelpay.hpcgw.net/sgw/gtw - Latin-15 kódolású
- https://test-heidelpay.hpcgw.net/sgw/gtwu - UTF-8 kódolású
NGW átjáró:
- https://test-heidelpay.hpcgw.net/ngw/post
Hitelkártya-adatok ehhez a teszthez:
| márkák | kártyaszámok | CVV | lejárati dátum | jegyzet |
| MasterCard | 5453010000059543 | 123 | jövőbeli dátum | 3D - jelszó: titok3 |
| Visa | 4711100000000000 | 123 | jövőbeli dátum | 3DS - jelszó: titok! 33 |
Kérjük, vegye figyelembe: A 3D Secure 2-es verzióhoz nem kell megadnia jelszót, csak egyszerűen kattintson a linkre ”Kattintson ide a hitelesítés befejezéséhez.
A 3D Secure 2-es verzióval a hiba szimulálásának egyetlen módja az, hogy a hivatkozással rendelkező oldal időtúllépést engedélyez (kb. 18 perc).
További információ erről a kézikönyvről és PDF letöltése:
Dokumentumok / Források
 |
Szoftverek 3D Secure Integration Guide [pdfDokumentáció Unzer, Integrációs útmutató, 3D Secure |
