Tarkvara 3D Secure Integration Guide dokumentatsioon
Integreerimisjuhend 3D Secure
Alates 01.01.2021 rakendatakse kaheastmelist autentimist kohustusliku nõudena kõigi poodkaardimaksete puhul. Selle kohustuse täitmiseks peab
krediitkaardivõrkude operaatorid kasutavad nn 3D Secure protseduuri. Teie kui kaupmehe jaoks on kohustuslik võimaldada seda protseduuri oma klientide jaoks alates
01.01.2021. Järgnevalt leiate kirjelduse erinevatest integreerimisviisidest ja sellest, kuidas 3D Secure protseduuri nende jaoks tuleb rakendada.
Valige kasutatav integreerimismeetod
- Kas kasutate kassavormi hCO?
- Kas kasutate kassavormi hPF?
- Kas töötlete makseid ilma Unzeri süsteemi vormi kasutamata?
Pange tähele: Samuti on oluline, kuidas debiteeritakse või eelautoriseeritakse (reserveeritakse). Isegi kui kasutate kaardiandmete registreerimiseks Unzer GmbH maksevormi, toimub 3D Secure protsess ilma kassavormita, kui kaardiandmed debiteeritakse või volitatakse esimest korda. Sel juhul kehtib kolmas integreerimise viis ilma Unzeri pakutava vormita.
Pange tähele ka järgmist:
Kui kasutate korduvaid makseid (tellimusmakseid), lugege kindlasti jaotist „3D turvaline ja korduv makse“.
3D Secure protseduur hCO kassavormi kasutamisel
HCO kassavorm on juba loodud 3D Secure protseduuri jaoks. Menetluse rakendamiseks pole teie poolt vaja täiendavaid toiminguid. Kuid sina
3D Secure'i protsessi käivitamisel peate veenduma, et teie süsteem saab hakkama meie maksesüsteemi vastustega. Asünkroonses vastuses
maksesüsteemi teie serverisse, edastatakse tehingu tulemus ja seda tuleb seal enne tagastamist hinnata URL edastatakse maksesüsteemi.
Selleks tuleb hinnata järgmisi parameetreid.
- TÖÖTLEMINE. TAGASI. KOOD = 000.200.000
- PROCESSING.RETURN = Tehing + ootel
- TÖÖTLEMINE. TULEMUS = ACK
Selgitus: Tehingu olek on „ootel“, parameeter PROCESSING.RESULT
esindab ainult esialgset tulemust. Niikaua kui 3D Secure protsess viiakse läbi, on olek
jäävad ootele.
Tehingu lõpptulemus on ka siis
- TÖÖTLEMINE. TAGASI. KOOD = 000.000.000
- TÖÖTLEMINE. TULEMUS = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 000.200.000 XNUMX või XNUMX XNUMX XNUMX
- TÖÖTLEMINE. TULEMUS = NOK
Esimesel juhul on tehing edukalt lõpule viidud, teisel juhul on see üldiselt ebaõnnestunud. Viimasel võib olla erinevaid põhjuseid, sealhulgas keelduda autentimisest. Te saate
üksikasjalikumat teavet saate parameetritest „PROCESSING.RETURN” ja „PROCESSING.RETURN.CODE”.
Soovitame käivitada mõlema kirja test. Lisateavet testi tegemise ja krediitkaardi andmete kohta, mida saate testimiseks kasutada, leiate allpool.
3D Secure protseduur hPF-i kassas vormi kasutamisel
HPF-i kassavorm on loodud ka juba 3DS-i protseduuri kasutamiseks. Menetluse rakendamiseks pole teie poolt vaja täiendavaid toiminguid. Nagu kirjeldatud
hCO juurutamiseks toimub maksesüsteemi vastus kahes etapis, mistõttu peab teie süsteem kontrollima PROCESSING.RETURN.CODE väärtust
parameeter vastuse töötlemisel.
Selleks tuleb hinnata järgmisi parameetreid.
- TÖÖTLEMINE. TAGASI. KOOD = 000.200.000
- PROCESSING.RETURN = Tehing + ootel
- TÖÖTLEMINE. TULEMUS = ACK
Selgitus: Tehingu olek on „ootel“, parameeter PROCESSING.RESULT esindab ainult esialgset tulemust. Niikaua kui 3D Secure protsess viiakse läbi, on olek
jäävad ootele.
Tehingu lõpptulemus on ka siis
- TÖÖTLEMINE. TAGASI. KOOD = 000.000.000
- TÖÖTLEMINE. TULEMUS = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 000.200.000 XNUMX või XNUMX XNUMX XNUMX
- TÖÖTLEMINE. TULEMUS = NOK
Esimesel juhul on tehing edukalt lõpule viidud, teisel juhul on see üldiselt ebaõnnestunud. Viimasel võib olla erinevaid põhjuseid, sealhulgas keelduda autentimisest. Te saate
üksikasjalikumat teavet saate parameetritest „PROCESSING.RETURN” ja „PROCESSING.RETURN.CODE”.
Soovitame käivitada mõlema kirja test. Lisateavet testi tegemise ja krediitkaardi andmete kohta, mida saate testimiseks kasutada, leiate allpool.
3D Secure protseduur otsese ühendusega
Kui te ei kasuta krediitkaardimaksete töötlemiseks Unzeri (endine heidelpay) pakutavat maksevormi või kui registreerite kaardi lihtsalt ühe vormi abil ja töötlete eelautoriseerimise (broneeringu) või deebetina viitena registreerimisele kui otsesuhtlus maksesüsteemiga, peate rakendama 3D Secure protsessi.
Asünkroonne tehingute voog:
See on asünkroonne protsess, mille käigus teie server saab edasisuunamise URL (Suunamine URL) meie maksesüsteemist. Teie server peab kliendi sellesse edastama URL et ta saaks autentimise läbi viia 3D Secure protseduuri kaudu. Selle 3D Secure'i autentimise tulemusest teatab kaarti väljastav pank Unzerile otse.
Pärast edukat autentimist töödeldakse tehingut Unzeri süsteemis edasi juba teile teadaoleval viisil, saates oma süsteemile lõpus üldise tulemuse, millele vastate
ümbersuunamisega URL. Seejärel suunab maksesüsteem selle ümbersuunamise abil kliendi teie süsteemi tagasi URL oma süsteemist
Pange tähele: selles töövoos saab teie süsteem maksesüsteemist kaks vastust:
- üks olekuga „ootel“ (TÖÖTLEMINE.RETURN.CODE = 000.200.000 ja PROCESSING.RETURN = Tehing + ootel) ja ümbersuunamisparameetrid kliendi kaarti väljastanud panka
- üks deebet või broneeringu lõpptulemusega. Samuti on kaks ümbersuunamist URLSelles protsessis mainiti ühte maksesüsteemist, kuhu klient tuleb suunata tema kaardi väljastanud pangas autentimiseks, ja teie lõpptulemuse saamisel üht teie süsteemist, et suunata klient teie süsteemi tagasi.
Tavamenetluses tehakse järgmised muudatused. Pange tähele, et muude asünkroonsete makseviiside, näiteks Paypal'i rakendamise tõttu on mõned neist
protsessid võivad teie rakenduses juba olemas olla.
- Vastus URL
Esimeses maksesüsteemi kõnes (skeemil nr 2) kuvatakse „Vastus URL”Tuleb läbida frontendirühmas.
Pange tähele: Parameeter IDENTIFICATION.REFERENCEID on asjakohane ainult siis, kui viidate registreerimisele või muule juba olemasolevale tehingule - Ümbersuunamise töötlemine URL Kui autentimist on vaja, suunake ümber URL ja muud ümbersuunamisrühma parameetrid edastatakse vastuses maksesüsteemist (skeemil nr 5).
- Kliendi suunamine ümbersuunamisele URL
Kui ümbersuunamisrühm vastab ümbersuunamisega URL, tuleb sellele suunata kliendi brauser URL (nr 6 diagrammil) autentimise teostamiseks. Täiendavad parameetrid ümbersuunamisrühmast tuleb üle kanda välisele websaidi POST-i parameetritena.
Pange tähele: rühma „PROCESSING.REDIRECT.xxx” tagastatakse täiendavad parameetrid ainult 3D Secure versiooniga 1 (isegi seal võivad numbrid ja nimetused erineda), samas kui 3D-versiooniga 2 ainult PROCESSING.REDIRECT.URL tagastatakse nagu allpool näidatud: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run See tähendab, et sõltumata parameetrite tüübist ja arvust peab kliendibrauser suunama saidile PROCESSING.REDIRECT.URL.
Altpoolt leiate lihtsa koodi exampkuidas sellist ümbersuunamist teostada. The osa on mõeldud lõpptarbijate teavitamiseks, kelle süsteemid ei toeta Javascripti või on selle keelanud. Soovitame tungivalt ümbersuunamist teha kliendi aktiivses brauseriaknas ja mitte kasutada hüpikaknaid või uusi brauseriaknaid, kuna see võib
ärritada kliente ja suunata neid sulgema leht, kuhu nad suunatakse.
- Asünkroonne tulemuste kontroll
Autentimise tulemus saadetakse asünkroonselt teie serverisse. Maksesüsteem eeldab kehtivat URL vastusena. (Diagrammil nr 12 ja 13). Eduka või tagasilükatud eest
maksed, erinev URL siin saab teie süsteem vastata. - Kliendi tagasitee
Maksesüsteem suunab kliendi edasi URL kaupmehe süsteem pakub pärast autentimisprotsessi ja maksetehingu lõpuleviimist.
Pange tähele: sammud 4.) ja 5.) toimivad täpselt samamoodi, nagu olete juba tuttav olemasolevate NONE 3D Secure tehingute korral.
3D turvaline ja korduv makse
Alates 1. jaanuarist 2021 on 3D Secure kohustuslik kõigi e-kaubanduse kaarditehingute puhul. Kuid kuna seda ei saa korduvate maksete puhul vaevalt kohaldada, on pangandus
süsteemidel on selleks eraldi töövoog.
Sel eesmärgil teevad pangad vahet
- CIT = kliendi algatatud tehingud
- MIT = kaupmehe initsialiseeritud tehingud
Teie kaupmehe kontol oleva kaardi esimene tehing tuleb 3D Secure abil autentida alates 01.01.2021. Selline edukas autentimine on XNUMX. Aastal kohustuslik nõue
hiljem saab samal kaardil ilma 3D Secure'ita täiendavaid broneeringuid esitada. Seetõttu tuleb klient esimese deebetkorralduse jaoks suunata oma kaarti väljastanud panka
ülalkirjeldatud korras ja end seal kaardiomanikuna autentima. Kui deebet ei ole tellimuse ajal planeeritud, ntample katseperioodi tõttu tuleb selle asemel teha 3D Secure'iga kliendi juuresolekul vähemalt ühe euro suurune broneering (etteautoriseerimine). Selle broneeringu jäädvustamine ei ole vajalik.
Olemasolevate klientide jaoks ei pea 3D Secure'i autentimist siiski täiendama. Kui esimene edukas deebet toimus enne 01.01.2021, võib eeldada ka kliendirekordi olemasolu
on edukalt autentitud. Uutele klientidele alates 01.01.2021 seevastu on 3D Secure'i autentimine kohustuslik esimese deebeti või broneeringu puhul (eelautoriseerimine).
Tähelepanu: selles osas vaatab pangasüsteem kaardi, mitte kliendi andmeid. Seega kui olemasolev klient kasutab uut kaarti pärast 01.01.2021, ntample sest eelmine
üks on aegunud või kuna ta on vahetanud oma kaardi väljastanud panka, on see uus korduv tsükkel pankade seisukohast view ja see tuleb esimese broneeringu jaoks autentida 3D Secure'iga.
Kui see esmane autentimine on edukalt läbi viidud, on kõik muud tehingud 3D Secure'i kasutamise kohustusest vabastatud. Korduva makse eeldused ilma 3D Secureeta on seega järgmised:
- On vähemalt üks edukas deebet või broneerimine (eelautoriseerimine), mis viidi läbi 3D Secure'i abil või toimus enne 01.01.2021.
- esitamisel viidatakse sellele olemasolevale registreerimisele ja deebetile
Maksesüsteemi teavitamiseks, et tegemist on korduva maksega, tuleb saata ka parameeter RECURRENCE.MODE = REPEATED. See annab süsteemile märku, et a
korduvast maksest tuleb teatada pangandussüsteemidele.
Pange tähele: kui uue kaardi esmakordsel laadimisel sisestatakse parameeter RECURRENCE.MODE = REPEATED, viiakse 3D-turvaline edastamine vaatamata sellele parameetrile läbi.
Rakenduse 3D Secure testimine
Saate 3D Secure ühendust igal ajal meie maksesüsteemi kaudu testida. Selleks kasutage tehingu jaoks režiimi CONNECTOR_TEST, nagu on näidatud ntamples eespool.
Selle testi ühenduse andmed:
| TURVALISUS. SAADJA | 31HA07BC8142C5A171745D00AD63D182 |
| KASUTAJA SISSELOGIMINE | 31ha07bc8142c5a171744e5aef11ffd3 |
| KASUTAJA.PWD | 93167DE7 |
| TEHINGUD.KANAL | 31HA07BC8142C5A171749A60D979B6E4 |
| 3D-versiooni 2 jaoks konfigureeritud valuutad | EUR, USD, SEK |
| 3D-versiooni 1 jaoks konfigureeritud valuutad | GBP, CZK, CHF |
Kumbki on süsteemi lüüsi lõpp-punkt
SGW värav:
- https://test-heidelpay.hpcgw.net/sgw/gtw - ladina-15 kodeeritud
- https://test-heidelpay.hpcgw.net/sgw/gtwu - kodeeritud UTF-8
NGW värav:
- https://test-heidelpay.hpcgw.net/ngw/post
Selle testi krediitkaardiandmed:
| kaubamärgid | kaardi numbrid | CVV | aegumiskuupäev | tähele |
| MasterCard | 5453010000059543 | 123 | tulevane kuupäev | 3D - parool: saladus3 |
| Visa | 4711100000000000 | 123 | tulevane kuupäev | 3DS - parool: saladus! 33 |
Pange tähele: 3D Secure 2. versiooni puhul ei pea te parooli sisestama, vaid klõpsake lihtsalt lingil ”Autentimise lõpuleviimiseks klõpsake siin.
Ainus viis 3D Secure versiooniga 2 vea simuleerimiseks on lingil oleva lehe aegumine (umbes 18 minutit).
Lugege selle juhendi kohta lisateavet ja laadige alla PDF:
Dokumendid / Ressursid
 |
Tarkvara 3D turvalise integreerimise juhend [pdfDokumentatsioon Unzer, integreerimisjuhend, 3D Secure |
