Softwares 3D Secure Integration Guide Dokumintaasje
Yntegraasjegids 3D Secure
Fan 01.01.2021 wurdt twafaktorautifikaasje ymplementeare as ferplichte eask foar alle betellingsferkearen foar e-commerce-kaarten. Om oan dizze ferplichting te foldwaan, is de
eksploitanten fan kredytkaartnetwurken sille de saneamde 3D Secure-proseduere brûke. Foar jo as keapman is it ferplicht dizze proseduere foar jo klanten út te kinnen
01.01.2021. Yn it folgjende sille jo in beskriuwing fine fan 'e ferskillende manieren fan yntegraasje en hoe't de 3D Secure-proseduere foar har moat wurde ymplementeare.
Selektearje asjebleaft de yntegraasjemetoade dy't jo brûke
- Brûkt jo it kassafoarm hCO?
- Brûkt jo it kassafoarm hPF?
- Ferwurkje jo betellingen sûnder in formulier te brûken dat wurdt levere troch it Unzer-systeem?
Tink derom: It is ek wichtich op hokker manier debits as foech autorisaasjes (reservearrings) wurde makke. Sels as jo in betellingsformulier brûke fan Unzer GmbH foar de registraasje fan kaartgegevens, sil it 3D Secure-proses wurde útfierd sûnder in kassafoarm as de kaartgegevens foar it earst wurde debiteare of autorisearre. Yn dit gefal jildt de tredde manier fan yntegraasje sûnder in formulier levere troch Unzer.
Tink derom ek:
As jo weromkommende betellingen brûke (abonnemintsbetellingen), lês dan de seksje "3D Feilige en weromkommende betelling".
3D Secure proseduere by it brûken fan it hCO-kassafoarm
It hCO-kassafoarm is al ûntworpen foar de 3D Secure-proseduere. D'r is gjin ekstra aksje fan jo kant nedich foar de ymplemintaasje fan 'e proseduere. Jo lykwols
moatte jo derfoar soargje dat jo systeem de oerienkommende antwurden fan ús betelsysteem kin behannelje yn gefal it 3D Secure-proses wurdt begon. Yn de asynchrone antwurd fan 'e
betelsysteem nei jo server, wurdt it resultaat fan 'e transaksje ferstjoerd en moat dêr evaluearre wurde foardat in weromkear is URL wurdt oerdroegen oan it betelsysteem.
Foar dit doel moatte de folgjende parameters wurde evaluearre.
- PROCESSING.RETURN.CODE = 000.200.000
- PROCESSING.RETURN = Transaksje + yn behanneling
- PROCESSING.RESULT = ACK
Taljochting: De status fan 'e transaksje is "yn behanneling", de parameter PROCESSING.RESULT
fertsjintwurdiget mar in foarriedich resultaat. Salang't it 3D Secure-proses wurdt útfierd, de status
bliuwend wachtsjen.
It definitive resultaat fan 'e transaksje is dan ek
- PROCESSING.RETURN.CODE = 000.000.000
- PROCESSING.RESULT = ACK
or - PROCESSING.RETURN.CODE = net folgjende 000.000.000 of 000.200.000
- PROCESSING.RESULT = NOK
Yn it earste gefal is de transaksje suksesfol foltôge, yn it twadde gefal is it algemien mislearre. Dizze lêste kin ferskate redenen hawwe, ynklusyf in wegering fan ferifikaasje. Do silst
ûntfange mear detaillearre ynformaasje yn 'e parameters "PROCESSING.RETURN" en "PROCESSING.RETURN.CODE".
Wy riede oan dat jo in test foar beide berjochten útfiere. Sjoch hjirûnder foar mear ynformaasje oer hoe't jo in test dwaan kinne en hokker kredytkaartgegevens jo kinne brûke foar in test.
3D Secure-proseduere by it brûken fan it hPF-kassafoarm
It hPF-kassafoarm is ek ûntworpen om de 3DS-proseduere al te brûken. D'r is gjin ekstra aksje fan jo kant nedich foar de ymplemintaasje fan 'e proseduere. As beskreaun
foar de hCO-ymplemintaasje fynt it antwurd fan it betelsysteem yn twa stappen plak, en dêrom moat jo systeem de wearde kontrolearje fan 'e VERWERKING.RETURN.CODE
parameter by it ferwurkjen fan it antwurd.
Foar dit doel moatte de folgjende parameters wurde evaluearre.
- PROCESSING.RETURN.CODE = 000.200.000
- PROCESSING.RETURN = Transaksje + yn behanneling
- PROCESSING.RESULT = ACK
Taljochting: De status fan 'e transaksje is "yn behanneling", de parameter PROCESSING.RESULT fertsjintwurdiget mar in foarriedich resultaat. Salang't it 3D Secure-proses wurdt útfierd, de status
bliuwend wachtsjen.
It definitive resultaat fan 'e transaksje is dan ek
- PROCESSING.RETURN.CODE = 000.000.000
- PROCESSING.RESULT = ACK
or - PROCESSING.RETURN.CODE = net folgjende 000.000.000 of 000.200.000
- PROCESSING.RESULT = NOK
Yn it earste gefal is de transaksje suksesfol foltôge, yn it twadde gefal is it algemien mislearre. Dizze lêste kin ferskate redenen hawwe, ynklusyf in wegering fan ferifikaasje. Do silst
ûntfange mear detaillearre ynformaasje yn 'e parameters "PROCESSING.RETURN" en "PROCESSING.RETURN.CODE".
Wy riede oan dat jo in test foar beide berjochten útfiere. Sjoch hjirûnder foar mear ynformaasje oer hoe't jo in test dwaan kinne en hokker kredytkaartgegevens jo kinne brûke foar in test.
3D Secure proseduere mei direkte ferbining
As jo gjin betellingsformulier brûke dat wurdt levere troch Unzer (foarhinne heidelpay) om kredytkaartbetellingen te ferwurkjen, of as jo gewoan in kaart registrearje mei ien fan 'e formulieren en de foech autorisaasje (reservearring) of debit ferwurkje as referinsje nei de registraasje as direkte kommunikaasje mei it betelsysteem, moatte jo it 3D Secure-proses ymplementearje.
Asynchrone transaksje stream:
Dit is in asynchrôn proses wêryn jo server in trochstjoering krijt URL (Trochferwizing URL) fanút ús betelsysteem. Jo server moat de klant hjirnei trochstjoere URL sadat hy de ferifikaasje kin útfiere fia 3D Secure-proseduere. It resultaat fan dizze 3D Secure ferifikaasje wurdt direkt rapporteare oan Unzer troch de bank dy't de kaart útjûn.
Nei suksesfolle ferifikaasje wurdt de transaksje fierder ferwurke yn it Unzer-systeem op 'e manier dy't jo al wite troch jo systeem oan' e ein in algemien resultaat te stjoeren, wêrop jo antwurdzje
mei in trochferwizing URL, It betelsysteem sil de klant dan trochferwize nei jo systeem mei dizze trochferwizing URL fan jo systeem
Tink derom: yn dizze workflow krijt jo systeem twa antwurden fan it betelsysteem:
- Ien mei de status "yn behanneling" (PROCESSING.RETURN.CODE = 000.200.000 en PROCESSING.RETURN = Transaksje + yn behanneling) en de trochferwizingsparameters nei de bank dy't de kaart útjûn fan de klant
- Ien mei it definitive resultaat fan de debit as reservearring. D'r binne ek twa trochferwizings URLs neamd yn dit proses, ien fan it betelsysteem wêrnei't de klant trochstjoerd wurde moat om te authentifisearjen by syn kaartútjeftebank en ien fan jo systeem, by ûntfangen fan it definitive resultaat, om de klant werom te ferwiderjen nei jo systeem.
De folgjende feroarings sille wurde makke oan 'e reguliere proseduere. Tink derom dat fanwegen de ymplemintaasje fan oare asynchrone betelmethoden, lykas Paypal, guon fan dizze
prosessen kinne al bestean yn jo ymplemintaasje.
- Response URL
Yn 'e earste oprop (nr. 2 yn it diagram) nei it betelsysteem, in "Antwurd URL”Moat wurde trochjûn yn 'e frontendgroep.
Tink derom: De parameter IDENTIFICATION.REFERENCEID is allinich relevant as jo ferwize nei in registraasje of in oare al besteande transaksje - Feroaring ferwurkje URL As ferifikaasje nedich is, in trochferwizing URL en oare parameters yn 'e trochferwizingsgroep wurde oerdroegen yn it antwurd fan it betelsysteem (nûmer 5 yn it diagram).
- Trochstjoeren fan de klant nei de trochferwizing URL
As de trochferwizingsgroep reageart mei in trochferwizing URL, de browser fan de klant moat hjirnei trochstjoerd wurde URL (Nûmer 6 yn it diagram) om autentikaasje út te fieren. De ekstra parameters fan 'e omleidingsgroep moatte wurde oerdroegen oan' e eksterne webside as POST -parameters.
Tink derom: Oanfoljende parameters wurde weromjûn yn 'e groep "PROCESSING.REDIRECT.xxx" allinich mei 3D Secure Ferzje 1 (ek dêr kinne it nûmer en nammejouwing ferskille), wylst mei 3D Ferzje 2 allinich in PROCESSING.REDIRECT.URL lykas werjûn hjirûnder wurdt weromjûn: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run Dit betsjut dat, ûnôfhinklik fan it type en it oantal parameters, de clientbrowser trochstjoere moat nei de PROCESSING.REDIRECT.URL.
Hjirûnder fine jo in ienfâldige koade eksample fan hoe't sa'n omlieding kin wurde útfierd. De diel is bedoeld om einklanten te ynformearjen waans systemen Javascript net stypje of útskeakelje. Wy riede sterk oan dat de trochferwizing wurdt dien binnen it aktive browserfinster fan 'e klant en gjin pop -up -finsters as nije browserfensters te brûken, om't dit kin
irritearje klanten en liede se de pagina te sluten wêr't se nei trochstjoerd wurde.
- Asynchrone resultaatkontrôle
It resultaat fan de ferifikaasje wurdt asynchroon nei jo server stjoerd. It betelsysteem ferwachtet in jildich URL as antwurd. (Nûmer 12 & 13 yn it diagram). Foar suksesfol of ôfwiisd
betellingen, in oare URL kinne hjir wurde beantwurde troch jo systeem. - Retoerpaad fan 'e klant
It betelsysteem stjoert de klant troch nei de URL levere troch it systeem fan 'e keapman nei't it ferifikaasjeproses en de betellingsferfier binne foltôge.
Tink derom: Stappen 4.) en 5.) gean krekt op deselde manier troch as jo al bekend binne yn besteande NONE 3D Secure transaksjes.
3D Befeilige en weromkommend betelling
Fanôf 1 jannewaris 2021 sil 3D Secure ferplicht wêze foar alle transaksjes fan e-commerce-kaarten. Om't dit lykwols amper tapaslik is foar weromkommend betellingen, is it bankieren
systemen hawwe hjir in aparte workflow foar.
Foar dit doel ûnderskiede de banken tusken
- CIT = klant initialisearre transaksjes
- MIT = hannelers inisjalisearre transaksjes
De earste transaksje fan in kaart yn jo hannelskonto moat wurde ferifieare mei 3D Secure fanôf 01.01.2021. Sa'n suksesfolle ferifikaasje is in ferplichte eask yn
om neitiid fierdere boekingen op deselde kaart yn te tsjinjen sûnder 3D Secure. De klant moat dêrom wurde trochstjoerd nei syn kaart dy't bank útjûn foar it earste debit yn
yn oerienstimming mei de hjirboppe beskreaune proseduere en ferifiearje himsels dêr as de kaarthâlder. As in debit net is pland op it momint fan 'e bestelling, bygelyksample fanwegen in proefperioade, moat in reservearring (foarautorisaasje) fan teminsten ien euro wurde makke mei 3D Secure yn plak fan oanwêzigens fan 'e klant. It opnimmen fan dit reservaat is net nedich.
Foar besteande klanten hoecht lykwols gjin 3D Secure autentikaasje opmakke te wurden. As de earste suksesfolle debet plakfûn foar 01.01.2021, kin it klantrekord ek oannommen wurde
binne mei sukses ferifieare. Foar nije klanten per 01.01.2021, oan 'e oare kant, is 3D Secure ferifikaasje ferplicht foar de earste debit of reservearring (pre-autorisaasje).
Opmerking: yn dit ferbân sjocht it banksysteem nei de kaartgegevens, net nei de klantgegevens. Dus as in besteande klant in nije kaart brûkt nei 01.01.2021, foar bygelyksample omdat de foarige
ien is ferrûn of om't hy syn kaartútjûn bank is feroare, dit is in nije weromkommende syklus fan 'e banken fan view en moat wurde ferifiearre mei 3D Secure foar de earste boeking.
Ienris dizze earste ferifikaasje is mei súkses útfierd, binne alle fierdere transaksjes frijsteld fan 'e ferplichting om 3D Secure te brûken. De betingsten foar weromkommende betelling sûnder 3D Secure binne dêrom:
- D'r is teminsten ien suksesfolle debet of reservearring (pre-autorisaasje) dy't mei 3D Secure waard útfierd of plakfûn foar 01.01.2021.
- it wurdt ferwiisd nei in besteande registraasje en debit by yntsjinjen
Om it betelsysteem te witten te litten, dat dit in weromkearende betelling is, moat de parameter RECURRENCE.MODE = REPEATED ek ferstjoerd wurde. Dit sinjalearret oan it systeem dat a
weromkommende betelling moat wurde rapporteare by de banksystemen.
Tink derom: as de parameter RECURRENCE.MODE = REPEATED wurdt ynfierd as in nije kaart foar it earst wurdt laden, sil 3D Secure trochstjoeren wurde útfierd nettsjinsteande dizze parameter.
Testen fan de 3D Secure ymplemintaasje
Jo kinne de 3D Feilige ferbining op elk momint testen fia ús betelsysteem. Om dit te dwaan, brûk de modus "CONNECTOR_TEST" foar in transaksje, lykas werjûn yn 'e eksamples boppe.
Ferbiningsgegevens foar dizze test:
| SECURITY.SENDER | 31HA07BC8142C5A171745D00AD63D182 |
| GEBRUIKER.LOGIN | 31ha07bc8142c5a171744e5aef11ffd3 |
| USER.PWD | 93167DE7 |
| TRANSAKSJE.KANAAL | 31HA07BC8142C5A171749A60D979B6E4 |
| Wearden konfigureare foar 3D Ferzje 2 | EUR, USD, SEK |
| Wearden konfigureare foar 3D Ferzje 1 | GBP, CZK, CHF |
Systeempoarteindpunt is ek
SGW -poarte:
- https://test-heidelpay.hpcgw.net/sgw/gtw - Latyn-15 kodearre
- https://test-heidelpay.hpcgw.net/sgw/gtwu - UTF-8 kodearre
NGW-poarte:
- https://test-heidelpay.hpcgw.net/ngw/post
Kredytkaartgegevens foar dizze test:
| merken | card nûmers | CVV | ferfaldatum | noat |
| MasterCard | 5453010000059543 | 123 | takomstige datum | 3D - wachtwurd: geheim3 |
| Visa | 4711100000000000 | 123 | takomstige datum | 3DS - wachtwurd: geheim! 33 |
Tink derom: foar 3D Secure Ferzje 2 hoege jo gjin wachtwurd yn te fieren, mar klikje gewoan op de keppeling ”Klik hjir om ferifikaasje te foltôgjen.
De iennichste manier om in flater mei 3D Secure Ferzje 2 te simulearjen is om de pagina mei de link time-out te litten (sawat 18 minuten).
Lês mear oer dizze hânlieding en download PDF:
Dokuminten / Resources
 |
Softwares 3D Secure Yntegraasje Guide [pdf] Dokumintaasje Unzer, yntegraasjegids, 3D Feilich |
