Dokumentacioni Udhëzues për Integrim të Sigurtë të Softuerëve 3D
Udhëzuesi i Integrimit 3D i Sigurt
Nga 01.01.2021, vërtetimi me dy faktorë do të zbatohet si një kërkesë e detyrueshme për të gjitha transaksionet e pagesave të kartave të tregtisë elektronike. Për të përmbushur këtë detyrim,
operatorët e rrjeteve të kartave të kreditit do të përdorin të ashtuquajturën procedurë 3D Secure. Për ju si tregtar është e detyrueshme të jeni në gjendje të kryeni këtë procedurë për klientët tuaj nga
01.01.2021. Në vijim do të gjeni një përshkrim të mënyrave të ndryshme të integrimit dhe se si duhet të zbatohet procedura 3D Secure për to.
Ju lutemi zgjidhni metodën e integrimit që përdorni
- A jeni duke përdorur formularin e arka hCO?
- A jeni duke përdorur formularin e blerjes hPF?
- A i përpunoni pagesat pa përdorur një formë të siguruar nga sistemi Unzer?
Ju lutemi vini re: Alsoshtë gjithashtu e rëndësishme në mënyrën se si bëhen debitë ose paraautorizime (rezerva). Edhe nëse përdorni një formë pagese nga Unzer GmbH për regjistrimin e të dhënave të kartës, procesi 3D Secure do të kryhet pa një formë arkë kur të dhënat e kartës debitohen ose autorizohen për herë të parë. Në këtë rast zbatohet mënyra e tretë e integrimit pa një formë të siguruar nga Unzer.
Ju lutemi vini re gjithashtu:
Nëse përdorni pagesa të përsëritura (pagesa pajtimi), sigurohuni të lexoni seksionin "Pagesa 3D të Sigurta dhe të Përsëritura".
Procedurë 3D e Sigurt kur përdorni formularin e blerjes hCO
Formulari i blerjes së hCO-së është krijuar tashmë për procedurën 3D Secure. Nga ana juaj nuk ka ndonjë veprim shtesë të nevojshëm për zbatimin e procedurës. Sidoqoftë, ti
duhet të siguroheni që sistemi juaj mund të trajtojë përgjigjet përkatëse të sistemit tonë të pagesave në rast se fillon procesi 3D Secure. Në përgjigjen asinkrone nga
sistemi i pagesave në serverin tuaj, rezultati i transaksionit transmetohet dhe duhet të vlerësohet atje përpara një kthimi URL transmetohet në sistemin e pagesave.
Për këtë qëllim duhet të vlerësohen parametrat e mëposhtëm.
- PCRPUNIMI.RETURN.KODI = 000.200.000
- PROCESIMI.RETURN = Transaksioni + në pritje
- PCRPUNIMI. REZULTATI = ACK
Shpjegim: Statusi i transaksionit është "në pritje", parametri PROCESSING.RESULT
paraqet vetëm një rezultat paraprak. Për sa kohë që kryhet procesi 3D Secure, statusi
mbeten pezull.
Rezultati përfundimtar i transaksionit është atëherë ose
- PCRPUNIMI.RETURN.KODI = 000.000.000
- PCRPUNIMI. REZULTATI = ACK
or - PCRPUNIMI.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- PCRPUNIMI. REZULTATI = NOK
Në rastin e parë transaksioni është kryer me sukses, në rastin e dytë ka dështuar në përgjithësi. Kjo e fundit mund të ketë arsye të ndryshme, përfshirë refuzimin e vërtetimit. Ju do të
merrni informacione më të hollësishme në parametrat "PCRPUNIMI.RETURN" dhe "PCRPUNIMI.RETURN.KODI".
Ne ju rekomandojmë që të bëni një test për të dy mesazhet. Për më shumë informacion se si të bëni një test dhe cilat detaje të kartës së kreditit mund të përdorni për një provë, ju lutem shikoni më poshtë.
Procedurë 3D e Sigurt kur përdorni formularin e blerjes së hPF
Formulari i blerjes së hPF është gjithashtu i dizajnuar për të përdorur procedurën 3DS tashmë. Nga ana juaj nuk ka ndonjë veprim shtesë të nevojshëm për zbatimin e procedurës. Sic eshte pershkruar
për zbatimin e hCO-së, përgjigjja nga sistemi i pagesave bëhet në dy hapa, prandaj sistemi juaj duhet të kontrollojë vlerën e PROCESIMIT.RETURN.CODE
parametri gjatë përpunimit të përgjigjes.
Për këtë qëllim duhet të vlerësohen parametrat e mëposhtëm.
- PCRPUNIMI.RETURN.KODI = 000.200.000
- PROCESIMI.RETURN = Transaksioni + në pritje
- PCRPUNIMI. REZULTATI = ACK
Shpjegim: Statusi i transaksionit është "në pritje", parametri PROCESSING.RESULT përfaqëson vetëm një rezultat paraprak. Për sa kohë që kryhet procesi 3D Secure, statusi
mbeten pezull.
Rezultati përfundimtar i transaksionit është atëherë ose
- PCRPUNIMI.RETURN.KODI = 000.000.000
- PCRPUNIMI. REZULTATI = ACK
or - PCRPUNIMI.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- PCRPUNIMI. REZULTATI = NOK
Në rastin e parë transaksioni është kryer me sukses, në rastin e dytë ka dështuar në përgjithësi. Kjo e fundit mund të ketë arsye të ndryshme, përfshirë refuzimin e vërtetimit. Ju do të
merrni informacione më të hollësishme në parametrat "PCRPUNIMI.RETURN" dhe "PCRPUNIMI.RETURN.KODI".
Ne ju rekomandojmë që të bëni një test për të dy mesazhet. Për më shumë informacion se si të bëni një test dhe cilat detaje të kartës së kreditit mund të përdorni për një provë, ju lutem shikoni më poshtë.
Procedurë 3D e Sigurt me lidhje direkte
Nëse nuk përdorni një formë pagese të siguruar nga Unzer (ish heidelpay) për të përpunuar pagesa me kartë krediti, ose nëse thjesht regjistroni një kartë duke përdorur një nga format dhe përpunoni paraautorizimin (rezervimin) ose debitin si referencë për regjistrimin si një komunikimi i drejtpërdrejtë me sistemin e pagesave, ju duhet të zbatoni procesin 3D Secure.
Rrjedha e transaksionit asinkron:
Ky është një proces asinkron në të cilin serveri juaj merr një përcjellje URL (Ridrejtuar URL) nga sistemi ynë i pagesave. Serveri juaj duhet ta përcjellë klientin tek kjo URL në mënyrë që ai të mund të kryejë vërtetimin përmes procedurës 3D Secure. Rezultati i këtij vërtetimi 3D Secure raportohet direkt tek Unzer nga banka që lëshon kartën.
Pas vërtetimit të suksesshëm, transaksioni përpunohet më tej në sistemin Unzer në mënyrën që ju tashmë e dini duke dërguar sistemin tuaj një rezultat të përgjithshëm në fund, të cilit ju i përgjigjeni
me një ridrejtim URL. Sistemi i pagesave do të ridrejtojë klientin përsëri në sistemin tuaj duke përdorur këtë ridrejtim URL nga sistemi juaj
Ju lutemi vini re: Në këtë rrjedhë pune sistemi juaj merr dy përgjigje nga sistemi i pagesave:
- Një me statusin "në pritje" (PROCESSING.RETURN.CODE = 000.200.000 dhe PROCESSING.RETURN = Transaksion + në pritje) dhe parametrat e ridrejtimit në bankën lëshuese të kartave të klientit
- Një me rezultatin përfundimtar të debitit ose rezervimit. Ka edhe dy ridrejtime URLPërmendur në këtë proces, një nga sistemi i pagesave në të cilin klienti duhet të ridrejtohet për tu vërtetuar në bankën e kartës së tij lëshuese dhe një nga sistemi juaj, kur merrni rezultatin përfundimtar, për ta ridrejtuar klientin përsëri në sistemin tuaj.
Ndryshimet e mëposhtme do të bëhen në procedurën e rregullt. Ju lutemi vini re se për shkak të zbatimit të metodave të tjera të pagimit asinkron, të tilla si Paypal, disa nga këto
proceset mund të ekzistojnë tashmë në zbatimin tuaj.
- Përgjigje URL
Në thirrjen e parë (nr. 2 në diagram) në sistemin e pagesave, një “Përgjigje URL”Duhet të kalohet në grupin frontend.
Ju lutemi vini re: Parametri IDENTIFICATION.REFERENCEID është i rëndësishëm vetëm nëse i referoheni një regjistrimi ose transaksioni tjetër tashmë ekzistues - Përpunimi i ridrejtimit URL Nëse kërkohet vërtetimi, ridrejtoni URL dhe parametrat e tjerë në grupin e ridrejtimit transferohen në përgjigjen nga sistemi i pagesave (Nr. 5 në diagram).
- Përcjellja e klientit në ridrejtim URL
Nëse grupi i ridrejtimit po përgjigjet me një ridrejtim URL, Shfletuesi i klientit duhet të ridrejtohet në këtë URL (Nr. 6 në diagram) për të kryer vërtetimin. Parametrat shtesë nga grupi i ridrejtimit duhet të transferohen në atë të jashtëm websiti si parametra POST.
Ju lutemi vini re: Parametrat shtesë kthehen në grupin "PROCESSING.REDIRECT.xxx" vetëm me Version 3 të Sigurt 1D (edhe atje numri dhe emërtimi mund të ndryshojnë), ndërsa me Versionin 3 të 2D vetëm një PROCESSING.REDIRECT.URL siç shfaqet më poshtë është kthyer: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run Kjo do të thotë që pavarësisht nga lloji dhe numri i parametrave, shfletuesi i klientit duhet të ridrejtojë te PROCESSING.REDIRECT.URL.
Më poshtë do të gjeni një kod të thjeshtë p.shampse si mund të ekzekutohet një ridrejtim i tillë. Të pjesa ka për qëllim të informojë klientët fundorë, sistemet e të cilëve nuk e mbështesin Javascript ose e kanë atë të çaktivizuar. Ne rekomandojmë fuqimisht që ridrejtimi të bëhet brenda dritares aktive të shfletuesit të klientit dhe të mos përdoren dritaret që shfaqen ose dritaret e reja të shfletuesit, pasi kjo mund të
irritojnë klientët dhe i drejtojnë ata të mbyllin faqen në të cilën janë ridrejtuar.
- Kontroll asinkron i rezultatit
Rezultati i vërtetimit dërgohet në mënyrë asinkrone në serverin tuaj. Sistemi i pagesave pret një të vlefshme URL si përgjigje. (Nr. 12 & 13 në diagram). Për të suksesshëm ose të refuzuar
pagesa, një tjetër URL mund të përgjigjet këtu nga sistemi juaj. - Rruga e kthimit të klientit
Sistemi i pagesave ridrejton klientin në URL siguruar nga sistemi i tregtarit pasi të ketë përfunduar procesi i vërtetimit dhe transaksioni i pagesës.
Ju lutemi vini re: Hapat 4.) dhe 5.) vazhdoni saktësisht në të njëjtën mënyrë siç jeni njohur tashmë në transaksionet ekzistuese ASNJ 3D XNUMXD Secure.
Pagesa 3D e Sigurt dhe e Përsëritur
Nga 1 janari 2021, 3D Secure do të jetë i detyrueshëm për të gjitha transaksionet e kartave të tregtisë elektronike. Sidoqoftë, meqenëse kjo nuk është e zbatueshme për pagesa të përsëritura, bankat
sistemet kanë një rrjedhë të veçantë pune për këtë.
Për këtë qëllim, bankat bëjnë dallimin midis
- CIT = transaksione të iniciuara nga klienti
- MIT = transaksionet e iniciuara nga tregtarët
Transaksioni i parë i një karte në llogarinë tuaj tregtare duhet të vërtetohet me 3D Secure nga 01.01.2021 e tutje. Një vërtetim i tillë i suksesshëm është një kërkesë e detyrueshme në
për të qenë në gjendje të dorëzoni më pas rezervime të mëtejshme në të njëjtën kartë pa 3D Secure. Prandaj, klienti duhet të përcillet në bankën e tij që lëshon karta për debitin e parë në
në përputhje me procedurën e përshkruar më sipër dhe të vërtetojë veten atje si mbajtës i kartës. Nëse një debitim nuk është planifikuar në kohën e porosisë, p.shampPër shkak të një periudhe prove, duhet të bëhet një rezervim (paraautorizim) prej të paktën një euro me 3D Secure në prani të klientit. Kapja e këtij rezervimi nuk është e nevojshme.
Për klientët ekzistues, megjithatë, nuk ka nevojë për autentikim 3D Secure. Nëse debiti i parë i suksesshëm ka ndodhur para 01.01.2021, rekordi i klientit gjithashtu mund të supozohet se
janë vërtetuar me sukses. Për klientët e rinj që nga 01.01.2021, nga ana tjetër, vërtetimi 3D Secure është i detyrueshëm për debitimin ose rezervimin e parë (para-autorizim).
Ju lutemi vini re: Në këtë drejtim, sistemi bankar shikon të dhënat e kartës, jo të dhënat e klientit. Pra, nëse një klient ekzistues përdor një kartë të re pas datës 01.01.2021, p.shample sepse e mëparshme
njërit i ka skaduar afati ose për shkak se ka ndryshuar bankën lëshuese të kartës, ky është një cikël i ri i përsëritur nga pika e bankave. view dhe duhet të vërtetohet me 3D Secure për rezervimin e parë.
Pasi të jetë kryer me sukses ky vërtetim fillestar, të gjitha transaksionet e mëtejshme përjashtohen nga detyrimi për të përdorur 3D Secure. Kushtet paraprake për pagesa të përsëritura pa 3D Secure janë:
- Ekziston të paktën një debitim ose rezervim i suksesshëm (para-autorizim) i cili ose u krye me 3D Secure ose u zhvillua para datës 01.01.2021.
- i referohet një regjistrimi dhe debiti ekzistues pas dorëzimit
Për ta bërë të ditur sistemin e pagesave, se kjo është një pagesë e përsëritur, duhet të dërgohet edhe parametri RECURRENCE.MODE = REPEATED. Kjo i sinjalizon sistemit se a
Pagesa e përsëritur duhet të raportohet në sistemet bankare.
Ju lutemi vini re: Nëse futet parametri RECURRENCE.MODE = REPEATED kur një kartë e re ngarkohet për herë të parë, përcjellja 3D Secure do të kryhet pavarësisht këtij parametri.
Testimi i implementimit 3D Secure
Mund ta testoni lidhjen 3D Secure në çdo kohë nëpërmjet sistemit tonë të pagesave. Për ta bërë këtë, përdorni modalitetin "CONNECTOR_TEST" për një transaksion, siç tregohet në shembullampmë lart.
Të dhënat e lidhjes për këtë provë:
| SIGURIA. DENDRGUESI | 31HA07BC8142C5A171745D00AD63D182 |
| PERRDORUESI.HYRNI | 31ha07bc8142c5a171744e5aef11ffd3 |
| PERRDORUESI.PWD | 93167DE7 |
| TRANSAKSIONI.KANALET | 31HA07BC8142C5A171749A60D979B6E4 |
| Monedhat e konfiguruara për 3D Version 2 | EUR, USD, SEK |
| Monedhat e konfiguruara për 3D Version 1 | GBP, CZK, CHF |
Pika përfundimtare e gateway të sistemit është ose
Porta SGW:
- https://test-heidelpay.hpcgw.net/sgw/gtw - Latinisht-15 i koduar
- https://test-heidelpay.hpcgw.net/sgw/gtwu - UTF-8 i koduar
Porta NGW:
- https://test-heidelpay.hpcgw.net/ngw/post
Të dhënat e kartës së kreditit për këtë provë:
| markave | numrat e kartave | CVV | data e skadencës | shënim |
| MasterCard | 5453010000059543 | 123 | data e ardhshme | 3D - fjalëkalimi: sekret3 |
| Viza | 4711100000000000 | 123 | data e ardhshme | 3DS - fjalëkalimi: sekret! 33 |
Ju lutemi vini re: Për Versionin e Sigurt 3D, ju nuk keni nevojë të futni një fjalëkalim, por thjesht klikoni në lidhjen ”Klikoni këtu për të kompletuar vërtetimin.
Mënyra e vetme për të simuluar një gabim me 3D Secure Version 2 është të lini faqen me lidhjen të skadojë (rreth 18 minuta).
Lexoni më shumë rreth këtij manuali dhe shkarkoni PDF:
Dokumentet / Burimet
 |
Udhëzues për Integrimin e Sigurt të Softuerëve 3D [pdfDokumentacioni Unzer, Udhëzuesi i Integrimit, 3D Secure |
