Dokumentasyon sa Softwares 3D Secure Integration Guide
Giya sa Paghiusa 3D Luwas
Gikan sa 01.01.2021 sa duha nga hinungdan nga panghimatuud ipatuman ingon usa ka mandatory nga kinahanglanon alang sa tanan nga mga transaksyon sa pagbayad sa ecommerce card. Aron masunod kini nga obligasyon, ang
Ang mga operator sa mga credit card network mogamit sa gitawag nga 3D Secure nga pamaagi. Alang kanimo ingon usa ka negosyante mandatory nga mahimo kini nga pamaagi alang sa imong mga kustomer
01.01.2021. Sa mosunud makit-an nimo ang usa ka paghulagway sa lainlaing paagi sa paghiusa ug kung giunsa ang pagpatuman sa pamaagi sa 3D Secure alang sa kanila.
Palihug pilia ang pamaagi sa paghiusa nga imong gigamit
- Gigamit ba nimo ang checkout form nga hCO?
- Gigamit ba nimo ang checkout form nga hPF?
- Giproseso ba nimo ang mga pagbayad nga wala gigamit ang usa ka porma nga gihatag sa Unzer system?
Palihug timan-i: Mahinungdanon usab kung unsang paagiha gihimo ang mga pag-debit o pag-una sa pagtugot (pagpareserba). Bisan kung mogamit ka usa ka porma sa pagbayad gikan sa Unzer GmbH alang sa pagparehistro sa datos sa kard, ang proseso nga 3D Secure ipatuman nga wala’y porma sa pag-checkout kung ang datos sa kard unang gi-debit o gitugutan sa unang higayon. Sa kini nga kaso ang ikatulong paagi sa paghiusa nga wala’y porma nga gihatag sa Unzer ang magamit.
Palihug hinumdomi usab:
Kung naggamit ka mga nagbalikbalik nga pagbayad (pagbayad sa suskrisyon), siguruha nga basahon ang seksyon nga "3D Secure and Recurring Payment".
3D Secure nga pamaagi kung gigamit ang form sa pag-checkout sa hCO
Ang porma sa checkout sa hCO gilaraw na alang sa pamaagi nga 3D Secure. Wala'y dugang nga aksyon gikan sa imong panig nga kinahanglan alang sa pagpatuman sa pamaagi. Bisan pa, ikaw
kinahanglan nga sigurohon nga makontrol sa imong sistema ang katugbang nga mga tubag sa among sistema sa pagbayad kung magsugod ang proseso nga 3D Secure. Sa dili parehas nga tubag gikan sa
sistema sa pagbayad sa imong server, ang sangputanan sa transaksyon gipasa ug kinahanglan susihon didto sa wala pa ang pagbalik URL gipadala sa sistema sa pagbayad.
Tungod niini nga katuyoan ang mga mosunud nga parameter kinahanglan susihon.
- PAMPROSESO.PANGABALIK.CODE = 000.200.000
- PAMPROSESO.PANGABALIK = Transaksyon + pending
- PAMPROSESO.RESULT = ACK
Pagpatin-aw: Ang kahimtang sa transaksyon "pending", ang parameter nga PROCESSING.RESULT
nagrepresentar ra sa pasiuna nga sangputanan. Hangtod nga gipadayon ang proseso nga 3D Secure, ang kahimtang
magpabilin nga pending.
Ang katapusan nga sangputanan sa transaksyon mahimo usab
- PAMPROSESO.PANGABALIK.CODE = 000.000.000
- PAMPROSESO.RESULT = ACK
or - PROSESO.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- PAMPROSESO.RESULT = NOK
Sa una nga kaso ang transaksyon malampuson nga nahuman, sa ikaduha nga kaso kini napakyas sa kinatibuk-an. Ang ulahi mahimong adunay lainlaing mga katarungan, lakip ang pagdumili nga pamatud-an. Imong buhaton
makadawat labi ka detalyado nga kasayuran sa mga parameter nga "PROCESSING.RETURN" ug "PROCESSING.RETURN.CODE".
Girekomenda namon nga magpadagan ka usa ka pagsulay alang sa parehas nga mga mensahe. Alang sa dugang nga kasayuran kung unsaon paghimo sa usa ka pagsulay ug unsang mga detalye sa credit card ang mahimo nimong magamit alang sa usa ka pagsulay, palihug kitaa sa ubos.
3D Secure nga pamaagi kung gigamit ang form sa pag-checkout sa hPF
Ang porma sa checkout nga hPF gilaraw usab aron magamit na ang pamaagi sa 3DS. Wala'y dugang nga aksyon gikan sa imong panig nga kinahanglan alang sa pagpatuman sa pamaagi. Ingon sa gihubit
alang sa pagpatuman sa hCO ang tubag gikan sa sistema sa pagbayad mahitabo sa duha nga mga lakang, hinungdan nga kinahanglan susihon sa imong sistema ang kantidad sa PAMPROSESO. PAGBALIK.CODE
parameter sa pagproseso sa tubag.
Tungod niini nga katuyoan ang mga mosunud nga parameter kinahanglan susihon.
- PAMPROSESO.PANGABALIK.CODE = 000.200.000
- PAMPROSESO.PANGABALIK = Transaksyon + pending
- PAMPROSESO.RESULT = ACK
Pagpatin-aw: Ang kahimtang sa transaksyon "pending", ang parameter nga PROCESSING.RESULT nagrepresentar ra sa pasiuna nga sangputanan. Hangtod nga gipadayon ang proseso nga 3D Secure, ang kahimtang
magpabilin nga pending.
Ang katapusan nga sangputanan sa transaksyon mahimo usab
- PAMPROSESO.PANGABALIK.CODE = 000.000.000
- PAMPROSESO.RESULT = ACK
or - PROSESO.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- PAMPROSESO.RESULT = NOK
Sa una nga kaso ang transaksyon malampuson nga nahuman, sa ikaduha nga kaso kini napakyas sa kinatibuk-an. Ang ulahi mahimong adunay lainlaing mga katarungan, lakip ang pagdumili nga pamatud-an. Imong buhaton
makadawat labi ka detalyado nga kasayuran sa mga parameter nga "PROCESSING.RETURN" ug "PROCESSING.RETURN.CODE".
Girekomenda namon nga magpadagan ka usa ka pagsulay alang sa parehas nga mga mensahe. Alang sa dugang nga kasayuran kung unsaon paghimo sa usa ka pagsulay ug unsang mga detalye sa credit card ang mahimo nimong magamit alang sa usa ka pagsulay, palihug kitaa sa ubos.
3D Secure nga pamaagi nga adunay direkta nga koneksyon
Kung dili ka mogamit us aka porma sa pagbayad nga gihatag sa Unzer (kaniadto heidelpay) aron maproseso ang mga pagbayad sa credit card, o kung magparehistro ka lang sa usa ka kard gamit ang usa sa mga porma ug iproseso ang preauthorisation (reservation) o debit ingon usa ka pakisayran sa pagparehistro ingon usa ka direkta nga komunikasyon sa sistema sa pagbayad, kinahanglan nimo ipatuman ang proseso nga 3D Secure.
Dili pareho nga pagdagayday sa transaksyon:
Kini usa ka dili parehas nga proseso diin ang imong server makadawat usa ka pagpasa URL (Pagdirekta URL) gikan sa among sistema sa pagbayad. Kinahanglan ipasa sa imong server ang kostumer niini URL aron iyang madala ang panghimatuud pinaagi sa pamaagi nga 3D Secure. Ang sangputanan sa kini nga panghimatuud sa 3D Secure gireport nga direkta sa Unzer sa nag-isyu nga bangko nga bangko.
Pagkahuman sa malampuson nga panghimatuud, ang transaksyon dugang nga giproseso sa sistema sa Unzer sa paagi nga nahibal-an na nimo pinaagi sa pagpadala sa imong sistema og usa ka kinatibuk-ang sangputanan sa katapusan, diin ikaw motubag
nga adunay pag-redirect URL. Pagkahuman ibalhin sa sistema sa pagbayad ang kustomer balik sa imong system gamit kini nga pag-redirect URL gikan sa imong sistema
Palihug hinumdomi: Sa kini nga workflow ang imong sistema makadawat duha nga mga tubag gikan sa sistema sa pagbayad:
- Usa nga adunay status nga “pending” (PROCESSING.RETURN.CODE = 000.200.000 ug PROCESSING.RETURN = Transaction + pending) ug ang mga parameter sa pag-redirect sa bangko nga nag-isyu sa kard sa kustomer
- Usa sa katapusan nga sangputanan sa pag-debit o pagreserba. Adunay usab duha nga pag-redirect URLs nga gihisgutan sa kini nga proseso, usa gikan sa sistema sa pagbayad diin ang kustomer kinahanglan ibalhin aron mapamatud-an sa iyang card nga nag-isyu sa bangko usa gikan sa imong sistema, kung nadawat ang katapusan nga sangputanan, aron ibalik ang kostumer sa imong sistema.
Ang mga mosunud nga pagbag-o himuon sa naandan nga pamaagi. Palihug hinumdomi nga tungod sa pagpatuman sa uban pang dili parehas nga pamaagi sa pagbayad, sama sa Paypal, pipila sa mga niini
ang mga proseso mahimong adunay na sa imong pagpatuman.
- tubag URL
Sa una nga pagtawag (no.2 sa dayagram) sa sistema sa pagbayad, usa ka “Tubag URL”Kinahanglan ipasa sa frontend group.
Palihug timan-i: Ang parameter nga IDENTIFICATION.REFERENCEID may kalabutan lamang kung mag-refer ka sa usa ka pagrehistro o uban pa nga adunay na nga transaksyon - Pagbalhin sa Pagproseso URL Kung kinahanglan ang panghimatuud, us aka pag-redirect URL ug uban pang mga parameter sa pag-redirect nga grupo gibalhin sa tubag gikan sa sistema sa pagbayad (No. 5 sa diagram).
- Pagpasa sa kustomer sa pag-redirect URL
Kung ang grupo sa pag-redirect nagtubag uban ang pag-redirect URL, ang browser sa kustomer kinahanglan ibalhin dinhi URL (Numero 6 sa dayagram) aron sa pagpahigayon sa panghimatuod. Ang dugang nga mga parametro gikan sa redirect nga grupo kinahanglang ibalhin ngadto sa gawas website isip mga parameter sa POST.
Palihug hinumdomi: Ang mga dugang nga sukaranan ibalik sa grupong "PROCESSING.REDIRECT.xxx" nga adunay 3D Secure Version 1 (bisan didto ang numero ug pagngalan mahimong magkalainlain), samtang sa 3D Version 2 usa ra ka PROSESYON.REDIRECT.URL sama sa gipakita sa ubos gibalik: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run Kini nagpasabut nga dili igsapayan ang tipo ug gidaghanon sa mga parameter, ang browser sa kliyente kinahanglan nga mag-redirect sa PROCESSING.REDIRECT.URL.
Sa ubos makit-an nimo ang usa ka yano nga code exampkung giunsa ang pag-redirect mahimo nga ipatuman. Ang Ang bahin gituyo aron sa pagpahibalo sa katapusan nga mga kustomer kansang mga sistema wala mosuporta sa Javascript o kini gi-disable. Kusganon namo nga girekomendar nga ang pag-redirect himoon sulod sa aktibong browser window sa kustomer ug dili paggamit sa pop up windows o bag-ong browser windows, kay mahimo kini.
makapalagot sa mga kostumer ug dad-on sila aron isira ang panid nga giadto nila.
- Dili pareho nga pagsusi sa resulta
Ang sangputanan sa panghimatuud gipadala nga wala magkahiusa sa imong server. Ang sistema sa pagbayad nagpaabut usa ka balido URL ingon tubag. (No. 12 & 13 sa dayagram). Alang sa malampuson o gisalikway
pagbayad, usa ka lain URL mahimong tubagon dinhi sa imong sistema. - Pagbalik dalan sa kustomer
Ang sistema sa pagbayad nagbalhin sa kustomer sa URL gihatag sa sistema sa negosyante pagkahuman sa proseso sa panghimatuud ug nahuman na ang transaksyon sa pagbayad.
Palihug hinumdomi: Mga Lakang 4.) ug 5.) magpadayon sa eksakto nga parehas nga paagi sa pamilyar na sa mga wala’y transaksyon nga NONE 3D Secure.
3D Luwas ug Balik-balik nga Bayad
Gikan sa ika-1 sa Enero 2021, ang 3D Secure mahimo’g mandatory alang sa tanan nga mga transaksyon sa e-commerce card. Bisan pa, tungod kay hapit dili kini magamit alang sa nagbalik-balik nga pagbayad, ang bangko
ang mga sistema adunay usa ka bulag nga workflow alang niini.
Alang sa kini nga katuyoan, ang mga bangko nagpalahi sa taliwala
- CIT = pasiuna nga mga transaksyon sa kostumer
- MIT = inisyal nga mga transaksyon sa negosyante
Ang una nga transaksyon sa usa ka kard sa imong merchant account kinahanglan mapamatud-an sa 3D Secure gikan sa 01.01.2021 padayon. Ang ingon nga usa ka malampuson nga panghimatuud usa ka mandatory nga kinahanglanon sa
aron mahimo nga pagkahuman isumite ang dugang nga mga pag-book sa parehas nga kard nga wala’y 3D Secure. Ang kustomer busa kinahanglan nga ipasa sa iyang bangko nga nag-isyu alang sa una nga pag-debit in
subay sa pamaagi nga gihulagway sa ibabaw ug pagmatuod sa iyang kaugalingon didto isip cardholder. Kung ang usa ka debit wala giplano sa panahon sa pag-order, alang sa example tungod sa usa ka panahon sa pagsulay, ang usa ka reserbasyon (pre-authorization) sa labing menos usa ka euro kinahanglan nga himoon uban sa 3D Secure sa atubangan sa kustomer sa baylo. Ang pagkuha niini nga reserbasyon dili kinahanglan.
Hinuon, alang sa mga adunay nang kostumer, wala’y kinahanglan nga paglihok sa 3D Secure nga panghimatuud. Kung ang una nga malampuson nga debit nahitabo sa wala pa 01.01.2021, mahimo usab ipangako ang record sa kostumer
malampuson nga napamatud-an. Alang sa mga bag-ong kostumer kaniadtong 01.01.2021, sa pikas nga bahin, ang 3D Secure nga panghimatuud mandatory alang sa una nga pag-debit o pagreserba (pauna nga pagtugot).
Palihug timan-i: Niini nga bahin, ang sistema sa pagbabangko nagtan-aw sa datos sa kard, dili sa datos sa kustomer. Mao nga kung ang usa ka naglungtad nga kustomer mogamit usa ka bag-ong kard pagkahuman sa 01.01.2021, alang sa example kay ang nauna
ang usa expire na o tungod kay iyang giusab ang iyang card-issuing bank, kini usa ka bag-ong balik-balik nga cycle gikan sa punto sa mga bangko sa view ug kinahanglang ma-authenticate sa 3D Secure para sa unang booking.
Kung ang kini nga pasiuna nga panghimatuud nga malampuson nga natuman, ang tanan nga dugang nga mga transaksyon wala’y bayad gikan sa obligasyon nga gamiton ang 3D Secure Ang mga kinahanglanon alang sa pagbalikbalik nga pagbayad nga wala’y 3D Secure busa:
- Adunay labing menos usa ka malampuson nga pag-debit o pagreserba (pauna nga pagtugot) nga gihimo sa 3D Secure o nahitabo sa wala pa ang 01.01.2021.
- kini gi-refer sa usa ka adunay nga pagrehistro ug pag-debit sa pagsumite
Aron mahibal-an ang sistema sa pagbayad, nga kini usa ka nagbalik-balik nga pagbayad, ang parameter nga REKRRENSIYA. Senyas kini sa sistema nga a
balik-balik nga pagbayad ireport sa mga sistema sa bangko.
Palihug hinumdomi: Kung ang parameter nga REGRENSYA.MODE = REPEATED gisulud kung ang usa ka bag-ong kard gikarga sa unang higayon, ang 3D Secure nga pagpasa ipadayon bisan pa sa kini nga parameter.
Pagsulay sa pagpatuman sa 3D Secure
Mahimo nimong sulayan ang koneksyon sa 3D Secure sa bisan unsang oras pinaagi sa among sistema sa pagbayad. Aron mahimo kini, gamita ang "CONNECTOR_TEST" mode alang sa usa ka transaksyon, ingon sa gipakita sa examples sa ibabaw.
Ang datos sa koneksyon alang sa kini nga pagsulay:
| KASIGUROHAN.SENDER | 31HA07BC8142C5A171745D00AD63D182 |
| USER.LOGIN | 31ha07bc8142c5a171744e5aef11ffd3 |
| USER.PWD | 93167DE7 |
| TRANSAKSIYON.CHANNEL | 31HA07BC8142C5A171749A60D979B6E4 |
| Gipili ang mga kwarta alang sa 3D nga Bersyon 2 | EUR, USD, SEK |
| Gipili ang mga kwarta alang sa 3D nga Bersyon 1 | GBP, CZK, CHF |
Ang endpoint sa sistema sa gateway mao usab
Ganghaan nga SGW:
- https://test-heidelpay.hpcgw.net/sgw/gtw - Ang Latin-15 naka-encode
- https://test-heidelpay.hpcgw.net/sgw/gtwu - Ang UTF-8 naka-encode
NGW gateway:
- https://test-heidelpay.hpcgw.net/ngw/post
Ang datos sa credit card alang sa kini nga pagsulay:
| mga tatak | mga numero sa kard | CVV | petsa sa pag-expire | nota |
| MasterCard | 5453010000059543 | 123 | umaabot nga petsa | 3D - password: tinago3 |
| Bisaya | 4711100000000000 | 123 | umaabot nga petsa | 3DS - password: tinago! 33 |
Palihug hinumdomi: Alang sa 3D Secure Version 2, dili nimo kinahanglan nga magsulud usa ka password, apan i-klik ra ang link ”Pag-klik dinhi aron makompleto ang panghimatuud.
Ang paagi ra aron masundog ang usa ka sayup sa 3D Secure Version 2 aron mapahawa ang panid nga adunay pag-out sa link (gibanabana nga 18 minuto).
Basaha ang Dugang Mahitungod Niini nga Manwal & Pag-download sa PDF:
Mga Dokumento / Mga Kapanguhaan
 |
Softwares 3D Secure Integration Guide [pdf] Dokumentasyon Unzer, Giya sa Paghiusa, luwas nga 3D |
