Lojisyèl 3D Tache Gid Entegrasyon Dokimantasyon
Entegrasyon Gid 3D Tache
Soti nan 01.01.2021 sou de-faktè otantifikasyon yo pral aplike kòm yon kondisyon obligatwa pou tout tranzaksyon peman èkomèrs kat. Yo nan lòd yo konfòme yo avèk obligasyon sa a,
operatè nan rezo kat kredi yo pral itilize sa yo rele pwosedi a 3D Tache. Pou ou kòm yon komèsan li se obligatwa pou kapab pote soti nan pwosedi sa a pou kliyan ou soti nan
01.01.2021. Nan sa ki annapre yo ou pral jwenn yon deskripsyon sou diferan fason yo nan entegrasyon ak ki jan pwosedi a 3D Tache dwe aplike pou yo.
Tanpri chwazi metòd entegrasyon ou itilize
- Èske w ap itilize hCO fòm kesye a?
- Èske w ap itilize fòm nan kesye hPF?
- Èske ou trete peman san ou pa itilize yon fòm sistèm Unzer bay la?
Tanpri sonje: Li enpòtan tou nan ki fason debi oswa preautorizasyon (rezèvasyon) yo te fè. Menm si ou itilize yon fòm peman soti nan Unzer GmbH pou enskripsyon an nan done kat, yo pral pwosesis la 3D Tache dwe te pote soti san yo pa yon fòm kesye lè done yo kat yo premye debite oswa otorize la pou premye fwa. Nan ka sa a fason nan twazyèm nan entegrasyon san yo pa yon fòm ki ofri pa Unzer aplike.
Tanpri sonje tou:
Si ou itilize peman renouvlab (peman abònman), asire w ke ou li seksyon an "3D Tache ak Peman renouvlab".
3D Pwosedi Tache lè w ap itilize fòm nan kesye hCO
Fòm kesye hCO deja fèt pou pwosedi 3D Secure. Pa gen okenn aksyon adisyonèl ki soti nan bò kote ou ki nesesè pou aplikasyon an nan pwosedi a. Sepandan, ou menm
gen asire w ke sistèm ou an ka okipe repons ki koresponn lan nan sistèm peman nou an nan ka se pwosesis la 3D Tache te kòmanse. Nan repons lan asenkron soti nan la
sistèm peman sèvè ou, se rezilta tranzaksyon an transmèt epi yo dwe evalye la anvan yon retou URL transmèt nan sistèm peman an.
Pou rezon sa a paramèt sa yo dwe evalye.
- PWOSÈ.KÒD RETOUR = 000.200.000
- PROCESSING.RETURN = Tranzaksyon + annatant
- PROCESSING.RESULT = ACK
Eksplikasyon: estati tranzaksyon an se "annatant", paramèt PROCESSING.RESULT la
reprezante sèlman yon rezilta preliminè. Osi lontan ke se pwosesis la 3D Tache te pote soti, estati a
rete annatant.
Rezilta final la nan tranzaksyon an se Lè sa a, swa
- PWOSÈ.KÒD RETOUR = 000.000.000
- PROCESSING.RESULT = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 ou 000.200.000
- PROCESSING.RESULT = NOK
Nan pwemye ka tranzaksyon an te konplete avèk siksè, nan dezyèm ka a li echwe an jeneral. Lèt la ka gen plizyè rezon, ki gen ladan yon refi otantifye. Ou pral
resevwa plis enfòmasyon detaye nan paramèt yo "PROCESSING.RETURN" ak "PROCESSING.RETURN.CODE".
Nou rekòmande pou w fè yon tès pou toude mesaj yo. Pou plis enfòmasyon sou kòman yo fè yon tès ak ki detay kat kredi ou ka itilize pou yon tès, tanpri gade anba a.
3D Pwosedi Tache lè w ap itilize fòm kesye hPF la
Fòm kesye hPF la fèt tou pou itilize pwosedi 3DS la deja. Pa gen okenn aksyon adisyonèl bò kote ou ki nesesè pou aplikasyon pwosedi a. Jan sa dekri
pou aplikasyon an hCO repons lan nan sistèm nan peman pran plas nan de etap, ki se poukisa sistèm ou an dwe tcheke valè a nan PROCESSING.RETURN.CODE la
paramèt lè pwosesis repons lan.
Pou rezon sa a paramèt sa yo dwe evalye.
- PWOSÈ.KÒD RETOUR = 000.200.000
- PROCESSING.RETURN = Tranzaksyon + annatant
- PROCESSING.RESULT = ACK
Eksplikasyon: Estati tranzaksyon an se "annatant", paramèt PROCESSING.RESULT reprezante sèlman yon rezilta preliminè. Osi lontan ke se pwosesis la 3D Tache te pote soti, estati a
rete annatant.
Rezilta final la nan tranzaksyon an se Lè sa a, swa
- PWOSÈ.KÒD RETOUR = 000.000.000
- PROCESSING.RESULT = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 ou 000.200.000
- PROCESSING.RESULT = NOK
Nan pwemye ka tranzaksyon an te konplete avèk siksè, nan dezyèm ka a li echwe an jeneral. Lèt la ka gen plizyè rezon, ki gen ladan yon refi otantifye. Ou pral
resevwa plis enfòmasyon detaye nan paramèt yo "PROCESSING.RETURN" ak "PROCESSING.RETURN.CODE".
Nou rekòmande pou w fè yon tès pou toude mesaj yo. Pou plis enfòmasyon sou kòman yo fè yon tès ak ki detay kat kredi ou ka itilize pou yon tès, tanpri gade anba a.
3D Pwosedi Tache ak koneksyon dirèk
Si ou pa sèvi ak yon fòm peman ki ofri pa Unzer (ansyen heidelpay) nan pwosesis peman kat kredi, oswa si ou tou senpleman enskri yon kat lè l sèvi avèk youn nan fòm yo ak pwosesis preautorizasyon a (rezèvasyon) oswa debi kòm yon referans a enskripsyon an kòm yon kominikasyon dirèk ak sistèm nan peman, ou dwe aplike pwosesis la 3D Tache.
Asenkron koule tranzaksyon:
Sa a se yon pwosesis asenkron nan ki sèvè ou resevwa yon transfert URL (Redireksyon URL) soti nan sistèm peman nou an. Sèvè ou dwe voye kliyan sa a URL se konsa ke li ka pote soti nan otantifikasyon an atravè pwosedi 3D Tache. Rezilta sa a 3D otantifikasyon Tache rapòte dirèkteman nan Unzer pa bank la founi dokiman yo kat.
Apre otantifikasyon siksè, tranzaksyon an plis trete nan sistèm Unzer nan fason ou deja konnen pa voye sistèm ou an yon rezilta jeneral nan fen a, kote ou reponn
avèk yon redireksyon URL. Lè sa a, sistèm nan peman pral redireksyon kliyan an tounen nan sistèm ou an lè l sèvi avèk sa a redireksyon URL soti nan sistèm ou an
Tanpri sonje: Nan workflow sa a sistèm ou an resevwa de repons nan sistèm peman an:
- Youn ak estati a "annatant" (PROCESSING.RETURN.CODE = 000.200.000 ak PROCESSING.RETURN = Tranzaksyon + annatant) ak paramèt yo redireksyon nan bank la founi dokiman yo nan kliyan kliyan an.
- Youn ak rezilta final la nan debi a oswa rezèvasyon. Genyen tou de redireksyon URLs mansyone nan pwosesis sa a, yon sèl soti nan sistèm nan peman kote kliyan an gen yo dwe reyorante resous otantifye nan kat li founi dokiman labank ak yon sèl soti nan sistèm ou an, lè w ap resevwa rezilta final la, redireksyon kliyan an tounen nan sistèm ou an.
Chanjman sa yo ap fèt nan pwosedi regilye a. Tanpri sonje ke akòz aplikasyon an nan lòt metòd peman asenkron, tankou Paypal, kèk nan sa yo
pwosesis ka deja egziste nan aplikasyon ou.
- Repons URL
Nan premye apèl la (no.2 nan dyagram lan) nan sistèm peman an, yon “Repons URL”Dwe pase nan gwoup entèfas la.
Tanpri sonje: Paramèt IDENTIFICATION.REFERENCEID la enpòtan sèlman si ou al gade nan yon enskripsyon oswa lòt tranzaksyon ki deja egziste - Redireksyon Processing URL Si otantifikasyon obligatwa, yon redireksyon URL ak lòt paramèt nan gwoup la redireksyon yo transfere nan repons lan nan sistèm nan peman (No 5 nan dyagram lan).
- Transfere nan kliyan an redireksyon la URL
Si gwoup la redireksyon ap reponn ak yon redireksyon URL, Dwe navigatè kliyan an dwe reyorante resous nan sa a URL (Nimewo 6 nan dyagram lan) pou fè otantifikasyon. Paramèt adisyonèl ki soti nan gwoup redireksyon an dwe transfere nan ekstèn lan websit kòm paramèt POST.
Tanpri sonje: paramèt Lòt yo retounen nan gwoup la "PROCESSING.REDIRECT.xxx" sèlman ak 3D Tache Version 1 (menm gen nimewo a ak non ka varye), Lè nou konsidere ke ak 3D Version 2 sèlman yon PROCESSING.REDIRECT.URL jan sa parèt anba a retounen: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / kouri Sa vle di ke kèlkeswa kalite ak kantite paramèt, navigatè kliyan an dwe redireksyon nan PROCESSING.REDIRECT la.URL.
Anba a ou pral jwenn yon ansyen kòd senpample ki jan ka tankou yon redireksyon ka egzekite. La pati a gen entansyon enfòme kliyan fen ki gen sistèm pa sipòte JavaScript oswa fè li enfim. Nou rekòmande ke se redireksyon a fè nan fenèt aktif navigatè kliyan an epi yo pa sèvi ak fenèt pop up oswa fenèt navigatè nouvo, tankou sa a ta ka
irite kliyan ak mennen yo fèmen paj la yo ap reyorante resous nan.
- Asynchrone rezilta chèk la
Se rezilta otantifikasyon an voye asenkron nan sèvè ou. Sistèm nan peman espere yon valab URL kòm repons. (Non 12 & 13 nan dyagram lan). Pou siksè oswa rejte
peman, yon diferan URL ka reponn isit la pa sistèm ou an. - Retounen chemen kliyan an
Sistèm nan peman redireksyon kliyan an nan la URL bay nan sistèm komèsan an apre pwosesis otantifikasyon ak tranzaksyon peman an fini.
Tanpri sonje: Etap 4.) ak 5.) kontinye nan egzakteman menm jan an jan ou deja abitye avèk nan ki deja egziste OKENN tranzaksyon Tache 3D.
Peman 3D Tache ak renouvlab
Soti nan 1ye janvye 2021, 3D Tache yo pral obligatwa pou tout tranzaksyon kat e-commerce. Sepandan, depi sa a se diman aplikab pou peman renouvlab, bankè a
sistèm gen yon workflow apa pou sa.
Pou rezon sa a, bank yo fè distenksyon ant
- CIT = kliyan inisyalize tranzaksyon yo
- MIT = komèsan inisyalize tranzaksyon yo
Tranzaksyon an premye nan yon kat nan kont komèsan ou dwe otantifye ak 3D Tache soti nan 01.01.2021 ivè. Tankou yon otantifikasyon siksè se yon kondisyon obligatwa nan
lòd pou kapab imedyatman soumèt rezèrvasyon plis sou kat la menm san yo pa 3D Tache. Se poutèt sa, kliyan an dwe voye bay kat-founi dokiman bank li pou premye debi a nan
annakò avèk pwosedi ki dekri anwo a epi legalize tèt li la kòm moun ki gen kat la. Si yon debi pa planifye nan moman lòd la, pou ansyenample akòz yon peryòd esè, yon rezèvasyon (pre-otorizasyon) nan omwen yon euro dwe fèt ak 3D Tache nan prezans kliyan an olye. Kaptire rezèvasyon sa a pa nesesè.
Pou kliyan ki deja egziste yo, sepandan, pa gen okenn 3D otantifikasyon Tache bezwen yo dwe te fè leve. Si premye debi siksè a te pran plas anvan 01.01.2021, dosye kliyan an kapab sipoze tou
yo te otantifye avèk siksè. Pou nouvo kliyan kòm nan 01.01.2021, nan lòt men an, 3D otantifikasyon Tache se obligatwa pou premye debi a oswa rezèvasyon (pre-otorizasyon).
Tanpri sonje: Nan respè sa a, sistèm bankè a gade done kat yo, pa done kliyan yo. Se konsa, si yon kliyan ki deja egziste sèvi ak yon nouvo kat apre 01.01.2021, pou ansyenample paske anvan an
yon sèl ekspire oswa paske li te chanje kat-founi dokiman bank li yo, sa a se yon nouvo sik renouvlab soti nan pwen bank yo nan view epi yo dwe otantifye ak 3D Tache pou anrjistreman an premye.
Yon fwa otantifikasyon inisyal sa a te avèk siksè te pote soti, tout tranzaksyon plis yo egzante de obligasyon pou yo itilize 3D Tache Kondisyon pou peman renouvlab san 3D Tache yo Se poutèt sa:
- Gen omwen yon debi siksè oswa rezèvasyon (pre-otorizasyon) ki te swa te pote soti ak 3D Tache oswa te pran plas anvan 01.01.2021.
- li se referans a yon enskripsyon ki deja egziste ak debi sou soumèt
Pou fè sistèm nan peman konnen, ke sa a se yon peman renouvlab, paramèt la RECURRENCE.MODE = REPETE dwe voye tou. Sa a siyal nan sistèm lan ki yon
peman renouvlab se yo dwe rapòte bay sistèm bankè yo.
Tanpri sonje: Si paramèt RECURRENCE.MODE = REPETE a antre lè yon nouvo kat chaje pou premye fwa, 3D Secure forwarding ap fèt malgre paramèt sa a.
Tès 3D aplikasyon an Tache
Ou ka teste 3D koneksyon an Tache a nenpòt ki lè atravè sistèm peman nou an. Pou fè sa, sèvi ak "CONNECTOR_TEST" mòd la pou yon tranzaksyon, jan yo montre nan ansyen anamples CI-dessus.
Koneksyon done pou tès sa a:
| SEKIRITE.SENDER | 31HA07BC8142C5A171745D00AD63D182 |
| USER.LOGIN | 31ha07bc8142c5a171744e5aef11ffd3 |
| USER.PWD | 93167DE7 |
| TRANZAKSYON.CHANNEL | 31HA07BC8142C5A171749A60D979B6E4 |
| Lajan configuré pou 3D vèsyon 2 | EUR, USD, SEK |
| Lajan configuré pou 3D vèsyon 1 | GBP, CZK, CHF |
Pwen pòtab sistèm se swa
SGW pòtay:
- https://test-heidelpay.hpcgw.net/sgw/gtw - Latin-15 kode
- https://test-heidelpay.hpcgw.net/sgw/gtwu - UTF-8 kode
NGW pòtay:
- https://test-heidelpay.hpcgw.net/ngw/post
Done kat kredi pou tès sa a:
| mak | nimewo kat yo | CVV | dat ekspirasyon | note |
| MasterCard | 5453010000059543 | 123 | dat nan lavni | 3D - modpas: secret3 |
| viza | 4711100000000000 | 123 | dat nan lavni | 3DS - modpas: sekrè! 33 |
Tanpri sonje: Pou 3D Secure Version 2, ou pa bezwen antre nan yon modpas, men tou senpleman klike sou lyen an "Klike la a ranpli otantifikasyon.
Sèl fason pou simulation yon erè ak 3D vèsyon Tache 2 se kite paj la ak tan an lyen soti (approx. 18 minit).
Li plis sou manyèl sa a epi telechaje PDF:
Dokiman / Resous
 |
Lojisyèl 3D Gid Entegrasyon Sekirite [pdfDokimantasyon Unzer, Gid Entegrasyon, 3D Tache |
