Softwareak 3D Secure Integration Guide dokumentazioa
Integrazio gida 3D Secure
01.01.2021etik aurrera bi faktoreko autentifikazioa ezarriko da merkataritza elektroniko bidezko txartelaren ordainketa eragiketa guztietan. Betebehar hori betetzeko,
kreditu txartelen sareetako operadoreek 3D Secure prozedura deiturikoa erabiliko dute. Dendari gisa, derrigorrezkoa da zure bezeroentzako prozedura hau aurrera eramatea
01.01.2021. Jarraian, integrazio modu desberdinen deskribapena eta 3D Secure prozedura beraientzat nola ezarri behar den deskribatuko duzu.
Hautatu erabiltzen duzun integrazio metodoa
- HCO ordainketa orria erabiltzen ari zara?
- HPF ordainketa orria erabiltzen ari zara?
- Ordainketak prozesatzen al dituzu Unzer sistemak emandako inprimakia erabili gabe?
Kontuan izan: Garrantzitsua da, halaber, zordunketak edo aurre-baimenak (erreserbak) nola egiten diren. Txartelaren datuak erregistratzeko Unzer GmbH enpresaren ordainketa-orria erabiltzen baduzu ere, 3D Secure prozesua ordainketa-formulariorik gabe egingo da, txartelaren datuak lehenengo aldiz zordundutakoan edo baimendutakoan. Kasu honetan Unzerrek emandako inprimakirik gabeko hirugarren integrazio bidea aplikatuko da.
Kontuan izan ere:
Aldizkako ordainketak (harpidetzako ordainketak) erabiltzen badituzu, ziurtatu "3D ordainketa segurua eta errepikaria" atala irakurtzen duzula.
3D prozedura segurua hCO checkout inprimakia erabiltzean
HCO checkout inprimakia dagoeneko 3D Secure prozedurarako diseinatuta dago. Prozedura gauzatzeko zure aldetik ez dago ekintza osagarririk behar. Hala ere, zuk
ziurtatu behar duzu zure sistemak gure ordainketa-sistemari dagozkion erantzunak kudeatzen dituela 3D Secure prozesua hasten bada. -Ren erantzun asinkronoan
ordainketa sistema zure zerbitzarira, transakzioaren emaitza transmititzen da eta bertan ebaluatu behar da itzulketa egin aurretik URL ordainketa sistemara transmititzen da.
Horretarako parametro hauek ebaluatu behar dira.
- PROZESATZE.ITZULZEA.KODEA = 000.200.000
- PROCESSING.RETURN = Transakzioa + zain
- PROZESATZEN.EMAITZA = ACK
Azalpena: transakzioaren egoera "zain" dago, PROCESSING.RESULT parametroa
aldez aurreko emaitza baino ez du adierazten. 3D Secure prozesua burutzen den bitartean, egoera
zain egon.
Transakzioaren azken emaitza bai da
- PROZESATZE.ITZULZEA.KODEA = 000.000.000
- PROZESATZEN.EMAITZA = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 edo 000.200.000
- PROZESATZEN.EMAITZA = NOK
Lehenengo kasuan transakzioa ongi burutu da, bigarren kasuan huts egin du orokorrean. Azken horrek hainbat arrazoi izan ditzake, besteak beste, autentifikatzeari uko egitea. Egingo duzu
informazio zehatzagoa jaso "PROCESSING.RETURN" eta "PROCESSING.RETURN.CODE" parametroetan.
Bi mezuetarako proba bat egitea gomendatzen dizugu. Proba nola egin jakiteko eta probarako zein kreditu txartelen xehetasunak erabil ditzakezun jakiteko, ikusi beherago.
3D prozedura segurua hPF checkout formularioa erabiltzean
HPF checkout inprimakia 3DS prozedura dagoeneko diseinatuta dago. Prozedura gauzatzeko zure aldetik ez dago ekintza osagarririk behar. Deskribatu bezala
hCO ezartzeko, ordainketa-sistemaren erantzuna bi urratsetan ematen da, eta horregatik zure sistemak PROCESSING.RETURN.CODEren balioa egiaztatu behar du.
parametroa erantzuna prozesatzerakoan.
Horretarako parametro hauek ebaluatu behar dira.
- PROZESATZE.ITZULZEA.KODEA = 000.200.000
- PROCESSING.RETURN = Transakzioa + zain
- PROZESATZEN.EMAITZA = ACK
Azalpena: transakzioaren egoera "zain" dago, PROCESSING.RESULT parametroak aurretiazko emaitza besterik ez du adierazten. 3D Secure prozesua burutzen den bitartean, egoera
zain egon.
Transakzioaren azken emaitza bai da
- PROZESATZE.ITZULZEA.KODEA = 000.000.000
- PROZESATZEN.EMAITZA = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 edo 000.200.000
- PROZESATZEN.EMAITZA = NOK
Lehenengo kasuan transakzioa ongi burutu da, bigarren kasuan huts egin du orokorrean. Azken horrek hainbat arrazoi izan ditzake, besteak beste, autentifikatzeari uko egitea. Egingo duzu
informazio zehatzagoa jaso "PROCESSING.RETURN" eta "PROCESSING.RETURN.CODE" parametroetan.
Bi mezuetarako proba bat egitea gomendatzen dizugu. Proba nola egin jakiteko eta probarako zein kreditu txartelen xehetasunak erabil ditzakezun jakiteko, ikusi beherago.
3D prozedura segurua zuzeneko konexioarekin
Unzerrek (lehen heidelpay) emandako ordainketa formularioa erabiltzen ez baduzu kreditu txartelaren ordainketak prozesatzeko, edo txartel bat inprimakietako bat erabiliz erregistratzen baduzu eta aurrez baimena (erreserba) edo zordunketa prozesatzen baduzu erregistroaren erreferentzia gisa ordainketa sistemarekin zuzeneko komunikazioa, 3D Secure prozesua ezarri behar duzu.
Transakzio fluxu asinkronoa:
Zure zerbitzariak birbidaltze bat jasotzen duen prozesu asinkronoa da URL (Birbideratu URL) gure ordainketa sistematik. Zure zerbitzariak bezeroa honetara bidali behar du URL horrela, autentifikazioa 3D Secure prozeduraren bidez egin dezake. 3D Secure autentifikazio honen emaitza zuzenean Unzeri jakinarazi dio txartela jaulkitzen duen bankuak.
Autentifikazio arrakastatsua egin ondoren, transakzioa Unzer sisteman prozesatzen da dagoeneko ezagutzen duzun moduan, zure sistemari amaieran emaitza orokorra bidaliz eta horri erantzuten diozu
birbideratze batekin URL. Ordainketa sistemak bezeroa berriro zure sistemara birbideratuko du birbideratze hau erabiliz URL zure sistematik
Kontuan izan: lan-fluxu honetan zure sistemak bi erantzun jasotzen ditu ordainketa-sistematik:
- Bat "pendiente" egoerarekin (PROCESSING.RETURN.CODE = 000.200.000 eta PROCESSING.RETURN = Transakzioa + zain) eta birbideratze parametroak bezeroaren txartel jaulkitzailearen bankura.
- Zordunketa edo erreserbaren azken emaitza duen bat. Bi birbideratze ere badaude URLProzesu honetan aipatzen da, bezeroak bere txartela jaulkitzen duen bankuan autentifikatzeko ordainketa sistematik bideratu behar da eta zure sistematik beste bat, azken emaitza jasotzen duenean, bezeroa berriro zure sistemara birbideratzeko.
Ondorengo aldaketak ohiko prozeduran egingo dira. Kontuan izan beste ordainketa modu asinkronoak ezartzeagatik, Paypal adibidez, hauetako batzuk
baliteke prozesuak dagoeneko existitzea zure inplementazioan.
- Erantzuna URL
Ordainketa sistemarako lehenengo deian (diagramako 2. zenbakia), "Erantzuna URL”Frontend taldean gainditu behar da.
Kontuan izan: IDENTIFICATION.REFERENCEID parametroa garrantzitsua da erregistroa edo lehendik dagoen beste transakzio bat aipatzen baduzu - Birzuzenketa prozesatzen URL Autentifikazioa beharrezkoa bada, birbideratze bat URL eta birzuzenketa taldeko beste parametro batzuk ordainketa-sistemako erantzunean transferitzen dira (diagramako 5. zenbakia).
- Bezeroak birbideratzera birbidaltzea URL
Birbideratze taldeak birbideratze batekin erantzuten badu URL, bezeroaren arakatzailea horretara bideratu behar da URL (Diagramako 6. zenbakia) autentifikazioa egiteko. Birzuzenketa taldeko parametro osagarriak kanpora transferitu behar dira webgunea POST parametro gisa.
Kontuan izan: parametro osagarriak "PROCESSING.REDIRECT.xxx" taldean itzuliko dira 3D Secure 1 bertsioarekin soilik (hor ere zenbakia eta izena aldatu egin daitezke), 3D bertsioarekin, aldiz, PROCESSING.REDIRECT.URL behean agertzen den moduan itzultzen da: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run Horrek esan nahi du parametro mota eta kopurua edozein dela ere, bezeroaren arakatzaileak PROCESSING.REDIRECT-era birbideratu behar duela.URL.
Jarraian kode soil bat aurkituko duzuampbirzuzenketa nola exekutatu daitekeen jakiteko. The zatiak sistemek Javascript onartzen ez duten edo desgaituta duten azken bezeroei jakinarazteko xedea du. Gomendatzen dizugu birbideratzea bezeroaren arakatzailearen leiho aktiboan egitea eta leiho irekiak edo arakatzailearen leiho berriak ez erabiltzea, izan ere
bezeroak haserretu eta bideratzen duten orrialdea ixtera eraman.
- Emaitza kontrol asinkronoa
Autentifikazioaren emaitza modu asinkronoan bidaltzen da zure zerbitzarira. Ordainketa sistemak baliozko bat espero du URL erantzun gisa. (12. eta 13. zenbakiak diagraman). Arrakasta edo baztertzeagatik
ordainketak, beste bat URL Hemen zure sistemak erantzun dezake. - Bezeroaren itzulera bidea
Ordainketa sistemak bezeroa birbidaltzen du URL merkatariaren sistemak autentifikazio prozesua eta ordainketa transakzioa amaitu ondoren ematen ditu.
Kontuan izan: 4.) eta 5. urratsak) dagoeneko ezagutzen dituzun NONE 3D Secure transakzioetan ezagutzen duzun modu berean jarraitu.
3D ordainketa segurua eta errepikaria
1eko urtarrilaren 2021etik aurrera, 3D Secure derrigorrezkoa izango da merkataritza elektronikoko txartelaren transakzio guztietan. Hala ere, hori ez da aplikatzen behin eta berriz ordaintzen diren ordainketetarako, bankuak
sistemek lan-fluxu bereizia dute horretarako.
Horretarako, bankuek bereizten dituzte
- CIT = bezeroak hasitako transakzioak
- MIT = merkatariak hasierako transakzioak
Zure merkatari kontuko txartelaren lehen transakzioa 3D Secure-rekin autentifikatu behar da 01.01.2021etik aurrera. Horrelako autentifikazio arrakastatsua derrigorrezko baldintza da
ondorengo txartel berean erreserba gehiago bidali ahal izateko 3D Secure gabe. Hori dela eta, bezeroak txartela igortzen duen bankura bidali behar da lehen zordunketa egiteko
goian deskribatutako prozeduraren arabera eta bertan autentifikatzen da txartelaren titular gisa. Eskaeraren unean zordunketa aurreikusten ez bada, adibidezampProbako aldia dela eta, gutxienez euro bateko erreserba (aurrez baimena) egin behar da 3D Secure-rekin bezeroaren aurrean. Ez da beharrezkoa erreserba hori ateratzea.
Lehendik dauden bezeroentzat, ordea, ez da 3D Secure autentifikaziorik osatu behar. Lehen zordunketa arrakastatsua 01.01.2021 baino lehen gertatu bada, bezeroaren erregistroa ere har daiteke
behar bezala autentifikatu dira. Bezero berrientzat, 01.01.2021etik aurrera, bestalde, 3D Secure autentifikazioa derrigorrezkoa da lehen zordunketa edo erreserbarako (aurretiko baimena).
Kontuan izan: alde horretatik, banku sistemak txartelaren datuak begiratzen ditu, ez bezeroen datuak. Beraz, lehendik zegoen bezero batek txartel berria erabiltzen badu 01.01.2021etik aurrera, adibidezample aurrekoa delako
bat iraungi egin da edo txartela jaulkitzeko bankua aldatu duelako, hau errepikatzen den ziklo berria da bankuen puntutik view eta 3D Secure-rekin autentifikatu behar da lehen erreserba egiteko.
Hasierako autentifikazio hau arrakastaz burutu ondoren, beste transakzio guztiak 3D Secure erabiltzeko betebeharretik salbuetsita daude 3D Secure gabe ordainketa errepikatzeko baldintzak hauek dira:
- Badago gutxienez zordunketa edo erreserba arrakastatsu bat (aurretiko baimena) 3D Secure-rekin gauzatu dena edo 01.01.2021 baino lehen egin dena.
- bidalitakoan dagoen erregistroa eta zordunketa aipatzen dira
Ordainketa sistemari ordainketa errepikaria dela jakinarazteko, RECURRENCE.MODE = ERREPIKATUA parametroa ere bidali behar da. Honek sistemari adierazten dio a
aldizkako ordainketa banku sistemei jakinarazi behar zaie.
Kontuan izan: txartela berria lehen aldiz kargatzen denean RECURRENCE.MODE = REPEATED parametroa sartzen bada, parametro hori gorabehera 3D Segurtasuneko birbidalketa egingo da.
3D Secure inplementazioa probatzen
Edozein unetan probatu dezakezu 3D Secure konexioa gure ordainketa sistemaren bidez. Horretarako, erabili "CONNECTOR_TEST" modua transakzio baterako, adibamples goian.
Proba honetarako konexioaren datuak:
| SEGURTASUNA.IGORLEGA | 31HA07BC8142C5A171745D00AD63D182 |
| ERABILTZAILEA | 31ha07bc8142c5a171744e5aef11ffd3 |
| ERABILTZAILEA.PWD | 93167DE7 |
| TRANSAKZIOA.KANALA | 31HA07BC8142C5A171749A60D979B6E4 |
| 3D 2. bertsiorako konfiguratutako monetak | EUR, USD, SEK |
| 3D 1. bertsiorako konfiguratutako monetak | GBP, CZK, CHF |
Sistemaren atebidearen amaiera puntua bai da
SGW atebidea:
- https://test-heidelpay.hpcgw.net/sgw/gtw - Latin-15 kodetua
- https://test-heidelpay.hpcgw.net/sgw/gtwu - UTF-8 kodetua
NGW atebidea:
- https://test-heidelpay.hpcgw.net/ngw/post
Proba honetarako kreditu txartelaren datuak:
| markak | txartelaren zenbakiak | CVV | iraungitze-data | oharra |
| MasterCard | 5453010000059543 | 123 | etorkizuneko data | 3D - pasahitza: sekretua3 |
| Visa | 4711100000000000 | 123 | etorkizuneko data | 3DS - pasahitza: sekretua! 33 |
Kontuan izan: 3D Secure Version 2rako, ez duzu pasahitzik sartu behar, baizik eta egin klik estekan ”Egin klik hemen autentifikazioa osatzeko.
3D Secure 2. bertsioarekin errore bat simulatzeko modu bakarra estekarekin duen denbora (18 minutu inguru) uztea da.
Irakurri gehiago eskuliburu honi buruz eta deskargatu PDFa:
Dokumentuak / Baliabideak
 |
Softwareak 3D Secure Integrazio Gida [pdfDokumentazioa Unzer, Integrazio gida, 3D Secure |
