Softver 3D Vodič za sigurnu integraciju Dokumentacija
Integracijski vodič 3D Secure
Od 01.01.2021. XNUMX. XNUMX. autentifikacija s dva faktora provodit će se kao obvezni uvjet za sve transakcije plaćanja e-trgovinskim karticama. Kako bi ispunio ovu obvezu,
operateri mreža kreditnih kartica koristit će takozvani 3D Secure postupak. Za vas kao trgovca obavezna je mogućnost da izvršite ovaj postupak za svoje kupce iz
01.01.2021. U nastavku ćete pronaći opis različitih načina integracije i kako se za njih mora primijeniti postupak 3D Secure.
Odaberite način integracije koji koristite
- Koristite li obrazac za naplatu hCO?
- Koristite li obrazac za naplatu hPF?
- Obrađujete li plaćanja bez korištenja obrasca koji nudi sustav Unzer?
Napomena: Važno je i na koji način se vrše terećenja ili prethodna odobrenja (rezervacije). Čak i ako koristite obrazac za plaćanje od Unzer GmbH za registraciju podataka o kartici, postupak 3D Secure provest će se bez obrasca za naplatu kada se podaci s kartice prvi put terete ili odobre. U ovom slučaju primjenjuje se treći način integracije bez obrasca koji je pružio Unzer.
Također imajte na umu:
Ako koristite periodična plaćanja (plaćanja pretplate), svakako pročitajte odjeljak "3D sigurno i periodično plaćanje".
3D Secure postupak pri korištenju obrasca za naplatu hCO
Obrazac za naplatu hCO već je dizajniran za postupak 3D Secure. S vaše strane nisu potrebne dodatne radnje potrebne za provedbu postupka. Međutim, ti
morate biti sigurni da vaš sustav može obrađivati odgovarajuće odgovore našeg sustava plaćanja u slučaju pokretanja postupka 3D Secure. U asinkronom odgovoru od
sustava plaćanja na vaš poslužitelj, rezultat transakcije se prenosi i mora se tamo procijeniti prije povrata URL se prenosi u platni sustav.
U tu svrhu moraju se procijeniti sljedeći parametri.
- OBRADA.POVRAT.KOD = 000.200.000
- PROCESSING.RETURN = Transakcija + na čekanju
- OBRADA.REZULTAT = PRITVORI
Objašnjenje: Status transakcije je „na čekanju“, parametar PROCESSING.RESULT
predstavlja samo preliminarni rezultat. Sve dok se provodi postupak 3D Secure, status
ostaju na čekanju.
Konačni rezultat transakcije je tada bilo
- OBRADA.POVRAT.KOD = 000.000.000
- OBRADA.REZULTAT = PRITVORI
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 ili 000.200.000
- OBRADA.REZULTAT = NOK
U prvom je slučaju transakcija uspješno dovršena, u drugom slučaju je u cjelosti propala. Potonji mogu imati različite razloge, uključujući odbijanje autentifikacije. Hoćeš
dobiti detaljnije informacije u parametrima „PROCESSING.RETURN” i „PROCESSING.RETURN.CODE”.
Preporučujemo da pokrenete test za obje poruke. Za više informacija o tome kako napraviti test i koje podatke o kreditnoj kartici možete koristiti za test, pogledajte dolje.
Postupak 3D sigurne upotrebe hPF obrasca za naplatu
Obrazac za naplatu hPF-a također je dizajniran da već koristi postupak 3DS. S vaše strane nisu potrebne dodatne radnje potrebne za provedbu postupka. Kao što je opisano
za implementaciju hCO odgovor iz platnog sustava odvija se u dva koraka, zbog čega vaš sustav mora provjeriti vrijednost PROCESSING.RETURN.CODE
parametar pri obradi odgovora.
U tu svrhu moraju se procijeniti sljedeći parametri.
- OBRADA.POVRAT.KOD = 000.200.000
- PROCESSING.RETURN = Transakcija + na čekanju
- OBRADA.REZULTAT = PRITVORI
Objašnjenje: Status transakcije je „na čekanju“, parametar PROCESSING.RESULT predstavlja samo preliminarni rezultat. Sve dok se provodi postupak 3D Secure, status
ostaju na čekanju.
Konačni rezultat transakcije je tada bilo
- OBRADA.POVRAT.KOD = 000.000.000
- OBRADA.REZULTAT = PRITVORI
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 ili 000.200.000
- OBRADA.REZULTAT = NOK
U prvom je slučaju transakcija uspješno dovršena, u drugom slučaju je u cjelosti propala. Potonji mogu imati različite razloge, uključujući odbijanje autentifikacije. Hoćeš
dobiti detaljnije informacije u parametrima „PROCESSING.RETURN” i „PROCESSING.RETURN.CODE”.
Preporučujemo da pokrenete test za obje poruke. Za više informacija o tome kako napraviti test i koje podatke o kreditnoj kartici možete koristiti za test, pogledajte dolje.
3D siguran postupak s izravnom vezom
Ako za obradu plaćanja kreditnom karticom ne upotrebljavate obrazac za plaćanje koji je dostavio Unzer (bivši heidelpay) ili ako karticu jednostavno registrirate pomoću jednog od obrazaca i obradite prethodnu autorizaciju (rezervaciju) ili terećenje kao referencu na registraciju kao izravnu komunikaciju sa sustavom plaćanja, morate implementirati postupak 3D Secure.
Asinkroni tok transakcija:
Ovo je asinkroni postupak u kojem vaš poslužitelj prima prosljeđivanje URL (Preusmjeriti URL) iz našeg sustava plaćanja. Vaš poslužitelj mora na to proslijediti kupca URL kako bi mogao provesti provjeru autentičnosti putem postupka 3D Secure. O ovoj 3D Secure provjeri autentičnosti banka koja izdaje kartice izvještava izravno Unzeru.
Nakon uspješne provjere autentičnosti, transakcija se dalje obrađuje u sustavu Unzer na način koji već znate slanjem ukupnog rezultata vašeg sustava na kraj, na što odgovarate
s preusmjeravanjem URL. Sistem plaćanja će zatim preusmjeriti kupca natrag u vaš sustav pomoću ovog preusmjeravanja URL iz vašeg sustava
Napomena: U ovom tijeku rada vaš sustav dobiva dva odgovora od platnog sustava:
- Onaj sa statusom „na čekanju“ (PROCESSING.RETURN.CODE = 000.200.000 i PROCESSING.RETURN = Transakcija + na čekanju) i parametrima preusmjeravanja na banku izdavatelja kartice kupca
- Jedan s konačnim rezultatom terećenja ili rezervacije. Postoje i dva preusmjeravanja URLspomenute u ovom procesu, one iz platnog sustava na koje se mora preusmjeriti kupac za provjeru autentičnosti banke izdavatelja kartice i jedna iz vašeg sustava prilikom primanja konačnog rezultata kako bi se kupac preusmjerio natrag u vaš sustav.
Sljedeće promjene bit će unesene u redoviti postupak. Imajte na umu da zbog primjene drugih asinkronih načina plaćanja, poput Paypala, neki od njih
procesi možda već postoje u vašoj implementaciji.
- Odgovor URL
U prvom pozivu (br. 2 na dijagramu) platnom sustavu prikazan je odgovor URL”Mora se predati u frontend grupi.
Napomena: Parametar IDENTIFICATION.REFERENCEID relevantan je samo ako se pozivate na registraciju ili drugu već postojeću transakciju - Preusmjeravanje obrade URL Ako je potrebna autentifikacija, preusmjeravanje URL i ostali parametri u grupi za preusmjeravanje prenose se u odgovoru iz platnog sustava (br. 5 na dijagramu).
- Prosljeđivanje kupca na preusmjeravanje URL
Ako grupa za preusmjeravanje odgovara preusmjeravanjem URL, korisnikov preglednik mora biti preusmjeren na ovo URL (br. 6 na dijagramu) za provođenje provjere autentičnosti. Dodatni parametri iz grupe za preusmjeravanje moraju se prenijeti na vanjski webstranice kao POST parametri.
Napomena: Dodatni parametri vraćaju se u grupi „PROCESSING.REDIRECT.xxx“ samo s 3D sigurnom verzijom 1 (čak i tamo broj i imenovanje mogu varirati), dok s 3D verzijom 2 samo PROCESSING.REDIRECT.URL kako je prikazano dolje, vraća se: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run To znači da bez obzira na vrstu i broj parametara, klijentski preglednik mora preusmjeriti na PROCESSING.REDIRECT.URL.
Ispod ćete pronaći jednostavan kod nprample o tome kako se takvo preusmjeravanje može izvršiti. The dio je namijenjen informiranju krajnjih kupaca čiji sustavi ne podržavaju Javascript ili su ga onemogućili. Preporučujemo da se preusmjeravanje izvrši unutar aktivnog prozora preglednika korisnika i da se ne koriste skočni prozori ili novi prozori preglednika, jer bi to moglo
iritirati kupce i navesti ih da zatvore stranicu na koju su preusmjereni.
- Asinkrona provjera rezultata
Rezultat provjere autentičnosti šalje se asinkrono na vaš poslužitelj. Sustav plaćanja očekuje valjanost URL kao odgovor. (Br. 12 i 13 na dijagramu). Za uspješno ili odbijeno
plaćanja, drugačiji URL ovdje može odgovoriti vaš sustav. - Povratni put kupca
Sustav plaćanja preusmjerava kupca na URL koje pruža trgovački sustav nakon dovršetka postupka provjere autentičnosti i platne transakcije.
Napomena: Koraci 4.) i 5.) nastavljaju se na potpuno isti način kao što ste već upoznati u postojećim NONE 3D Secure transakcijama.
3D sigurno i ponavljajuće plaćanje
Od 1. siječnja 2021. 3D Secure bit će obvezan za sve transakcije karticama e-trgovine. Međutim, budući da je to teško primjenjivo za redovita plaćanja, bankarstvo
sustavi za to imaju zaseban tijek rada.
U tu svrhu banke razlikuju
- CIT = inicirane transakcije kupca
- MIT = inicirane transakcije trgovca
Prva transakcija kartice na vašem trgovačkom računu mora biti ovjerena 3D Secureom od 01.01.2021 nadalje. Takva uspješna provjera autentičnosti obvezan je uvjet u
kako biste mogli naknadno poslati daljnje rezervacije na istoj kartici bez 3D Securea. Stoga se kupac mora proslijediti svojoj banci koja izdaje karticu za prvo terećenje u
u skladu s gore opisanim postupkom i tu se autentifikuje kao vlasnik kartice. Ako terećenje nije planirano u trenutku narudžbe, nprampzbog probnog razdoblja, potrebno je izvršiti rezervaciju (predautorizaciju) od najmanje jednog eura uz 3D Secure u prisutnosti korisnika. Snimanje ove rezervacije nije potrebno.
Međutim, za postojeće kupce nije potrebna 3D sigurna provjera autentičnosti. Ako je prvo uspješno terećenje izvršeno prije 01.01.2021, može se pretpostaviti i evidencija kupaca
su uspješno potvrđeni. S druge strane, za nove kupce od 01.01.2021 3D Secure autentifikacija obavezna je za prvo terećenje ili rezervaciju (pre-autorizacija).
Napomena: U tom smislu bankovni sustav gleda podatke o kartici, a ne podatke o klijentima. Dakle, ako postojeći korisnik koristi novu karticu nakon 01.01.2021., nprample jer prethodni
jedan je istekao ili jer je promijenio banku izdavatelja kartice, ovo je novi ciklus koji se ponavlja od strane banaka view i mora biti ovjerena pomoću 3D Securea za prvu rezervaciju.
Nakon što je ova početna provjera autentičnosti uspješno provedena, sve daljnje transakcije izuzete su od obveze upotrebe 3D Secure-a. Preduvjeti za ponavljanje plaćanja bez 3D Secure-a su:
- Postoji barem jedno uspješno terećenje ili rezervacija (pre-autorizacija) koja je izvršena s 3D Secure ili je izvršena prije 01.01.2021.
- poziva se na postojeću registraciju i terećenje nakon podnošenja
Da bi sustav plaćanja znao da se radi o ponavljajućem plaćanju, mora se poslati i parametar RECURRENCE.MODE = REPEATED. To signalizira sustavu da a
periodično plaćanje prijaviti bankarskim sustavima.
Napomena: Ako se parametar RECURRENCE.MODE = REPEATED unese kada se nova kartica učita prvi put, unaprijed s tim parametrom izvršit će se 3D sigurno prosljeđivanje.
Testiranje 3D Secure implementacije
3D Secure vezu možete testirati u bilo kojem trenutku putem našeg sustava plaćanja. Da biste to učinili, koristite način rada "CONNECTOR_TEST" za transakciju, kao što je prikazano na primjeruamples iznad.
Podaci veze za ovaj test:
| SIGURNOST.POŠALJ | 31HA07BC8142C5A171745D00AD63D182 |
| KORISNIK.PRIJAVA | 31ha07bc8142c5a171744e5aef11ffd3 |
| KORISNIK.PWD | 93167DE7 |
| TRANSAKCIJA.KANAL | 31HA07BC8142C5A171749A60D979B6E4 |
| Valute konfigurirane za 3D verziju 2 | EUR, USD, SEK |
| Valute konfigurirane za 3D verziju 1 | GBP, CZK, CHF |
Krajnja točka pristupnika sustava je bilo
SGW pristupnik:
- https://test-heidelpay.hpcgw.net/sgw/gtw - kodirano latinicom 15
- https://test-heidelpay.hpcgw.net/sgw/gtwu - kodirano UTF-8
NGW pristupnik:
- https://test-heidelpay.hpcgw.net/ngw/post
Podaci o kreditnoj kartici za ovaj test:
| marke | brojevi kartica | CVV | datum isteka | bilješka |
| MasterCard | 5453010000059543 | 123 | budući datum | 3D - lozinka: secret3 |
| Visa | 4711100000000000 | 123 | budući datum | 3DS - lozinka: tajna! 33 |
Napomena: Za verziju 3D Secure 2 ne trebate unijeti lozinku, već jednostavno kliknite vezu "Kliknite ovdje da biste dovršili provjeru autentičnosti.
Jedini način da se simulira pogreška s 3D Secure Verzijom 2 jest da se stranici s vremenom povezivanja istekne (približno 18 minuta).
Pročitajte više o ovom priručniku i preuzmite PDF:
Dokumenti / Resursi
 |
Vodič za integraciju softvera 3D Secure [pdfDokumentacija Unzer, Vodič za integraciju, 3D Secure |
