Softwares Dokumentazzjoni ta 'Gwida ta' Integrazzjoni Sikura 3D

Gwida għall-Integrazzjoni 3D Sikura

Mill-01.01.2021 l-awtentikazzjoni b'żewġ fatturi se tiġi implimentata bħala rekwiżit obbligatorju għat-tranżazzjonijiet kollha tal-ħlas tal-kards tal-kummerċ elettroniku. Sabiex tikkonforma ma 'dan l - obbligu,
operaturi ta 'netwerks ta' karti ta 'kreditu jużaw l-hekk imsejħa proċedura 3D Secure. Għalik bħala negozjant huwa obbligatorju li tkun tista 'twettaq din il-proċedura għall-klijenti tiegħek minn
01.01.2021. F'dan li ġej issib deskrizzjoni tal-modi differenti ta 'integrazzjoni u kif il-proċedura 3D Secure trid tiġi implimentata għalihom.

Jekk jogħġbok agħżel il-metodu ta 'integrazzjoni li tuża

• Qed tuża l-formola taċ-checkout hCO?
• Qed tuża l-formola taċ-checkout hPF?
• Tipproċessa l-ħlasijiet mingħajr ma tuża formola pprovduta mis-sistema Unzer?

Jekk jogħġbok innota: Huwa importanti wkoll b'liema mod isiru debiti jew awtorizzazzjonijiet minn qabel (riservazzjonijiet). Anke jekk tuża formola ta 'ħlas minn Unzer GmbH għar-reġistrazzjoni ta' dejta tal-karta, il-proċess 3D Secure jitwettaq mingħajr formola ta 'checkout meta d-dejta tal-karta tkun iddebitata jew awtorizzata għall-ewwel darba. F'dan il-każ japplika t-tielet mod ta 'integrazzjoni mingħajr formola pprovduta minn Unzer.

Jekk jogħġbok innota wkoll:
Jekk tuża ħlasijiet rikorrenti (ħlasijiet ta 'abbonament), kun żgur li taqra t-taqsima "Ħlas Sikur u Rikorrenti 3D".

Proċedura 3D Sikura meta tuża l-formola ta 'checkout hCO

Il-formola ta ’checkout hCO hija diġà ddisinjata għall-proċedura 3D Secure. M'hemm l-ebda azzjoni addizzjonali min-naħa tiegħek meħtieġa għall-implimentazzjoni tal-proċedura. Madankollu, int
għandek tiżgura ruħek li s-sistema tiegħek tista 'tieħu ħsieb it-tweġibiet korrispondenti tas-sistema tal-ħlas tagħna f'każ li jinbeda l-proċess 3D Secure. Fir - rispons mhux sinkroniku mill -
sistema ta ’ħlas lis-server tiegħek, ir-riżultat tat-tranżazzjoni jiġi trasmess u jrid jiġi evalwat hemm qabel ir-ritorn URL hija trasmessa lis-sistema tal-ħlas.

Għal dan il-għan għandhom jiġu evalwati l-parametri li ġejjin.

• KODIĊI.RITORN.PROĊESSAR = 000.200.000
• PROCESSING.RETURN = Tranżazzjoni + pendenti
• PROCESSING.RESULT = ACK

Spjegazzjoni: L-istatus tat-tranżazzjoni huwa “pendenti”, il-parametru PROCESSING.RESULT
jirrappreżenta biss riżultat preliminari. Sakemm jitwettaq il-proċess 3D Secure, l-istatus
jibqgħu pendenti.

Ir-riżultat finali tat-transazzjoni huwa jew

•  KODIĊI.RITORN.PROĊESSAR = 000.000.000
• PROCESSING.RESULT = ACK
  or
• PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 jew 000.200.000
• PROĊESSAR.RIŻULTAT = NOK

Fl-ewwel każ it-tranżazzjoni tlestiet b'suċċess, fit-tieni każ falliet b'mod ġenerali. Dan tal-aħħar jista 'jkollu diversi raġunijiet, inkluż rifjut li jawtentika. Int se
tirċievi informazzjoni aktar dettaljata fil-parametri "PROCESSING.RETURN" u "PROCESSING.RETURN.CODE".
Nirrakkomandaw li tmexxi test għaż-żewġ messaġġi. Għal aktar informazzjoni dwar kif tagħmel test u liema dettalji tal-karta ta 'kreditu tista' tuża għal test, jekk jogħġbok ara hawn taħt.

Proċedura 3D Secure meta tuża l-formola ta 'checkout hPF

Il-formola tal-checkout tal-hPF hija mfassla wkoll biex tuża l-proċedura 3DS diġà. M'hemm l-ebda azzjoni addizzjonali min-naħa tiegħek meħtieġa għall-implimentazzjoni tal-proċedura. Kif deskritt
għall-implimentazzjoni tal-hCO ir-rispons mis-sistema tal-ħlas iseħħ f'żewġ stadji, u huwa għalhekk li s-sistema tiegħek trid tivverifika l-valur tal-PROCESSING.RETURN.CODE
parametru meta tkun qed tipproċessa r-rispons.

Għal dan il-għan għandhom jiġu evalwati l-parametri li ġejjin.

• KODIĊI.RITORN.PROĊESSAR = 000.200.000
• PROCESSING.RETURN = Tranżazzjoni + pendenti
• PROCESSING.RESULT = ACK

Spjegazzjoni: L-istatus tat-tranżazzjoni huwa “pendenti”, il-parametru PROCESSING.RESULT jirrappreżenta biss riżultat preliminari. Sakemm jitwettaq il-proċess 3D Secure, l-istatus
jibqgħu pendenti.

Ir-riżultat finali tat-transazzjoni huwa jew

• KODIĊI.RITORN.PROĊESSAR = 000.000.000
• PROCESSING.RESULT = ACK
  or
• PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 jew 000.200.000
• PROĊESSAR.RIŻULTAT = NOK

Fl-ewwel każ it-tranżazzjoni tlestiet b'suċċess, fit-tieni każ falliet b'mod ġenerali. Dan tal-aħħar jista 'jkollu diversi raġunijiet, inkluż rifjut li jawtentika. Int se
tirċievi informazzjoni aktar dettaljata fil-parametri "PROCESSING.RETURN" u "PROCESSING.RETURN.CODE".
Nirrakkomandaw li tmexxi test għaż-żewġ messaġġi. Għal aktar informazzjoni dwar kif tagħmel test u liema dettalji tal-karta ta 'kreditu tista' tuża għal test, jekk jogħġbok ara hawn taħt.

Proċedura 3D Sikura b'konnessjoni diretta

Jekk ma tużax formola ta ’ħlas ipprovduta minn Unzer (li qabel kienet heidelpay) biex tipproċessa ħlasijiet b’karta ta’ kreditu, jew jekk sempliċement tirreġistra karta billi tuża waħda mill-formoli u tipproċessa l-awtorizzazzjoni minn qabel (riserva) jew id-debitu bħala referenza għar-reġistrazzjoni bħala komunikazzjoni diretta mas-sistema tal-ħlas, trid timplimenta l-proċess 3D Secure.

Fluss ta 'transazzjoni mhux sinkroniku:

Dan huwa proċess mhux sinkroniku li fih is-server tiegħek jirċievi forwarding URL (Redirezzjoni URL) mis-sistema tal-ħlas tagħna. Is-server tiegħek għandu jgħaddi l-klijent lil dan URL sabiex ikun jista 'jwettaq l-awtentikazzjoni permezz tal-proċedura 3D Secure. Ir-riżultat ta 'din l-awtentikazzjoni 3D Secure huwa rrappurtat direttament lil Unzer mill-bank li joħroġ il-karta.

Wara awtentikazzjoni b'suċċess, it-tranżazzjoni tiġi pproċessata aktar fis-sistema Unzer bil-mod kif diġà taf billi tibgħat lis-sistema tiegħek riżultat ġenerali fl-aħħar, li għalih twieġeb
b'direzzjoni mill-ġdid URL. Is-sistema tal-ħlas imbagħad terġa 'tidderieġi l-klijent lura lejn is-sistema tiegħek billi tuża din id-direzzjoni ġdida URL mis-sistema tiegħek

Jekk jogħġbok innota: F'dan il-fluss tax-xogħol is-sistema tiegħek tirċievi żewġ tweġibiet mis-sistema tal-ħlas:

- Waħda bl-istatus "pendenti" (PROCESSING.RETURN.CODE = 000.200.000 u PROCESSING.RETURN = Tranżazzjoni + pendenti) u l-parametri ta 'direzzjoni mill-ġdid lill-bank li joħroġ il-biljett tal-klijent
- Waħda bir-riżultat finali tad-debitu jew riserva. Hemm ukoll żewġ direzzjoni ġdida URLIssemma f'dan il-proċess, waħda mis-sistema tal-ħlas li għaliha l-klijent irid jiġi dirottat biex jawtentika fil-bank li joħroġ il-karta tiegħu u waħda mis-sistema tiegħek, meta tirċievi r-riżultat finali, biex terġa 'tidderieġi l-klijent lura fis-sistema tiegħek.

Il-bidliet li ġejjin se jsiru fil-proċedura regolari. Jekk jogħġbok innota li minħabba l-implimentazzjoni ta 'metodi oħra ta' ħlas mhux sinkroniċi, bħal Paypal, uħud minn dawn
proċessi jistgħu diġà jeżistu fl-implimentazzjoni tiegħek.

1. Rispons URL
   Fl-ewwel sejħa (nru 2 fid-dijagramma) għas-sistema tal-ħlas, “Rispons URL”Trid tgħaddi fil-grupp ta’ frontend.
   
   Jekk jogħġbok innota: Il-parametru IDENTIFICATION.REFERENCEID huwa rilevanti biss jekk tirreferi għal reġistrazzjoni jew tranżazzjoni oħra diġà eżistenti
2. Redirezzjoni tal-Ipproċessar URL Jekk tkun meħtieġa awtentikazzjoni, direzzjoni ġdida URL u parametri oħra fil-grupp ta 'direzzjoni ġdida huma ttrasferiti fir-risposta mis-sistema tal-ħlas (Nru 5 fid-dijagramma).
   
   
3. Tressiq tal-klijent għar-ridirezzjoni URL
   Jekk il-grupp ta 'direzzjoni ġdida qed jirrispondi b'rindirezzjoni URL, il-browser tal-klijent irid jiġi dirottat lejn dan URL (Nru 6 fid-dijagramma) biex twettaq awtentikazzjoni. Il-parametri addizzjonali mill-grupp ta 'direzzjoni ġdida għandhom jiġu trasferiti għall-estern websit bħala parametri POST.
   Jekk jogħġbok innota: Parametri addizzjonali jiġu rritornati fil-grupp "PROCESSING.REDIRECT.xxx" biss bi 3D Secure Version 1 (anke hemm in-numru u l-ismijiet jistgħu jvarjaw), filwaqt li bit-3D Version 2 PROCESSING.REDIRECT biss.URL kif muri hawn taħt huwa rritornat: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
   CCF / run Dan ifisser li irrispettivament mit-tip u n-numru ta 'parametri, il-browser tal-klijent irid idawwru lejn il-PROCESSING.REDIRECT.URL.
   Hawn taħt għandek issib kodiċi sempliċi example ta 'kif redirezzjoni bħal din tista' tiġi eżegwita. Il parti hija maħsuba biex tinforma lill-konsumaturi finali li s-sistemi tagħhom ma jappoġġjawx Javascript jew li għandhomha diżattivata. Nirrakkomandaw bil-qawwa li r-redirezzjoni ssir fit-tieqa tal-browser attiv tal-klijent u li ma tużax twieqi pop up jew twieqi ġodda tal-browser, għax dan jista '
   jirrita l-klijenti u jwassalhom biex jagħlqu l-paġna li huma diretti lejnha.
   
4. Kontroll tar-riżultat mhux sinkroniku
   Ir-riżultat tal-awtentikazzjoni jintbagħat b'mod mhux sinkroniku lis-server tiegħek. Is-sistema tal-ħlas tistenna valida URL bħala risposta. (Nru 12 & 13 fid-dijagramma). Għal suċċess jew miċħuda
   pagamenti, differenti URL tista 'tingħata risposta hawnhekk mis-sistema tiegħek.
5. It-triq tar-ritorn tal-klijent
   Is - sistema tal - ħlas terġa 'tidderieġi l - klijent lejn il - URL ipprovdut mis-sistema tan-negozjant wara li l-proċess ta ’awtentikazzjoni u t-tranżazzjoni ta’ ħlas ikunu tlestew.
   Jekk jogħġbok innota: Il-Passi 4.) u 5.) ipproċedi eżattament bl-istess mod kif diġà familjari miegħu fi transazzjonijiet NONE 3D Secure eżistenti.

Ħlas Sikur u Rikorrenti 3D

Mill-1 ta 'Jannar 2021, 3D Secure se jkun obbligatorju għat-tranżazzjonijiet kollha tal-kards tal-kummerċ elettroniku. Madankollu, peress li dan bilkemm huwa applikabbli għal pagamenti rikorrenti, il-banek
is-sistemi għandhom fluss tax-xogħol separat għal dan.

Għal dan il-għan, il-banek jiddistingwu bejn

• CIT = tranżazzjonijiet inizjalizzati mill-klijent
• MIT = transazzjonijiet inizjalizzati min-negozjant

L-ewwel tranżazzjoni ta 'karta fil-kont tan-negozjant tiegħek għandha tkun awtentikata bi 3D Secure mill-01.01.2021' il quddiem. Tali awtentikazzjoni b'suċċess hija ħtieġa obbligatorja fl - XNUMX
sabiex tkun tista 'sussegwentement tissottometti aktar prenotazzjonijiet fuq l-istess karta mingħajr 3D Secure. Il-klijent għandu għalhekk jintbagħat lill-bank tal-ħruġ tal-kard tiegħu għall-ewwel debitu
skond il-proċedura deskritta hawn fuq u jawtentika lilu nnifsu hemm bħala d-detentur tal-karta. Jekk debitu mhux ippjanat fil-ħin tal-ordni, eżampminħabba perjodu ta ’prova, minflok trid issir riservazzjoni (awtorizzazzjoni minn qabel) ta’ mill-inqas ewro bi 3D Secure fil-preżenza tal-klijent. Il-qbid ta 'din ir-riżerva mhuwiex meħtieġ.

Għall-klijenti eżistenti, madankollu, l-ebda awtentikazzjoni 3D Secure ma għandha tkun magħmula. Jekk l-ewwel debitu ta 'suċċess seħħ qabel l-01.01.2021, ir-rekord tal-klijent jista' jkun preżunt ukoll li
ġew awtentikati b'suċċess. Għal klijenti ġodda mill-01.01.2021, min-naħa l-oħra, l-awtentikazzjoni 3D Secure hija obbligatorja għall-ewwel debitu jew riservazzjoni (preautorizzazzjoni).

Jekk jogħġbok innota: F'dan ir-rigward, is-sistema bankarja tħares lejn id-dejta tal-karta, mhux id-dejta tal-klijent. Mela jekk klijent eżistenti juża kard ġdida wara l-01.01.2021, eżample għax il-preċedenti
wieħed skada jew għax biddel il-bank li joħroġ il-karta tiegħu, dan huwa ċiklu ġdid rikorrenti mill-punt tal-banek ta ' view u jridu jiġu awtentikati bi 3D Secure għall-ewwel prenotazzjoni.

Ladarba din l-awtentikazzjoni inizjali tkun twettqet b'suċċess, it-tranżazzjonijiet l-oħra kollha huma eżentati mill-obbligu li tuża 3D Secure Il-prerekwiżiti għal ħlas rikorrenti mingħajr 3D Secure huma għalhekk:

• Hemm mill-inqas debitu jew riservazzjoni waħda b'suċċess (pre-awtorizzazzjoni) li jew twettqet bi 3D Secure jew saret qabel l-01.01.2021.
• hija referenzjata għal reġistrazzjoni u debitu eżistenti mal-preżentazzjoni

Biex tgħarraf lis-sistema tal-ħlas, li dan huwa ħlas rikorrenti, il-parametru RECURRENCE.MODE = RIPETIT għandu jintbagħat ukoll. Dan jindika lis-sistema li a
ħlas rikorrenti għandu jiġi rrappurtat lis-sistemi bankarji.

Jekk jogħġbok innota: Jekk il-parametru RECURRENCE.MODE = REPETED jiddaħħal meta titgħabba karta ġdida għall-ewwel darba, it-twassil 3D Secure jitwettaq minkejja dan il-parametru.

Ittestjar tal-implimentazzjoni 3D Secure

Tista 'tittestja l-konnessjoni 3D Secure fi kwalunkwe ħin permezz tas-sistema tal-ħlas tagħna. Biex tagħmel dan, uża l-modalità "CONNECTOR_TEST" għal transazzjoni, kif muri fl-examples hawn fuq.
Dejta tal-konnessjoni għal dan it-test:

SIGURTÀ	31HA07BC8142C5A171745D00AD63D182
UŻU LOGIN	31ha07bc8142c5a171744e5aef11ffd3
USER.PWD	93167DE7
TRANSACTION.KHANNEL	31HA07BC8142C5A171749A60D979B6E4
Muniti kkonfigurati għal 3D Verżjoni 2	EUR, USD, SEK
Muniti kkonfigurati għal 3D Verżjoni 1	GBP, CZK, CHF

Il-punt tat-tmiem tal-portal tas-sistema huwa jew
Gateway SGW:
- https://test-heidelpay.hpcgw.net/sgw/gtw - Latin-15 kodifikat
- https://test-heidelpay.hpcgw.net/sgw/gtwu - UTF-8 ikkodifikat
Bieb NGW:
- https://test-heidelpay.hpcgw.net/ngw/post

Data tal-karta tal-kreditu għal dan it-test:

marki	numri tal-karti	CVV	data ta' skadenza	nota
MasterCard	5453010000059543	123	data futura	3D - password: sigriet3
Viża	4711100000000000	123	data futura	3DS - password: sigriet! 33

Jekk jogħġbok innota: Għal 3D Secure Version 2, m'għandekx bżonn tiddaħħal password, imma sempliċement ikklikkja fuq il-link "Ikklikkja hawn biex tlesti l-awtentikazzjoni.
L-uniku mod biex tissimula żball bi 3D Secure Version 2 huwa li tħalli l-paġna bil-link time out (madwar 18-il minuta).

 

Aqra Aktar Dwar Dan il-Manwal u Niżżel il-PDF:

Dokumenti / Riżorsi

Gwida għall-Integrazzjoni Sikura tas-Softwares 3D [pdfDokumentazzjoni Unzer, Gwida għall-Integrazzjoni, 3D Secure

Referenzi

• Manwal għall-Utent