Hugbúnaður 3D Secure Integration Guide Skjalagerð
Sameiningarleiðbeining 3D örugg
Frá 01.01.2021 um tvíþætta auðkenningu verður hrint í framkvæmd sem lögboðin krafa fyrir allar viðskipti með netkortakort. Til þess að uppfylla þessa skuldbindingu hefur hæstv
rekstraraðilar kreditkortaneta munu nota svokallaða 3D Secure aðferð. Fyrir þig sem kaupmann er skylt að geta framkvæmt þessa aðferð fyrir viðskiptavini þína frá
01.01.2021. Hér á eftir finnurðu lýsingu á mismunandi aðferðum við samþættingu og hvernig 3D Secure verklagið þarf að innleiða fyrir þá.
Veldu samþættingaraðferðina sem þú notar
- Ertu að nota kassaformið hCO?
- Ertu að nota kassaformið hPF?
- Vinnur þú greiðslur án þess að nota eyðublað frá Unzer kerfinu?
Vinsamlegast athugið: Það er einnig mikilvægt á hvern hátt skuldfærslur eða forheimildir (fyrirvarar) eru gerðar. Jafnvel ef þú notar greiðsluform frá Unzer GmbH til skráningar kortagagna, verður 3D Secure ferlið framkvæmt án útritunarforms þegar kortagögnin eru fyrst skuldfærð eða heimiluð í fyrsta skipti. Í þessu tilfelli gildir þriðja leiðin til aðlögunar án eyðublaðs sem Unzer veitir.
Vinsamlegast athugið einnig:
Ef þú notar endurteknar greiðslur (áskriftargreiðslur), vertu viss um að lesa hlutann „Þrívíddar og endurteknar greiðslur“.
3D Secure málsmeðferð þegar þú notar hCO útritunarformið
HCO útritunarformið er þegar hannað fyrir 3D Secure aðferðina. Það er engin viðbótaraðgerð frá þinni hálfu nauðsynleg fyrir framkvæmd málsmeðferðarinnar. Hins vegar, þú
verðu að ganga úr skugga um að kerfið þitt ráði við samsvarandi svör greiðslukerfisins okkar ef 3D Secure ferli er hafin. Í ósamstilltu svari frá
greiðslukerfi til netþjóns þíns, er niðurstaðan af viðskiptunum send og verður að meta þar áður en skilað er URL er sent til greiðslukerfisins.
Í þessu skyni verður að meta eftirfarandi breytur.
- VINNSLUN.RETURN.CODE = 000.200.000
- PROCESSING.RETURN = Viðskipti + í bið
- VINNA.RESULT = ACK
Skýring: Staða viðskiptanna er „í bið“, breytan VINSLUN.RESULT
táknar aðeins bráðabirgðaniðurstöðu. Svo lengi sem 3D Secure ferli er framkvæmt, staðan
áfram í bið.
Lokaniðurstaða viðskiptanna er þá hvort sem er
- VINNSLUN.RETURN.CODE = 000.000.000
- VINNA.RESULT = ACK
or - Vinnsla.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- VINNSLA.RESULTAT = NOK
Í fyrra tilvikinu hefur tekist að ljúka viðskiptunum, í öðru tilvikinu tókst það ekki. Síðarnefndu geta haft ýmsar ástæður, þar á meðal synjun á staðfestingu. Þú munt
fáðu nánari upplýsingar í breytunum „VINSLA.RETURN“ og „VINNA. RETURN.KODA“.
Við mælum með að þú keyrir próf fyrir bæði skilaboðin. Nánari upplýsingar um hvernig á að gera próf og hvaða kreditkortaupplýsingar þú getur notað við próf, vinsamlegast sjáðu hér að neðan.
3D Secure málsmeðferð þegar þú notar hPF útritunarformið
HPF útritunarformið er einnig hannað til að nota 3DS aðferðina þegar. Það er engin viðbótaraðgerð frá þinni hálfu nauðsynleg fyrir framkvæmd málsmeðferðarinnar. Eins og lýst er
fyrir hCO útfærsluna fara viðbrögðin frá greiðslukerfinu fram í tveimur skrefum og þess vegna verður kerfið þitt að athuga gildi VINNSLUNAR.RETURN.CODE
breytu við vinnslu svörunar.
Í þessu skyni verður að meta eftirfarandi breytur.
- VINNSLUN.RETURN.CODE = 000.200.000
- PROCESSING.RETURN = Viðskipti + í bið
- VINNA.RESULT = ACK
Skýring: Staða viðskiptanna er „í bið“, breytan VINNSLUN.RESULT táknar aðeins bráðabirgðaniðurstöðu. Svo lengi sem 3D Secure ferli er framkvæmt, staðan
áfram í bið.
Lokaniðurstaða viðskiptanna er þá hvort sem er
- VINNSLUN.RETURN.CODE = 000.000.000
- VINNA.RESULT = ACK
or - Vinnsla.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- VINNSLA.RESULTAT = NOK
Í fyrra tilvikinu hefur tekist að ljúka viðskiptunum, í öðru tilvikinu tókst það ekki. Síðarnefndu geta haft ýmsar ástæður, þar á meðal synjun á staðfestingu. Þú munt
fáðu nánari upplýsingar í breytunum „VINSLA.RETURN“ og „VINNA. RETURN.KODA“.
Við mælum með að þú keyrir próf fyrir bæði skilaboðin. Nánari upplýsingar um hvernig á að gera próf og hvaða kreditkortaupplýsingar þú getur notað við próf, vinsamlegast sjáðu hér að neðan.
3D Secure málsmeðferð með beinni tengingu
Ef þú notar ekki greiðsluform frá Unzer (áður heidelpay) til að vinna úr kreditkortagreiðslum, eða ef þú einfaldlega skráir kort með því að nota eitt af eyðublöðunum og vinnur fyrir heimildina (pöntunina) eða debet sem tilvísun í skráninguna sem bein samskipti við greiðslukerfið, þú verður að innleiða 3D Secure ferlið.
Ósamstilltur viðskiptaflæði:
Þetta er ósamstilltur ferill þar sem netþjónn þinn fær framsendingu URL (Áframsenda URL) úr greiðslukerfinu okkar. Netþjóninn þinn verður að framsenda viðskiptavininn á þetta URL svo að hann geti framkvæmt sannvottunina með 3D Secure aðferð. Niðurstaðan af þessari 3D Secure auðkenningu er tilkynnt Unzer af kortafyrirtækinu.
Eftir auðkenningu er unnið frekar úr viðskiptunum í Unzer kerfinu á þann hátt sem þú þekkir þegar með því að senda kerfinu heildarniðurstöðu í lokin sem þú svarar
með tilvísun URL. Greiðslukerfið vísar viðskiptavinnum síðan aftur til kerfisins þíns með því að nota þessa áframsendingu URL úr kerfinu þínu
Athugið: Í þessu vinnuflæði fær kerfið tvö svör frá greiðslukerfinu:
- Einn með stöðuna „í bið“ (PROCESSING.RETURN.CODE = 000.200.000 og PROCESSING.RETURN = Færsla + í bið) og endurvígunarfæribreytur til kortaútgáfu banka viðskiptavinarins
- Ein með lokaniðurstöðu skuldfærslu eða fyrirvara. Það eru líka tvær tilvísanir URLer getið í þessu ferli, eitt frá greiðslukerfinu sem viðskiptavinurinn þarf að vera vísað til til að staðfesta við útgáfu bankans síns og einn frá kerfinu þínu, þegar hann fær endanlega niðurstöðu, til að beina viðskiptavininum aftur inn í kerfið þitt.
Eftirfarandi breytingar verða gerðar á venjulegu verklagi. Vinsamlegast athugaðu að vegna innleiðingar annarra ósamstilltra greiðslumáta, svo sem Paypal, eru sum þessara
ferli geta þegar verið til staðar í framkvæmdinni.
- Svar URL
Í fyrsta símtalinu (nr. 2 á skýringarmynd) til greiðslukerfisins, „Svar URL“Verður að fara í framendahópinn.
Vinsamlegast athugið: IDENTIFICATION.REFERENCEID breytan á aðeins við ef þú vísar til skráningar eða annarra viðskipta sem þegar eru til staðar - Vinnsla tilvísunar URL Ef staðfesting er krafist, tilvísun URL og aðrar breytur í tilvísunarhópnum eru fluttar í svari frá greiðslukerfinu (nr. 5 á skýringarmynd).
- Áframsending viðskiptavinarins til áframsendingar URL
Ef tilvísunarhópurinn er að svara með tilvísun URL, verður að beina vafra viðskiptavinarins á þetta URL (Nr. 6 á skýringarmyndinni) til að framkvæma auðkenningu. Viðbótarfæribreyturnar úr tilvísunarhópnum þarf að flytja yfir á ytri websíða sem POST færibreytur.
Vinsamlegast athugið: Viðbótar breytum er skilað í hópnum „VINNUN.RÁÐRÁÐ.xxx“ aðeins með 3D Secure útgáfu 1 (jafnvel þar getur fjöldi og nafngift verið breytilegur), en með 3D útgáfu 2 aðeins VINNSLU.URL eins og sýnt er hér að neðan er skilað: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run Þetta þýðir að án tillits til tegundar og fjölda breytu verður viðskiptavinur vafra að vísa til VINSLUN.RÉTTIR.URL.
Hér að neðan finnurðu einfaldan kóða tdampLeiðsögn um hvernig hægt er að framkvæma slíka tilvísun. The Hlutinn er ætlaður til að upplýsa endaviðskiptavini sem hafa kerfi sem styðja ekki Javascript eða hafa það óvirkt. Við mælum eindregið með því að tilvísunin fari fram í virkum vafraglugga viðskiptavinarins og að nota ekki sprettiglugga eða nýja vafraglugga, þar sem það gæti
pirra viðskiptavini og leiða þá til að loka síðunni sem þeim er vísað á.
- Ósamstilltur niðurstaðnaathugun
Niðurstaðan af sannvottuninni er send ósamstillt á netþjóninn þinn. Greiðslukerfið gerir ráð fyrir gildi URL sem svar. (Nr. 12 og 13 á skýringarmyndinni). Fyrir vel heppnað eða hafnað
greiðslur, annað URL hægt er að svara hér með kerfinu þínu. - Skilaleið viðskiptavinarins
Greiðslukerfið vísar viðskiptavininum á URL útvegað af kerfi kaupmannsins eftir að auðkenningarferlinu og greiðslufærslunni er lokið.
Vinsamlegast athugaðu: Skref 4.) og 5.) fara nákvæmlega á sama hátt og þú þekkir nú þegar í engum 3D Secure viðskiptum.
3D örugg og endurtekin greiðsla
Frá og með 1. janúar 2021 verður 3D Secure lögboðið fyrir öll viðskipti með netkort. Hins vegar, þar sem þetta á varla við um endurteknar greiðslur, bankastarfsemi
kerfi hafa sérstakt vinnuferli fyrir þetta.
Í þessu skyni gera bankarnir greinarmun á
- CIT = viðskiptin sem eru frumstillt af viðskiptavini
- MIT = viðskiptin frumstýrð viðskipti
Fyrsta viðskipti korts á söluaðilareikningnum þínum verður að vera staðfest með 3D Secure frá og með 01.01.2021. Svo vel auðkenning er lögboðin krafa í
til að geta síðan sent inn frekari bókanir á sama korti án 3D Secure. Því verður að senda viðskiptavininn til banka síns sem gefur út fyrir fyrstu skuldfærslu í
í samræmi við málsmeðferðina sem lýst er hér að ofan og staðfesta sig þar sem korthafa. Ef skuldfærsla er ekki fyrirhuguð við pöntun, tdampVegna prufutíma þarf að panta (forheimild) að minnsta kosti einni evru með 3D Secure í viðurvist viðskiptavinarins í staðinn. Ekki er nauðsynlegt að handtaka þessa fyrirvara.
Fyrir núverandi viðskiptavini þarf hins vegar ekki að bæta upp 3D Secure auðkenningu. Ef fyrsta árangursríka skuldfærslan átti sér stað fyrir 01.01.2021, má einnig gera ráð fyrir að viðskiptavinametið
hefur verið auðkennd. Fyrir nýja viðskiptavini frá 01.01.2021 er hins vegar 3D Secure auðkenning lögboðin fyrir fyrstu skuldfærslu eða pöntun (forheimild).
Athugið: Að þessu leyti lítur bankakerfið á kortagögnin, ekki gögn viðskiptavina. Þannig að ef núverandi viðskiptavinur notar nýtt kort eftir 01.01.2021, tdample vegna þess að fyrri
einn er útrunninn eða vegna þess að hann hefur skipt um kortaútgáfubanka, þetta er ný endurtekin hringrás frá sjónarhóli bankanna view og verður að vera auðkennt með 3D Secure fyrir fyrstu bókun.
Þegar vel hefur verið staðið að þessari fyrstu staðfestingu eru allar frekari viðskipti undanþegnar skyldunni til að nota 3D Secure Forsendur fyrir endurtekinni greiðslu án 3D Secure eru því:
- Það er að minnsta kosti ein árangursrík skuldfærsla eða fyrirvari (forheimild) sem annað hvort var framkvæmd með 3D Secure eða átti sér stað fyrir 01.01.2021.
- það er vísað til núverandi skráningar og skuldfærslu við skil
Til að láta greiðslukerfið vita, að þetta er endurtekin greiðsla, þarf einnig að senda breytuna RECURRENCE.MODE = REPEATED. Þetta gefur kerfinu merki um að a
Tilkynna á endurteknar greiðslur til bankakerfanna.
Athugið: Ef færibreytan RECURRENCE.MODE = REPEATED er slegin inn þegar nýtt kort er hlaðið í fyrsta skipti mun 3D Secure framsending fara fram þrátt fyrir þessa breytu.
Prófun á 3D Secure útfærslunni
Þú getur prófað 3D Secure tenginguna hvenær sem er í gegnum greiðslukerfið okkar. Til að gera það, notaðu „CONNECTOR_TEST“ haminn fyrir færslu, eins og sýnt er í dæminuamples að ofan.
Tengingargögn fyrir þetta próf:
| ÖRYGGI.SENDUR | 31HA07BC8142C5A171745D00AD63D182 |
| USER.INNskráning | 31ha07bc8142c5a171744e5aef11ffd3 |
| USER.PWD | 93167DE7 |
| VIÐSKIPTI. Rás | 31HA07BC8142C5A171749A60D979B6E4 |
| Gjaldmiðlar stilltir fyrir 3D útgáfu 2 | EUR, USD, SEK |
| Gjaldmiðlar stilltir fyrir 3D útgáfu 1 | GBP, CZK, CHF |
Endapunktur kerfisgáttar er annað hvort
SGW hlið:
- https://test-heidelpay.hpcgw.net/sgw/gtw - Latin-15 kóðuð
- https://test-heidelpay.hpcgw.net/sgw/gtwu - UTF-8 kóðuð
NGW hlið:
- https://test-heidelpay.hpcgw.net/ngw/post
Gögn um kreditkort fyrir þetta próf:
| vörumerki | kortanúmer | CVV | fyrningardagsetning | ath |
| MasterCard | 5453010000059543 | 123 | framtíðardagsetning | 3D - lykilorð: leyndarmál3 |
| Visa | 4711100000000000 | 123 | framtíðardagsetning | 3DS - lykilorð: leyndarmál! 33 |
Vinsamlegast athugaðu: Fyrir 3D Secure útgáfu 2 þarftu ekki að slá inn lykilorð heldur einfaldlega smelltu á hlekkinn “Smelltu hér til að ljúka auðkenningu.
Eina leiðin til að líkja eftir villu með 3D Secure Version 2 er að láta síðuna með krækjunni renna út (u.þ.b. 18 mínútur).
Lestu meira um þessa handbók og halaðu niður PDF:
Skjöl / auðlindir
 |
Leiðbeiningar um 3D örugga samþættingu hugbúnaðar [pdf] Skjölun Unzer, samþættingarleiðbeiningar, 3D Secure |
