Softwares 3D Secure Integration Guide Dokumentácia
Sprievodca integráciou 3D Secure
Od 01.01.2021 bude dvojfaktorová autentifikácia implementovaná ako povinná požiadavka pre všetky platobné transakcie elektronického obchodu kartou. Na splnenie tejto povinnosti:
prevádzkovatelia sietí kreditných kariet použijú takzvaný postup 3D Secure. Pre vás ako obchodníka je povinná byť schopná vykonať tento postup pre vašich zákazníkov od
01.01.2021. V nasledujúcom texte nájdete popis rôznych spôsobov integrácie a spôsobu implementácie postupu 3D Secure.
Vyberte metódu integrácie, ktorú používate
- Používate pokladnícky formulár hCO?
- Používate pokladný formulár hPF?
- Spracovávate platby bez použitia formulára poskytnutého systémom Unzer?
Poznámka: Je tiež dôležité, akým spôsobom sa vykonávajú debety alebo predbežné autorizácie (rezervácie). Aj keď na registráciu údajov o karte použijete platobný formulár od spoločnosti Unzer GmbH, proces 3D Secure bude prebiehať bez platobného formulára, keď dôjde k prvému odpísaniu alebo autorizácii údajov z karty. V takom prípade platí tretí spôsob integrácie bez formulára poskytnutého Unzerom.
Upozorňujeme tiež:
Ak používate opakujúce sa platby (platby za predplatné), prečítajte si sekciu „3D bezpečná a opakovaná platba“.
Postup 3D Secure pri použití platobného formulára hCO
Formulár platby hCO je už navrhnutý pre postup 3D Secure. Na uskutočnenie postupu nie sú z vašej strany potrebné žiadne ďalšie kroky. Vy však
sa musíte uistiť, že váš systém dokáže spracovať zodpovedajúce odpovede nášho platobného systému v prípade, že je spustený proces 3D Secure. V asynchrónnej odozve od
platobný systém na váš server, prenesie sa výsledok transakcie a musí sa tam vyhodnotiť pred návratom URL sa prenáša do platobného systému.
Z tohto dôvodu musia byť vyhodnotené nasledujúce parametre.
- SPRACOVACÍ.NÁVRATNÝ KÓD = 000.200.000 XNUMX
- PROCESSING.RETURN = Transakcia + čaká na spracovanie
- PROCESSING.RESULT = AKT
Vysvetlenie: Stav transakcie je „nevybavený“, parameter PROCESSING.RESULT
predstavuje iba predbežný výsledok. Pokiaľ sa vykonáva proces 3D Secure, stav
zostávajú nevybavené.
Konečný výsledok transakcie je potom buď
- SPRACOVACÍ.NÁVRATNÝ KÓD = 000.000.000 XNUMX
- PROCESSING.RESULT = AKT
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 000.200.000 XNUMX alebo XNUMX XNUMX XNUMX XNUMX
- SPRACOVANIE. VÝSLEDOK = NOK
V prvom prípade bola transakcia úspešne dokončená, v druhom prípade celkovo zlyhala. Posledne uvedené môžu mať rôzne dôvody vrátane odmietnutia autentifikácie. Budeš
získať podrobnejšie informácie v parametroch „PROCESSING.RETURN“ a „PROCESSING.RETURN.CODE“.
Odporúčame vám spustiť test oboch správ. Ďalšie informácie o tom, ako vykonať test, a ktoré údaje o kreditnej karte môžete na test použiť, nájdete nižšie.
Postup 3D Secure pri použití platobného formulára hPF
Formulár platby hPF je tiež navrhnutý tak, aby už využíval postup 3DS. Na vykonanie postupu nie sú z vašej strany potrebné žiadne ďalšie kroky. Ako je opísané
pri implementácii hCO reakcia z platobného systému prebieha v dvoch krokoch, a preto musí váš systém skontrolovať hodnotu PROCESSING.RETURN.CODE
parameter pri spracovaní odpovede.
Z tohto dôvodu musia byť vyhodnotené nasledujúce parametre.
- SPRACOVACÍ.NÁVRATNÝ KÓD = 000.200.000 XNUMX
- PROCESSING.RETURN = Transakcia + čaká na spracovanie
- PROCESSING.RESULT = AKT
Vysvetlenie: Stav transakcie je „čakajúci“, parameter PROCESSING.RESULT predstavuje iba predbežný výsledok. Pokiaľ sa vykonáva proces 3D Secure, stav
zostávajú nevybavené.
Konečný výsledok transakcie je potom buď
- SPRACOVACÍ.NÁVRATNÝ KÓD = 000.000.000 XNUMX
- PROCESSING.RESULT = AKT
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 000.200.000 XNUMX alebo XNUMX XNUMX XNUMX XNUMX
- SPRACOVANIE. VÝSLEDOK = NOK
V prvom prípade bola transakcia úspešne dokončená, v druhom prípade celkovo zlyhala. Posledne uvedené môžu mať rôzne dôvody vrátane odmietnutia autentifikácie. Budeš
získať podrobnejšie informácie v parametroch „PROCESSING.RETURN“ a „PROCESSING.RETURN.CODE“.
Odporúčame vám spustiť test oboch správ. Ďalšie informácie o tom, ako vykonať test, a ktoré údaje o kreditnej karte môžete na test použiť, nájdete nižšie.
3D Secure postup s priamym pripojením
Ak na spracovanie platieb kreditnou kartou nepoužívate platobný formulár poskytnutý spoločnosťou Unzer (predtým heidelpay), alebo si kartu jednoducho zaregistrujete pomocou jedného z formulárov a spracujete predbežnú autorizáciu (rezerváciu) alebo debet ako odkaz na registráciu ako priama komunikácia s platobným systémom, musíte implementovať proces 3D Secure.
Tok asynchrónnych transakcií:
Toto je asynchrónny proces, v ktorom váš server prijíma preposielanie URL (Presmerovanie URL) z nášho platobného systému. Váš server musí k tomu zákazníka presmerovať URL aby mohol vykonať autentifikáciu pomocou postupu 3D Secure. Výsledok tejto autentifikácie 3D Secure nahlási banke, ktorá vydala kartu, priamo Unzer.
Po úspešnej autentifikácii sa transakcia ďalej spracuje v systéme Unzer spôsobom, ktorý už viete, tým, že na konci pošlete vášmu systému celkový výsledok, na ktorý odpoviete
s presmerovaním URL. Platobný systém potom pomocou tohto presmerovania presmeruje zákazníka späť do vášho systému URL z vášho systému
Poznámka: V tomto pracovnom postupe dostane váš systém dve odpovede z platobného systému:
- Jeden so stavom „čaká sa“ (PROCESSING.RETURN.CODE = 000.200.000 XNUMX a PROCESSING.RETURN = transakcia + čaká) a s parametrami presmerovania do banky, ktorá vydáva kartu zákazníka
- Jeden s konečným výsledkom debetu alebo rezervácie. Existujú aj dve presmerovania URLv tomto procese spomenutý, jeden z platobného systému, do ktorého musí byť zákazník presmerovaný, aby sa overil v banke vydávajúcej kartu, a jeden z vášho systému, keď dostane konečný výsledok, aby presmeroval zákazníka späť do vášho systému.
V pravidelnom postupe sa vykonajú nasledujúce zmeny. Upozorňujeme, že z dôvodu implementácie iných asynchrónnych platobných metód, napríklad Paypal, sú niektoré z nich
procesy už môžu vo vašej implementácii existovať.
- odpoveď URL
Pri prvom volaní (na schéme č. 2) platobnému systému sa zobrazí „Odpoveď URL”Musí byť odovzdané v skupine frontend.
Poznámka: Parameter IDENTIFICATION.REFERENCEID je relevantný, iba ak odkazujete na registráciu alebo inú už existujúcu transakciu - Spracovanie presmerovania URL Ak sa vyžaduje autentifikácia, presmerovanie URL a ďalšie parametre v skupine presmerovania sa prenášajú v odpovedi z platobného systému (na diagrame č. 5).
- Presmerovanie zákazníka na presmerovanie URL
Ak skupina presmerovania reaguje presmerovaním URL, musí byť na to presmerovaný prehliadač zákazníka URL (Č. 6 v diagrame) na vykonanie autentifikácie. Dodatočné parametre zo skupiny presmerovania je potrebné preniesť na externé webstránky ako parametre POST.
Poznámka: Ďalšie parametre sa vracajú do skupiny „PROCESSING.REDIRECT.xxx“ iba v prípade verzie 3D Secure verzie 1 (aj tam sa počet a názvy môžu líšiť), zatiaľ čo v prípade verzie 3D 2 iba verzie PROCESSING.REDIRECT.URL vracia sa, ako je zobrazené nižšie: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run To znamená, že bez ohľadu na typ a počet parametrov musí byť prehliadač klienta presmerovaný na PROCESSING.REDIRECT.URL.
Nasleduje jednoduchý kód example o tom, ako je možné také presmerovanie vykonať. The časť je určená na informovanie koncových zákazníkov, ktorých systémy nepodporujú Javascript alebo ho majú zakázaný. Dôrazne odporúčame, aby ste sa presmerovali v aktívnom okne prehliadača zákazníka a nepoužívali vyskakovacie okná ani nové okná prehliadača, pretože by to mohlo
dráždi zákazníkov a vedie ich k zatvoreniu stránky, na ktorú sú presmerovaní.
- Kontrola asynchrónnych výsledkov
Výsledok autentifikácie sa pošle asynchrónne na váš server. Platobný systém očakáva platnosť URL ako odpoveď. (Č. 12 a 13 na diagrame). Za úspešné alebo zamietnuté
platby, iný URL tu môže váš systém odpovedať. - Spätná cesta zákazníka
Platobný systém presmeruje zákazníka na internetovú stránku URL poskytnuté systémom obchodníka po dokončení procesu autentifikácie a platobnej transakcie.
Upozorňujeme: Kroky 4.) a 5.) pokračujte úplne rovnakým spôsobom, aký už poznáte pri existujúcich NONE 3D Secure transakciách.
3D bezpečná a opakujúca sa platba
Od 1. januára 2021 bude 3D Secure povinný pre všetky transakcie kartami elektronického obchodu. Avšak, pretože to je ťažko použiteľné pre opakujúce sa platby, bankovníctvo
systémy majú na to samostatný pracovný tok.
Na tento účel banky rozlišujú medzi
- CIT = transakcie iniciované zákazníkom
- MIT = transakcie inicializované obchodníkom
Prvá transakcia karty vo vašom účte obchodníka musí byť od 3 overená pomocou protokolu 01.01.2021D Secure. Takéto úspešné overenie je povinnou požiadavkou v
aby bolo možné následne vykonať ďalšie rezervácie na tej istej karte bez 3D Secure. Zákazník musí byť preto pri prvom debete v zaslaný do svojej banky vydávajúcej karty
v súlade s vyššie popísaným postupom a autentifikovať sa tam ako držiteľ karty. Ak debet nie je naplánovaný v čase objednávky, naprampkvôli skúšobnej lehote je potrebné namiesto toho vykonať 3D Secure v prítomnosti zákazníka rezerváciu (predbežnú autorizáciu) vo výške najmenej jedného eura. Zachytenie tejto rezervácie nie je potrebné.
Pre existujúcich zákazníkov však nie je potrebné vymýšľať žiadnu 3D Secure autentizáciu. Ak sa prvý úspešný debet uskutočnil pred 01.01.2021. januárom XNUMX, dá sa predpokladať, že sa jedná aj o záznam zákazníka
boli úspešne autentifikované. Pre nových zákazníkov je od 01.01.2021 naopak overenie 3D Secure povinné pri prvom debete alebo rezervácii (predautorizácia).
Vezmite prosím na vedomie: V tomto ohľade sa bankový systém pozerá na údaje o karte, nie na údaje o zákazníkovi. Ak teda existujúci zákazník použije novú kartu po 01.01.2021, naprample pretože predchádzajúci
Platnosť jednej z nich vypršala alebo pretože zmenil banku, ktorá vydala vašu kartu, sa jedná o nový opakujúci sa cyklus z pohľadu bánk. view a pri prvej rezervácii musí byť overená pomocou služby 3D Secure.
Po úspešnom vykonaní tejto počiatočnej autentifikácie sú všetky ďalšie transakcie vyňaté z povinnosti používať 3D Secure. Predpoklady pre opakované platby bez 3D Secure sú preto:
- Existuje aspoň jeden úspešný debet alebo rezervácia (predbežná autorizácia), ktoré sa uskutočnili pomocou programu 3D Secure alebo sa uskutočnili pred 01.01.2021. januárom XNUMX.
- odkazuje sa na existujúcu registráciu a debetuje sa po predložení
Aby platobný systém vedel, že ide o opakovanú platbu, je potrebné zaslať aj parameter RECURRENCE.MODE = REPEATED. Toto signalizuje systému, že a
opakované platby sa majú hlásiť bankovým systémom.
Upozornenie: Ak pri prvom vložení novej karty zadáte parameter RECURRENCE.MODE = REPEATED, bude sa napriek tomuto parametru vykonávať preposielanie 3D Secure.
Testovanie implementácie 3D Secure
Pripojenie 3D Secure si môžete kedykoľvek vyskúšať prostredníctvom nášho platobného systému. Ak to chcete urobiť, použite pri transakcii režim „CONNECTOR_TEST“, ako je to znázornené na príkladeamples vyššie.
Údaje o pripojení pre tento test:
| BEZPEČNOSŤ. ODOSIELATEĽ | 31HA07BC8142C5A171745D00AD63D182 |
| UŽÍVATEĽ. PRIHLÁSENIE | 31ha07bc8142c5a171744e5aef11ffd3 |
| USER.PWD | 93167DE7 |
| TRANSAKCIA.KANÁL | 31HA07BC8142C5A171749A60D979B6E4 |
| Meny nakonfigurované pre 3D verziu 2 | EUR, USD, SEK |
| Meny nakonfigurované pre 3D verziu 1 | GBP, CZK, CHF |
Koncový bod systémovej brány je buď
Brána SGW:
- https://test-heidelpay.hpcgw.net/sgw/gtw - kódované v latinke-15
- https://test-heidelpay.hpcgw.net/sgw/gtwu - kódované UTF-8
Brána NGW:
- https://test-heidelpay.hpcgw.net/ngw/post
Údaje o kreditnej karte pre tento test:
| značky | čísla kariet | CVV | dátum vypršania platnosti | poznámka |
| MasterCard | 5453010000059543 | 123 | budúci dátum | 3D - heslo: secret3 |
| víza | 4711100000000000 | 123 | budúci dátum | 3DS - heslo: tajné! |
Poznámka: Pre 3D Secure verzia 2 nemusíte zadávať heslo, stačí kliknúť na odkaz „Kliknutím sem dokončíte autentizáciu.
Jediným spôsobom, ako simulovať chybu pomocou 3D Secure verzie 2, je nechať časový limit stránky s odkazom (približne 18 minút).
Prečítajte si viac o tomto návode a stiahnite si PDF:
Dokumenty / zdroje
 |
Sprievodca integráciou softvéru 3D Secure [pdfDokumentácia Unzer, Sprievodca integráciou, 3D Secure |
