Softwares 3D Secure Integration Guide document
Torolàlana fampidirana 3D Secure
Manomboka amin'ny 01.01.2021 ny fanamarinana singa roa dia hampiharina amin'ny fepetra takiana amin'ny fifanakalozana fandoavana karatra ecommerce rehetra. Mba hanarahana an'io adidy io, ny
hampiasa ilay antsoina hoe fomba 3D Secure ny mpandraharaha ny tambajotran'ny carte de crédit. Ho anao mpivarotra dia tsy maintsy atao ny manatanteraka an'io fomba io ho an'ny mpanjifanao
01.01.2021. Amin'ity manaraka ity dia ho hitanao ny famaritana ny fomba isan-karazany amin'ny fampidirana sy ny fomba tokony hampiharana ny fomba 3D Secure ho azy ireo.
Safidio azafady ny fomba fampidirana ampiasainao
- Mampiasa ny takelaka fizahana hCO ve ianao?
- Mampiasa ny fisoratana anarana hPF ve ianao?
- Moa ve ianao manodina ny fandoavam-bola nefa tsy mampiasa endrika natolotry ny rafitra Unzer?
Aza hadino fa: Zava-dehibe ihany koa ny fomba fanaovana debit na preauthorisations (famandrihana). Na dia mampiasa takelaka fandoavam-bola avy amin'ny Unzer GmbH ho an'ny fisoratana anarana ny angona karatra ianao, ny fizotran'ny 3D Secure dia ho tanterahina tsy misy taratasy fanamarinana rehefa voalohany na voaloa ara-dalàna ny tahiry karatra. Amin'ity tranga ity dia mihatra ny fomba fampidirana fahatelo izay tsy misy endrika nomen'i Unzer.
Mariho ihany koa:
Raha mampiasa fandoavam-bola miverimberina (fandoavam-bola famandrihana) ianao dia aza hadino ny mamaky ilay faritra hoe "3D Secure and Recurring Payment".
Fomba fiasa azo antoka 3D rehefa mampiasa ny endrika fisavana hCO
Ny endrika fisavana hCO dia efa natao ho an'ny fomba 3D Secure. Tsy misy hetsika fanampiny ilainao amin'ny fampiharana ny fomba. Na izany aza, ianao
tokony ho azonao antoka fa afaka mitantana ny valiny mifanaraka amin'izany amin'ny rafitra fandoavam-bola ny rafitrao raha toa ka manomboka ny fizotran'ny 3D Secure. Ao amin'ny valinteny tsy mifanaraka amin'ny
rafitra fandoavam-bola amin'ny mpizara anao, ny valin'ny fifanakalozana dia ampitaina ary tsy maintsy tombanana eo alohan'ny fiverenana URL dia ampitaina amin'ny rafitra fandoavam-bola.
Ho an'ity tanjona ity dia tsy maintsy tombanana ireo masontsivana manaraka.
- FAMPANDROSOANA. FIVERENANA.CODE = 000.200.000
- FAMPANDROSOANA .. FIVERENANA = Fifampiraharahana + miandry
- FAMPANDROSOANA.RESULT = ACK
Fanazavana: ny toetran'ny fifanakalozana dia "miandry", ny masontsivana PROCESSING.RESULT
maneho ny valiny vonjimaika ihany. Raha mbola tontosa ny fizotran'ny 3D Secure, ny satan'ny
mijanona miandry.
Ny valiny farany amin'ny fifanakalozana dia avy eo
- FAMPANDROSOANA. FIVERENANA.CODE = 000.000.000
- FAMPANDROSOANA.RESULT = ACK
or - FAMPANDROSOANA.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- FAMPANDROSOANA.RESULT = NOK
Amin'ny tranga voalohany dia vita tsara ny fifampiraharahana, amin'ny tranga faharoa dia nahomby tamin'ny ankapobeny. Ity farany dia mety manana antony maro samihafa, ao anatin'izany ny fandavana ny fanamarinana. Ianao dia ho
mahazoa fampahalalana amin'ny antsipiriany misimisy kokoa ao amin'ny masontsivana "PROCESSING.RETURN" sy "PROCESSING.RETURN.CODE".
Manoro hevitra anao izahay mba hanao fitsapana ho an'ny hafatra roa. Raha mila fanazavana fanampiny momba ny fomba hanaovana fitsapana sy ny antsipiriany momba ny carte de crédit azonao ampiasaina amin'ny fitsapana, azafady jereo eto ambany.
Drafitra azo antoka 3D rehefa mampiasa ny endrika fisoratana anarana hPF
Ny endrika fizahana hPF dia natao hampiasa ny fomba 3DS sahady. Tsy misy hetsika fanampiny ilainao amin'ny fampiharana ny fomba. Araka ny voalaza
ho an'ny fampiharana hCO ny valiny avy amin'ny rafitra fandoavam-bola dia mihetsika amin'ny dingana roa, izany no antony tsy maintsy hijeren'ny rafitrao ny sandan'ny PROCESSING.RETURN.CODE
masontsivana rehefa manodina ny valiny.
Ho an'ity tanjona ity dia tsy maintsy tombanana ireo masontsivana manaraka.
- FAMPANDROSOANA. FIVERENANA.CODE = 000.200.000
- FAMPANDROSOANA .. FIVERENANA = Fifampiraharahana + miandry
- FAMPANDROSOANA.RESULT = ACK
Fanazavana: ny toetoetran'ny fifanakalozana dia "miandry", ny masontsivana PROCESSING.RESULT dia maneho valiny savaranonando fotsiny. Raha mbola tontosa ny fizotran'ny 3D Secure, ny satan'ny
mijanona miandry.
Ny valiny farany amin'ny fifanakalozana dia avy eo
- FAMPANDROSOANA. FIVERENANA.CODE = 000.000.000
- FAMPANDROSOANA.RESULT = ACK
or - FAMPANDROSOANA.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- FAMPANDROSOANA.RESULT = NOK
Amin'ny tranga voalohany dia vita tsara ny fifampiraharahana, amin'ny tranga faharoa dia nahomby tamin'ny ankapobeny. Ity farany dia mety manana antony maro samihafa, ao anatin'izany ny fandavana ny fanamarinana. Ianao dia ho
mahazoa fampahalalana amin'ny antsipiriany misimisy kokoa ao amin'ny masontsivana "PROCESSING.RETURN" sy "PROCESSING.RETURN.CODE".
Manoro hevitra anao izahay mba hanao fitsapana ho an'ny hafatra roa. Raha mila fanazavana fanampiny momba ny fomba hanaovana fitsapana sy ny antsipiriany momba ny carte de crédit azonao ampiasaina amin'ny fitsapana, azafady jereo eto ambany.
Drafitra azo antoka 3D miaraka amin'ny fifandraisana mivantana
Raha tsy mampiasa takelaka fandoavam-bola nomen'i Unzer (heidelpay teo aloha) ianao hanodinana ny fandoavam-bola amin'ny carte de crédit, na raha misoratra anarana amin'ny karatra fotsiny ianao amin'ny alàlan'ny iray amin'ireo endrika ary manodina ny preauthorisation (famandrihana) na debit ho referansa ny fisoratana anarana ho fifandraisana mivantana amin'ny rafitra fandoavam-bola, tsy maintsy ampiharinao ny fizotran'ny 3D Secure.
Fandefasana fifampiraharahana tsy misy ifandraisana:
Ity dia dingana iray tsy misy ifandraisany ary mahazo fandrosoana ny mpizara anao URL (Redirect URL) avy amin'ny rafitra fandoavam-bola. Ny mpizara anao dia tokony handefa ny mpanjifa amin'izany URL hahafahany manatanteraka ny fanamarinana amin'ny alàlan'ny fomba fanao 3D Secure. Ny valin'ity fanamarinana 3D Secure ity dia taterina mivantana any amin'ny Unzer avy amin'ny banky mpanome karatra.
Aorian'ny fanamarinana mahomby, ny raharaham-barotra dia tohizina ao amin'ny rafitra Unzer amin'ny fomba efa fantatrao amin'ny alàlan'ny fandefasana ny rafitry ny valiny amin'ny farany, izay valianao
miaraka amin'ny redirect URL. Ny rafitra fandoavam-bola dia hamerina ny mpanjifany hiverina any amin'ny rafitranao amin'ny alàlan'ity fanovana ity URL avy amin'ny rafitrao
Azafady mba mariho: amin'ity workflow ity dia mahazo valiny roa avy amin'ny rafitra fandoavam-bola ny rafitrao:
- Iray miaraka amin'ny satan'asa "miandry" (PROCESSING.RETURN.CODE = 000.200.000 ary PROCESSING.RETURN = Transaction + miandry) ary ny masontsivana fanodinana any amin'ny banky mpamoaka karatra an'ny mpanjifa
- Iray miaraka amin'ny valiny farany an'ny debit na famandrihana. Misy koa ny redirect roa URLvoatonona ato amin'ity dingana ity, iray avy amin'ny rafitra fandoavam-bola izay tokony alefa ny mpanjifa mba hanamarinana amin'ny banky namoaka banky und iray avy amin'ny rafitrao, rehefa nahazo ny valiny farany, hamerina ny mpanjifa hiverina ao amin'ny rafitrao.
Ireto fanovana manaraka ireto dia hatao amin'ny fomba mahazatra. Azafady mba mariho fa noho ny fampiharana ny fomba fandoavam-bola tsy mifanaraka amin'ny hafa, toy ny Paypal, ny sasany amin'ireny
mety efa misy ny fizotranao amin'ny fampiharana anao.
- FAMALIANA URL
Amin'ny antso voalohany (lah. 2 amin'ny kisary) mankany amin'ny rafitra fandoavam-bola, «Valiny URL”Dia tsy maintsy ampitaina ao amin'ny vondrona frontend.
Aza hadino fa: Ny masontsivana IDENTIFICATION.REFERENCEID dia tsy misy ifandraisany ihany raha miresaka fisoratana anarana na fifanakalozana efa misy ianao - Famindrana fanodinana URL Raha ilaina ny fanamarinana dia alao ny redirect URL ary ny masontsivana hafa ao amin'ny vondrona redirect dia nafindra tamin'ny valin'ny rafitra fandoavam-bola (No. 5 ao amin'ny kisary).
- Fanolorana ny mpanjifa mankany amin'ny redirect URL
Raha mamaly amin'ny alàlan'ny fanitsiana ny vondrona redirect URL, ny mpitety ny mpanjifa dia tsy maintsy alefa mankany URL (No. 6 ao amin'ny kisary) hanaovana fanamarinana. Ny masontsivana fanampiny avy amin'ny vondrona redirect dia tsy maintsy afindra any ivelany webtoerana ho masontsivana POST.
Azafady mba mariho: ny masontsivana fanampiny dia miverina ao amin'ny vondrona "PROCESSING.REDIRECT.xxx" miaraka amin'ny 3D Secure Version 1 (na dia misy aza ny isa sy ny anarana dia mety miovaova), fa amin'ny 3D Version 2 dia PROCESSING.REDIRECT ihany.URL araka ny aseho etsy ambany dia miverina: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run Midika izany fa na inona na inona karazana sy isan'ny masontsivana, ny mpizahatany dia tsy maintsy mizotra mankany amin'ny PROCESSING.REDIRECT.URL.
Eto ambany ianao dia hahita code tsotra example momba ny fomba hanaovana ny redirect toy izany. ny Ny ampahany dia natao hampahafantarana ny mpanjifa farany izay tsy manohana ny Javascript na manana kilema ny rafitra. Manoro hevitra mafy izahay fa atao ao anatin'ny varavarankelin'ny navigateur mavitrika an'ny mpanjifa ny fampidinana fa tsy mampiasa varavarankely mipoitra na varavarankely navigateur vaovao, satria mety hitranga izany.
manelingelina ny mpanjifa ary mitarika azy ireo hanidy ny pejy itodihana any amin'izy ireo.
- Fanamarinana valim-pifandraisana tsy mifanaraka
Ny valin'ny fanamarinana dia alefa tsy mitambatra amin'ny mpizara anao. Ny rafitra fandoavam-bola dia manantena fa manan-kery URL ho valiny. (No. 12 & 13 ao amin'ny kisary). Ho an'ny mahomby na nolavina
fandoavam-bola, hafa URL afaka hamaly eto amin'ny rafitrao. - Miverina ny làlan'ny mpanjifa
Ny rafitra fandoavam-bola dia mamindra ny mpanjifa amin'ny URL nomen'ny rafitry ny mpivarotra aorian'ny fizotran'ny fanamarinana sy ny fifanakalozana fandoavambola.
Azafady azafady: ny dingana 4.) ary ny 5.) miroso amin'ny fomba mitovy amin'ny efa mahazatra anao amin'ny fifanakalozana NONE 3D Secure efa misy.
3D fandoavam-bola azo antoka sy miverimberina
Manomboka amin'ny 1 Janoary 2021, 3D Secure dia tsy maintsy atao amin'ny fifanakalozana karatra e-varotra rehetra. Saingy, satria tsy dia mihatra amin'ny fandoavam-bola miverimberina izany, ny banky
ny rafitra dia manana workflow misaraka amin'izany.
Ho an'ity tanjona ity, manavaka ny
- CIT = fifanakalozana natokana ho an'ny mpanjifa
- MIT = fifanakalozana natokana ho an'ny mpivarotra
Ny fifanakalozana karatra voalohany amin'ny kaontin'ny mpivarotra anao dia tsy maintsy voamarina amin'ny 3D Secure manomboka amin'ny 01.01.2021 mandroso. Ny fanamarinana mahomby toy izany dia takiana tsy maintsy atao ao
mba hahafahanao mandefa famandrihana fanampiny amin'ny karatra mitovy tsy misy 3D Secure. Ny mpanjifa dia tsy maintsy alefa any amin'ny banky mpanome karatra ho an'ny debit voalohany amin'ny
mifanaraka amin'ny fomba voalaza etsy ambony ary manamarina ny tenany ho tompon'ny karatra. Raha toa ka tsy nomanina ny findramam-bola amin'ny fotoana nanaovana ny baiko, ohatraample noho ny fotoam-pitsarana, ny famandrihana (fanomezan-dàlana mialoha) farafahakeliny iray euro dia tsy maintsy atao amin'ny 3D Secure eo anatrehan'ny mpanjifa. Tsy ilaina ny maka an'io famandrihana io.
Ho an'ny mpanjifa efa misy anefa dia tsy mila fanamboarana fanamarinana 3D Secure. Raha ny talanjona nahomby voalohany dia nitranga talohan'ny 01.01.2021, dia azo raisina ihany koa ny firaketana ny mpanjifa
efa voamarina tsara. Ho an'ny mpanjifa vaovao hatramin'ny 01.01.2021, etsy ankilany, ny fanamarinana 3D Secure dia tsy maintsy atao amin'ny trosa na famandrihana voalohany (autorisation).
Azafady, azafady: Amin'ity lafiny ity, ny rafitra banky dia mijery ny angon-drakitra karatra, fa tsy ny angon-drakitra mpanjifa. Ka raha mampiasa karatra vaovao ny mpanjifa efa misy aorian'ny 01.01.2021, ohatraample satria ny teo aloha
lany daty ny iray na noho izy nanova ny banky namoaka karatra, tsingerina miverimberina vaovao avy amin'ny banky view ary tsy maintsy hamarinina amin'ny 3D Secure amin'ny famandrihana voalohany.
Raha vantany vao tontosa soa aman-tsara io fanamarinana voalohany io, dia atokana tsy ho adidy ny mampiasa 3D Secure ny fifanakalozana hafa rehetra: noho izany ny fepetra takiana amin'ny fandoavam-bola miverina tsy misy 3D Secure:
- Misy farafahakeliny fividianana debit na famandrihana (pre-authorization) izay natao tamin'ny 3D Secure na nitranga talohan'ny 01.01.2021.
- izy io dia miresaka momba ny fisoratana anarana sy ny fisoratana anarana rehefa apetraka
Mba hampahafantarana ny rafitry ny fandoavam-bola, fa fandoavam-bola miverimberina io dia tokony halefa ihany koa ny masontsivana REHETRA MODE = Averina. Izany dia manondro ny rafitra fa a
ny fandoavam-bola miverimberina dia tokony hotaterina amin'ny rafitra banky.
Azafady mba mariho: Raha ny masontsivana REHETRA MODE = Miverina dia ampidirina rehefa misy karatra vaovao fenoina voalohany, dia hampitaina ny 3D Secure na eo aza io masontsivana io.
Fitsapana ny fampiharana 3D Secure
Azonao atao ny manandrana ny fifandraisana 3D Secure amin'ny fotoana rehetra amin'ny alàlan'ny rafitra fandoavam-bola. Mba hanaovana izany, ampiasao ny fomba "CONNECTOR_TEST" ho an'ny fifampiraharahana, araka ny aseho amin'ny examples ambony.
Data momba ny fifandraisana amin'ity fitsapana ity:
| SECURITY.SENDER | 31HA07BC8142C5A171745D00AD63D182 |
| USER.LOGIN | 31ha07bc8142c5a171744e5aef11ffd3 |
| USER.PWD | 93167DE7 |
| TRANSACTION.CHANNEL | 31HA07BC8142C5A171749A60D979B6E4 |
| Ny sandam-bola napetraka ho an'ny 3D Version 2 | EUR, USD, SEK |
| Ny sandam-bola napetraka ho an'ny 3D Version 1 | GBP, CZK, CHF |
Ny fiafaran'ny vavahady amin'ny rafitra dia koa
Vavahady SGW:
- https://test-heidelpay.hpcgw.net/sgw/gtw - Latina-15 nohaingo
- https://test-heidelpay.hpcgw.net/sgw/gtwu - UTF-8 voahodid
Vavahady NGW:
- https://test-heidelpay.hpcgw.net/ngw/post
Data momba ny carte de crédit amin'ity fitsapana ity:
| marika | laharana karatra | CVV | lany daty amin'ny | Fanamarihana |
| MasterCard | 5453010000059543 | 123 | daty ho avy | 3D - teny miafina: miafina3 |
| fahazoan-dàlana | 4711100000000000 | 123 | daty ho avy | 3DS - teny miafina: tsiambaratelo! 33 |
Aza adino: Ho an'ny 3D Secure Version 2 dia tsy mila mampiditra teny miafina ianao fa tsindrio fotsiny ilay rohy ”Tsindrio eto raha hamita ny fanamarinana.
Ny fomba tokana anahafana ny lesoka amin'ny 3D Secure Version 2 dia ny famelana ny pejy misy ny rohy hivoaka (eo ho eo. 18 minitra).
Hamaky bebe kokoa momba ity boky ity & Download PDF:
Documents / Loharano
 |
Softwares 3D Secure Integration Guide [pdf] Documentation Unzer, Guide Integration, 3D Secure |
