Softwares 3D Secure Integration Guide Dokumentation
Integrationsvejledning 3D Secure
Fra 01.01.2021 vil to-faktor autentificering blive implementeret som et obligatorisk krav for alle e-handelskortbetalingstransaktioner. For at overholde denne forpligtelse skal
operatører af kreditkortnetværk vil bruge den såkaldte 3D Secure-procedure. For dig som købmand er det obligatorisk at kunne udføre denne procedure for dine kunder fra
01.01.2021. I det følgende finder du en beskrivelse af de forskellige måder at integrere på, og hvordan 3D Secure-proceduren skal implementeres for dem.
Vælg venligst den integrationsmetode, du bruger
- Bruger du betalingsformularen hCO?
- Bruger du betalingsformularen hPF?
- Behandler du betalinger uden at bruge en formular fra Unzer-systemet?
Bemærk venligst: Det er også vigtigt, på hvilken måde debiteringer eller forhåndsgodkendelser (reservationer) foretages. Selvom du bruger en betalingsformular fra Unzer GmbH til registrering af kortdata, vil 3D Secure-processen blive udført uden en betalingsformular, når kortdataene debiteres eller godkendes første gang. I dette tilfælde gælder den tredje måde til integration uden en formular fra Unzer.
Bemærk også:
Hvis du bruger tilbagevendende betalinger (abonnementsbetalinger), skal du sørge for at læse afsnittet "3D sikker og tilbagevendende betaling".
3D Sikker procedure ved brug af hCO checkout form
hCO checkout-formularen er allerede designet til 3D Secure-proceduren. Der er ingen yderligere handling fra din side nødvendig for implementeringen af proceduren. Dog du
skal sørge for, at dit system kan håndtere de tilsvarende svar fra vores betalingssystem, hvis 3D Secure-processen startes. I det asynkrone svar fra
betalingssystem til din server, transmitteres resultatet af transaktionen og skal evalueres der før en returnering URL overføres til betalingssystemet.
Til dette formål skal følgende parametre evalueres.
- BEHANDLING.RETURNERINGSKODE = 000.200.000
- PROCESSING.RETURN = Transaktion+afventer
- BEHANDLING.RESULTAT = ACK
Forklaring: Status for transaktionen er "afventer", parameteren BEHANDLING.RESULTAT
repræsenterer kun et foreløbigt resultat. Så længe 3D Secure-processen udføres, er status
forblive afventende.
Det endelige resultat af transaktionen er derefter enten
- BEHANDLING.RETURNERINGSKODE = 000.000.000
- BEHANDLING.RESULTAT = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- BEHANDLING.RESULTAT = kr
I det første tilfælde er transaktionen blevet gennemført med succes, i det andet tilfælde mislykkedes den generelt. Sidstnævnte kan have forskellige årsager, herunder et afslag på autentificering. Du vil
modtage mere detaljeret information i parametrene "BEHANDLING.RETURNERING" og "BEHANDLING.RETURNERING.KODE".
Vi anbefaler, at du kører en test for begge meddelelser. For mere information om, hvordan du laver en test, og hvilke kreditkortoplysninger du kan bruge til en test, se venligst nedenfor.
3D Sikker procedure ved brug af hPF checkout form
hPF checkout-formularen er også designet til allerede at bruge 3DS-proceduren. Der er ingen yderligere handling fra din side nødvendig for implementeringen af proceduren. Som beskrevet
til hCO-implementeringen sker svaret fra betalingssystemet i to trin, hvorfor dit system skal kontrollere værdien af BEHANDLING.RETURN.KODE
parameter ved behandling af svaret.
Til dette formål skal følgende parametre evalueres.
- BEHANDLING.RETURNERINGSKODE = 000.200.000
- PROCESSING.RETURN = Transaktion+afventer
- BEHANDLING.RESULTAT = ACK
Forklaring: Status for transaktionen er "afventende", parameteren BEHANDLING.RESULTAT repræsenterer kun et foreløbigt resultat. Så længe 3D Secure-processen udføres, er status
forblive afventende.
Det endelige resultat af transaktionen er derefter enten
- BEHANDLING.RETURNERINGSKODE = 000.000.000
- BEHANDLING.RESULTAT = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- BEHANDLING.RESULTAT = kr
I det første tilfælde er transaktionen blevet gennemført med succes, i det andet tilfælde mislykkedes den generelt. Sidstnævnte kan have forskellige årsager, herunder et afslag på autentificering. Du vil
modtage mere detaljeret information i parametrene "BEHANDLING.RETURNERING" og "BEHANDLING.RETURNERING.KODE".
Vi anbefaler, at du kører en test for begge meddelelser. For mere information om, hvordan du laver en test, og hvilke kreditkortoplysninger du kan bruge til en test, se venligst nedenfor.
3D Sikker procedure med direkte forbindelse
Hvis du ikke bruger en betalingsformular fra Unzer (tidligere heidelpay) til at behandle kreditkortbetalinger, eller hvis du blot registrerer et kort ved hjælp af en af formularerne og behandler forhåndsgodkendelsen (reservationen) eller debiteringen som reference til registreringen som en direkte kommunikation med betalingssystemet, skal du implementere 3D Secure-processen.
Asynkront transaktionsflow:
Dette er en asynkron proces, hvor din server modtager en videresendelse URL (Omdiriger URL) fra vores betalingssystem. Din server skal videresende kunden hertil URL så han kan udføre autentificeringen via 3D Secure procedure. Resultatet af denne 3D Secure-godkendelse rapporteres direkte til Unzer af den kortudstedende bank.
Efter vellykket autentificering behandles transaktionen videre i Unzer-systemet på den måde, du allerede kender, ved at sende dit system et samlet resultat til sidst, som du svarer på
med en omdirigering URL. Betalingssystemet vil derefter omdirigere kunden tilbage til dit system ved hjælp af denne omdirigering URL fra dit system
Bemærk venligst: I denne arbejdsgang modtager dit system to svar fra betalingssystemet:
– En med status "afventer" (PROCESSING.RETURN.CODE=000.200.000 og PROCESSING.RETURN=Transaktion+afventer) og omdirigeringsparametrene til kundens kortudstedende bank
– En med det endelige resultat af debiteringen eller reservationen. Der er også to omdirigeringer URLs nævnt i denne proces, en fra betalingssystemet, som kunden skal omdirigeres til for at autentificere i sin kortudstedende bank, og en fra dit system, når du modtager det endelige resultat, for at omdirigere kunden tilbage til dit system.
Følgende ændringer vil blive foretaget i den almindelige procedure. Bemærk venligst, at på grund af implementeringen af andre asynkrone betalingsmetoder, såsom Paypal, nogle af disse
processer kan allerede eksistere i din implementering.
- Svar URL
I det første opkald (nr. 2 i diagrammet) til betalingssystemet, et "Svar URL” skal bestå i frontend-gruppen.
Bemærk venligst: Parameteren IDENTIFICATION.REFERENCEID er kun relevant, hvis du henviser til en registrering eller anden allerede eksisterende transaktion - Behandler omdirigering URL Hvis godkendelse er påkrævet, en omdirigering URL og andre parametre i omdirigeringsgruppen overføres i svaret fra betalingssystemet (nr. 5 i diagrammet).
- Videresendelse af kunden til omdirigeringen URL
Hvis omdirigeringsgruppen svarer med en omdirigering URL, skal kundens browser omdirigeres til denne URL (nr. 6 i diagrammet) for at udføre godkendelse. De yderligere parametre fra omdirigeringsgruppen skal overføres til den eksterne webwebsted som POST-parametre.
Bemærk venligst: Yderligere parametre returneres kun i gruppen "PROCESSING.REDIRECT.xxx" med 3D Secure Version 1 (selv der kan nummeret og navngivningen variere), hvorimod der med 3D Version 2 kun er en PROCESSING.REDIRECT.URL som vist nedenfor returneres: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF/run Dette betyder, at uanset typen og antallet af parametre, skal klientbrowseren omdirigere til PROCESSING.REDIRECT.URL.
Nedenfor finder du en simpel kode f.eksamphvordan en sådan omdirigering kan udføres. Det del er beregnet til at informere slutkunder, hvis systemer ikke understøtter Javascript eller har det deaktiveret. Vi anbefaler kraftigt, at omdirigeringen sker i kundens aktive browservindue og ikke at bruge pop op-vinduer eller nye browservinduer, da dette kan
irritere kunder og få dem til at lukke den side, de bliver omdirigeret til.
- Asynkron resultatkontrol
Resultatet af godkendelsen sendes asynkront til din server. Betalingssystemet forventer en gyldig URL som svar. (Nr. 12 & 13 i diagrammet). For vellykket eller afvist
betalinger, en anden URL kan besvares her af dit system. - Kundens returvej
Betalingssystemet omdirigerer kunden til URL leveret af forretningens system, efter at godkendelsesprocessen og betalingstransaktionen er gennemført.
Bemærk venligst: Trin 4.) og 5.) fortsætter på nøjagtig samme måde, som du allerede er bekendt med i eksisterende NONE 3D Secure-transaktioner.
3D sikker og tilbagevendende betaling
Fra den 1. januar 2021 vil 3D Secure være obligatorisk for alle e-handelskorttransaktioner. Men da dette næppe er relevant for tilbagevendende betalinger, er bankforretningen
systemer har en separat arbejdsgang til dette.
Til dette formål skelner bankerne mellem
- CIT = kundeinitialiserede transaktioner
- MIT = handlende initialiserede transaktioner
Den første transaktion af et kort på din købmandskonto skal være autentificeret med 3D Secure fra 01.01.2021 og fremefter. En sådan vellykket autentificering er et obligatorisk krav i
for efterfølgende at kunne afgive yderligere reservationer på samme kort uden 3D Secure. Kunden skal derfor videresendes til sin kortudstedende bank for første debitering i
i overensstemmelse med proceduren beskrevet ovenfor og autentificere sig der som kortholder. Hvis der ikke er planlagt en debitering på ordretidspunktet, f.eksampPå grund af en prøveperiode skal der i stedet foretages en reservation (forhåndsgodkendelse) på mindst én euro med 3D Secure i kundens tilstedeværelse. Optagelse af denne reservation er ikke nødvendig.
For eksisterende kunder skal der dog ikke laves en 3D Secure-godkendelse. Hvis den første vellykkede debitering fandt sted før 01.01.2021, kan kundeposten også antages at
er blevet godkendt. For nye kunder pr. 01.01.2021 er 3D Secure-godkendelse derimod obligatorisk ved første debitering eller reservation (forhåndsgodkendelse).
Bemærk venligst: I denne henseende ser banksystemet på kortdata, ikke kundedata. Så hvis en eksisterende kunde bruger et nyt kort efter 01.01.2021, f.eksample fordi den forrige
en er udløbet, eller fordi han har skiftet sin kortudstedende bank, er dette en ny tilbagevendende cyklus fra bankernes synspunkt view og skal være autentificeret med 3D Secure ved første reservation.
Når først denne indledende autentificering er blevet gennemført, er alle yderligere transaktioner fritaget for pligten til at bruge 3D Secure. Forudsætningerne for tilbagevendende betaling uden 3D Secure er derfor:
- Der er mindst én vellykket debitering eller reservation (forhåndsgodkendelse), som enten blev udført med 3D Secure eller fandt sted før 01.01.2021.
- den henvises til en eksisterende registrering og debitering ved indsendelse
For at lade betalingssystemet vide, at der er tale om en tilbagevendende betaling, skal parameteren RECURRENCE.MODE=REPEATED også sendes. Dette signalerer til systemet, at en
tilbagevendende betaling skal indberettes til banksystemerne.
Bemærk venligst: Hvis parameteren RECURRENCE.MODE=REPEATED indtastes, når et nyt kort indlæses for første gang, udføres 3D Secure forwarding trods denne parameter.
Test af 3D Secure implementeringen
Du kan til enhver tid teste 3D Secure-forbindelsen via vores betalingssystem. For at gøre det skal du bruge tilstanden "CONNECTOR_TEST" til en transaktion, som vist i f.eksamples ovenfor.
Forbindelsesdata for denne test:
| SIKKERHED.AFSENDER | 31HA07BC8142C5A171745D00AD63D182 |
| BRUGER.LOGIN | 31ha07bc8142c5a171744e5aef11ffd3 |
| BRUGER.PWD | 93167DE7 |
| TRANSAKTION.KANAL | 31HA07BC8142C5A171749A60D979B6E4 |
| Valutaer konfigureret til 3D version 2 | EUR, USD, SEK |
| Valutaer konfigureret til 3D version 1 | GBP, CZK, CHF |
System gateway-endepunkt er enten
SGW gateway:
– https://test-heidelpay.hpcgw.net/sgw/gtw – Latin-15-kodet
– https://test-heidelpay.hpcgw.net/sgw/gtwu – UTF-8-kodet
NGW gateway:
– https://test-heidelpay.hpcgw.net/ngw/post
Kreditkortdata for denne test:
| mærker | kortnumre | CVV | udløbsdato | note |
| MasterCard | 5453010000059543 | 123 | fremtidig dato | 3D – adgangskode: hemmeligt3 |
| Visum | 4711100000000000 | 123 | fremtidig dato | 3DS – adgangskode: hemmeligt!33 |
Bemærk venligst: For 3D Secure Version 2 behøver du ikke indtaste en adgangskode, men blot klikke på linket ”Klik her for at fuldføre godkendelsen.
Den eneste måde at simulere en fejl med 3D Secure Version 2 er at lade siden med linket time-out (ca. 18 minutter).
Læs mere om denne manual og download PDF:
Dokumenter/ressourcer
 |
Software 3D Secure Integration Guide [pdfDokumentation Unzer, Integrationsvejledning, 3D Secure |
