Dogfennaeth Canllaw Integreiddio Diogel 3D Softwares
Canllaw Integreiddio 3D Diogel
O 01.01.2021 ar ddilysu dau ffactor yn cael ei weithredu fel gofyniad gorfodol ar gyfer pob trafodiad talu cerdyn e-fasnach. Er mwyn cydymffurfio â'r rhwymedigaeth hon, mae'r
bydd gweithredwyr rhwydweithiau cardiau credyd yn defnyddio'r weithdrefn Ddiogel 3D fel y'i gelwir. I chi fel masnachwr mae'n orfodol gallu cyflawni'r weithdrefn hon ar gyfer eich cwsmeriaid
01.01.2021. Yn y canlynol fe welwch ddisgrifiad o'r gwahanol ffyrdd o integreiddio a sut mae'n rhaid gweithredu'r weithdrefn Ddiogel 3D ar eu cyfer.
Dewiswch y dull integreiddio rydych chi'n ei ddefnyddio
- Ydych chi'n defnyddio'r ffurflen ddesg dalu hCO?
- Ydych chi'n defnyddio'r ffurflen ddesg dalu hPF?
- Ydych chi'n prosesu taliadau heb ddefnyddio ffurflen a ddarperir gan system Unzer?
Nodwch os gwelwch yn dda: Mae hefyd yn bwysig ym mha ffordd y mae debydau neu ragofaliadau (amheuon) yn cael eu gwneud. Hyd yn oed os ydych chi'n defnyddio ffurflen dalu gan Unzer GmbH ar gyfer cofrestru data cardiau, bydd y broses 3D Secure yn cael ei chynnal heb ffurflen ddesg dalu pan fydd data'r cerdyn yn cael ei ddebydu neu ei awdurdodi gyntaf am y tro cyntaf. Yn yr achos hwn mae'r drydedd ffordd o integreiddio heb ffurflen a ddarperir gan Unzer yn berthnasol.
Sylwch hefyd:
Os ydych chi'n defnyddio taliadau cylchol (taliadau tanysgrifio), gwnewch yn siŵr eich bod chi'n darllen yr adran “Taliad Diogel a Chylchol 3D”.
Trefn ddiogel 3D wrth ddefnyddio'r ffurflen ddesg dalu hCO
Mae'r ffurflen ddesg dalu hCO eisoes wedi'i chynllunio ar gyfer y weithdrefn Ddiogel 3D. Nid oes angen cymryd unrhyw gamau ychwanegol o'ch ochr chi ar gyfer gweithredu'r weithdrefn. Fodd bynnag, chi
rhaid i chi sicrhau y gall eich system drin atebion cyfatebol ein system dalu rhag ofn i'r broses Ddiogel 3D gael ei chychwyn. Yn yr ymateb asyncronig o'r
system dalu i'ch gweinydd, trosglwyddir canlyniad y trafodiad a rhaid ei werthuso yno cyn dychwelyd URL yn cael ei drosglwyddo i'r system dalu.
At y diben hwn rhaid gwerthuso'r paramedrau canlynol.
- PROCESSING.RETURN.CODE = 000.200.000
- PROCESSING.RETURN = Trafodiad + yn yr arfaeth
- PROCESSING.RESULT = ACK
Esboniad: Mae statws y trafodiad yn “yr arfaeth”, y paramedr PROCESSING.RESULT
yn cynrychioli canlyniad rhagarweiniol yn unig. Cyn belled â bod y broses 3D Secure yn cael ei chynnal, bydd y statws
aros yn yr arfaeth.
Canlyniad terfynol y trafodiad yw'r naill neu'r llall
- PROCESSING.RETURN.CODE = 000.000.000
- PROCESSING.RESULT = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 aroglau 000.200.000
- PROCESSING.RESULT = NOK
Yn yr achos cyntaf, cwblhawyd y trafodiad yn llwyddiannus, yn yr ail achos mae wedi methu yn gyffredinol. Gall yr olaf fod â nifer o resymau, gan gynnwys gwrthod dilysu. Byddwch chi
derbyn gwybodaeth fanylach yn y paramedrau “PROCESSING.RETURN” a “PROCESSING.RETURN.CODE”.
Rydym yn argymell eich bod yn cynnal prawf ar gyfer y ddwy neges. I gael mwy o wybodaeth ar sut i wneud prawf a pha fanylion cerdyn credyd y gallwch eu defnyddio ar gyfer prawf, gweler isod.
Trefn ddiogel 3D wrth ddefnyddio'r ffurflen ddesg dalu hPF
Mae'r ffurflen ddesg dalu hPF hefyd wedi'i chynllunio i ddefnyddio'r weithdrefn 3DS eisoes. Nid oes angen cymryd unrhyw gamau ychwanegol o'ch ochr chi ar gyfer gweithredu'r weithdrefn. Fel y disgrifiwyd
ar gyfer gweithredu hCO mae'r ymateb o'r system dalu yn digwydd mewn dau gam, a dyna pam mae'n rhaid i'ch system wirio gwerth y PROCESSING.RETURN.CODE
paramedr wrth brosesu'r ymateb.
At y diben hwn rhaid gwerthuso'r paramedrau canlynol.
- PROCESSING.RETURN.CODE = 000.200.000
- PROCESSING.RETURN = Trafodiad + yn yr arfaeth
- PROCESSING.RESULT = ACK
Esboniad: Mae statws y trafodiad yn “yr arfaeth”, dim ond canlyniad rhagarweiniol yw'r paramedr PROCESSING.RESULT. Cyn belled â bod y broses 3D Secure yn cael ei chynnal, bydd y statws
aros yn yr arfaeth.
Canlyniad terfynol y trafodiad yw'r naill neu'r llall
- PROCESSING.RETURN.CODE = 000.000.000
- PROCESSING.RESULT = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 aroglau 000.200.000
- PROCESSING.RESULT = NOK
Yn yr achos cyntaf, cwblhawyd y trafodiad yn llwyddiannus, yn yr ail achos mae wedi methu yn gyffredinol. Gall yr olaf fod â nifer o resymau, gan gynnwys gwrthod dilysu. Byddwch chi
derbyn gwybodaeth fanylach yn y paramedrau “PROCESSING.RETURN” a “PROCESSING.RETURN.CODE”.
Rydym yn argymell eich bod yn cynnal prawf ar gyfer y ddwy neges. I gael mwy o wybodaeth ar sut i wneud prawf a pha fanylion cerdyn credyd y gallwch eu defnyddio ar gyfer prawf, gweler isod.
Trefn ddiogel 3D gyda chysylltiad uniongyrchol
Os na ddefnyddiwch ffurflen dalu a ddarparwyd gan Unzer (heidelpay gynt) i brosesu taliadau cardiau credyd, neu os ydych chi'n syml yn cofrestru cerdyn gan ddefnyddio un o'r ffurflenni ac yn prosesu'r rhag-awdurdodi (archebu) neu'r debyd fel cyfeiriad at y cofrestriad fel a cyfathrebu uniongyrchol â'r system dalu, rhaid i chi weithredu'r broses Ddiogel 3D.
Llif trafodion asyncronig:
Mae hon yn broses asyncronig lle mae'ch gweinydd yn derbyn anfon ymlaen URL (Ailgyfeirio URL) o'n system dalu. Rhaid i'ch gweinydd anfon y cwsmer ymlaen at hyn URL fel y gall gyflawni'r dilysiad trwy weithdrefn 3D Secure. Mae canlyniad y dilysiad 3D Diogel hwn yn cael ei adrodd yn uniongyrchol i Unzer gan y banc cyhoeddi cardiau.
Ar ôl dilysu’n llwyddiannus, caiff y trafodiad ei brosesu ymhellach yn system Unzer yn y ffordd rydych chi eisoes yn gwybod trwy anfon canlyniad cyffredinol at eich system ar y diwedd, ac rydych chi'n ymateb iddo
gydag ailgyfeiriad URL. Yna bydd y system dalu yn ailgyfeirio'r cwsmer yn ôl i'ch system gan ddefnyddio'r ailgyfeiriad hwn URL o'ch system
Sylwch: Yn y llif gwaith hwn mae eich system yn derbyn dau ateb gan y system dalu:
- Un sydd â'r statws “yn yr arfaeth” (PROCESSING.RETURN.CODE = 000.200.000 a PROCESSING.RETURN = Trafodiad + yn yr arfaeth) a'r paramedrau ailgyfeirio i fanc y cwsmer sy'n rhoi cardiau
- Un gyda chanlyniad terfynol y debyd neu'r archeb. Mae dau ailgyfeirio hefyd URLs a grybwyllir yn y broses hon, un o'r system dalu y mae'n rhaid ailgyfeirio'r cwsmer iddi i'w dilysu yn ei fanc cyhoeddi cardiau heb un o'ch system, wrth dderbyn y canlyniad terfynol, i ailgyfeirio'r cwsmer yn ôl i'ch system.
Gwneir y newidiadau canlynol i'r weithdrefn reolaidd. Sylwch, oherwydd gweithredu dulliau talu asyncronig eraill, fel Paypal, rhai o'r rhain
gall prosesau fodoli eisoes wrth weithredu.
- Ymateb URL
Yn yr alwad gyntaf (rhif 2 yn y diagram) i'r system dalu, “Ymateb URLRhaid pasio yn y grŵp frontend.
Nodwch os gwelwch yn dda: Mae'r paramedr IDENTIFICATION.REFERENCEID yn berthnasol dim ond os ydych chi'n cyfeirio at gofrestriad neu drafodiad arall sydd eisoes yn bodoli - Ailgyfeirio Prosesu URL Os oes angen dilysu, ailgyfeiriwch URL a throsglwyddir paramedrau eraill yn y grŵp ailgyfeirio yn yr ymateb o'r system dalu (Rhif 5 yn y diagram).
- Anfon y cwsmer ymlaen i'r ailgyfeirio URL
Os yw'r grŵp ailgyfeirio yn ymateb gydag ailgyfeiriad URL, rhaid ailgyfeirio porwr y cwsmer i hyn URL (Rhif 6 yn y diagram) i berfformio dilysiad. Rhaid trosglwyddo'r paramedrau ychwanegol o'r grŵp ailgyfeirio i'r allanol websafle fel paramedrau POST.
Sylwch: Dychwelir paramedrau ychwanegol yn y grŵp “PROCESSING.REDIRECT.xxx” yn unig gyda Fersiwn Ddiogel 3D 1 (hyd yn oed yno gall y nifer a'r enwi amrywio), ond gyda Fersiwn 3D 2D yn unig PROCESSING.REDIRECT.URL fel y dangosir isod yn cael ei ddychwelyd: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run Mae hyn yn golygu, waeth beth yw math a nifer y paramedrau, rhaid i'r porwr cleient ailgyfeirio i'r PROCESSING.REDIRECT.URL.
Isod fe welwch god syml example sut y gellir gweithredu ailgyfeiriad o'r fath. Mae'r bwriad rhan yw hysbysu cwsmeriaid terfynol nad yw eu systemau'n cefnogi Javascript neu sydd ag anabledd. Rydym yn argymell yn gryf bod yr ailgyfeirio yn cael ei wneud o fewn ffenestr porwr gweithredol y cwsmer ac i beidio â defnyddio ffenestri naid na ffenestri porwr newydd, gan y gallai hyn
cythruddo cwsmeriaid a'u harwain i gau'r dudalen y maent yn cael ei hailgyfeirio iddi.
- Gwiriad canlyniad asyncronig
Anfonir canlyniad y dilysiad yn anghymesur i'ch gweinydd. Mae'r system dalu yn disgwyl dilys URL fel ymateb. (Rhif 12 a 13 yn y diagram). Am lwyddiannus neu wedi'i wrthod
taliadau, a gwahanol URL gall eich system ymateb yma. - Dychwelwch lwybr y cwsmer
Mae'r system dalu yn ailgyfeirio'r cwsmer i'r URL a ddarperir gan system y masnachwr ar ôl i'r broses ddilysu a'r trafodiad talu gael eu cwblhau.
Sylwch: Camau 4.) a 5.) ewch ymlaen yn union yr un ffordd ag yr ydych eisoes yn gyfarwydd â hwy mewn trafodion DIM 3D Diogel presennol.
Taliad Diogel a Chylchol 3D
O'r 1af o Ionawr 2021, bydd 3D Secure yn orfodol ar gyfer pob trafodiad cerdyn e-fasnach. Fodd bynnag, gan mai prin y mae hyn yn berthnasol ar gyfer taliadau cylchol, y bancio
mae gan systemau lif gwaith ar wahân ar gyfer hyn.
At y diben hwn, mae'r banciau'n gwahaniaethu rhwng
- CIT = trafodion cychwynnol gan gwsmeriaid
- MIT = trafodion cychwynnol masnachwr
Rhaid dilysu trafodiad cyntaf cerdyn yn eich cyfrif masnachwr gyda 3D Secure o 01.01.2021 ymlaen. Mae dilysiad llwyddiannus o'r fath yn ofyniad gorfodol yn
er mwyn gallu cyflwyno archebion pellach ar yr un cerdyn heb 3D Secure. Felly mae'n rhaid i'r cwsmer gael ei anfon ymlaen i'w fanc cyhoeddi cardiau ar gyfer y debyd cyntaf yn
yn unol â'r weithdrefn a ddisgrifir uchod a dilysu ei hun yno fel deiliad y cerdyn. Os nad yw debyd wedi'i gynllunio ar adeg y gorchymyn, ar gyfer exampoherwydd cyfnod prawf, rhaid archebu (cyn-awdurdodi) o leiaf un ewro gyda 3D Secure ym mhresenoldeb y cwsmer yn lle. Nid oes angen dal yr archeb hon.
Fodd bynnag, ar gyfer cwsmeriaid presennol, nid oes angen gwneud unrhyw ddilysiad 3D Diogel. Os digwyddodd y debyd llwyddiannus cyntaf cyn 01.01.2021, gellir tybio bod cofnod y cwsmer hefyd
wedi cael eu dilysu'n llwyddiannus. Ar gyfer cwsmeriaid newydd ar 01.01.2021, ar y llaw arall, mae dilysu 3D Secure yn orfodol ar gyfer y debyd neu'r archeb gyntaf (cyn-awdurdodi).
Sylwch: Yn hyn o beth, mae'r system fancio yn edrych ar y data cardiau, nid y data cwsmeriaid. Felly os yw cwsmer presennol yn defnyddio cerdyn newydd ar ôl 01.01.2021, ar gyfer cynample oherwydd bod y blaenorol
mae un wedi dod i ben neu oherwydd ei fod wedi newid ei fanc cyhoeddi cardiau, mae hwn yn gylch cylchol newydd o bwynt y banciau view a rhaid ei ddilysu gyda 3D Secure ar gyfer yr archeb gyntaf.
Ar ôl i'r dilysiad cychwynnol hwn gael ei gyflawni'n llwyddiannus, mae'r holl drafodion pellach wedi'u heithrio o'r rhwymedigaeth i ddefnyddio 3D Secure Y rhagofynion ar gyfer taliad cylchol heb 3D Secure felly yw:
- Mae o leiaf un debyd neu archeb lwyddiannus (cyn-awdurdodi) a gynhaliwyd naill ai gyda 3D Secure neu a ddigwyddodd cyn 01.01.2021.
- mae'n cael ei gyfeirio at gofrestriad a debyd presennol wrth ei gyflwyno
Er mwyn rhoi gwybod i'r system dalu, mai taliad cylchol yw hwn, rhaid anfon y paramedr RECURRENCE.MODE = AILGYLCHU hefyd. Mae hyn yn arwydd i'r system bod a
mae taliadau cylchol i'w riportio i'r systemau bancio.
Sylwch: Os yw'r paramedr RECURRENCE.MODE = AILGYLCHU yn cael ei nodi pan fydd cerdyn newydd yn cael ei lwytho am y tro cyntaf, bydd anfon 3D Secure yn cael ei anfon er gwaethaf y paramedr hwn.
Profi'r gweithrediad 3D Diogel
Gallwch chi brofi'r cysylltiad 3D Diogel ar unrhyw adeg trwy ein system dalu. I wneud hynny, defnyddiwch y modd “CONNECTOR_TEST” ar gyfer trafodiad, fel y dangosir yn y cynamples uchod.
Data cysylltiad ar gyfer y prawf hwn:
| DIOGELWCH.SENDER | 31HA07BC8142C5A171745D00AD63D182 |
| DEFNYDDWYR.LOGIN | 31ha07bc8142c5a171744e5aef11ffd3 |
| DEFNYDDWYR.PWD | 93167DE7 |
| TRAWSNEWID.CHANNEL | 31HA07BC8142C5A171749A60D979B6E4 |
| Arian wedi'i ffurfweddu ar gyfer Fersiwn 3D 2D | EUR, USD, SEK |
| Arian wedi'i ffurfweddu ar gyfer Fersiwn 3D 1D | GBP, CZK, CHF |
Endpoint porth system yw naill ai
Porth SGW:
- https://test-heidelpay.hpcgw.net/sgw/gtw - Lladin-15 wedi'i amgodio
- https://test-heidelpay.hpcgw.net/sgw/gtwu - UTF-8 wedi'i amgodio
Porth NGW:
- https://test-heidelpay.hpcgw.net/ngw/post
Data cardiau credyd ar gyfer y prawf hwn:
| brandiau | rhifau cardiau | CVV | dyddiad dod i ben | nodyn |
| Cerdyn Meistr | 5453010000059543 | 123 | dyddiad yn y dyfodol | 3D - cyfrinair: secret3 |
| Fisa | 4711100000000000 | 123 | dyddiad yn y dyfodol | 3DS - cyfrinair: cyfrinach! 33 |
Sylwch: Ar gyfer Fersiwn Ddiogel 3D 2D, nid oes angen i chi nodi cyfrinair, ond cliciwch ar y ddolen ”Cliciwch yma i gwblhau dilysiad.
Yr unig ffordd i efelychu gwall gyda Fersiwn Ddiogel 3D 2D yw gadael i'r dudalen gyda'r amser cyswllt ddod allan (tua 18 munud).
Darllenwch Fwy Am y Llawlyfr Hwn a Lawrlwythwch PDF:
Dogfennau / Adnoddau
 |
Canllaw Integreiddio Diogel 3D Softwares [pdfDogfennaeth Unzer, Canllaw Integreiddio, 3D Diogel |
