Manual for e-betaling Juni 2007

Transkript

1 Manual for e-betaling Juni 2007 Indhold 1 Indledning Gode råd og retningslinjer for nethandel Nordeas danske retningslinjer Overordnet beskrivelse af betalingsforløb Sikkerhed Programmering og dataudveksling Straksbetaling Formatbeskrivelser Kontrolkode til straksbetaling (MAC-koden) Bekræftelse af straksbetaling Kontrolkode til bekræftelse af straksbetaling Betalingskontrol (enquiry) Formatbeskrivelse Kontrolkode til betalingskontrol Retursvar fra betalingskontrollen, forskellige muligheder Kontrolkode til bekræftelse af betalingskontrol Tilbageførsel (Refund) Tilbageførslens datagruppe FORM Kontrolkode til tilbageførsel Retursvar ved tilbageførsel Kontrolkode til bekræftelse af tilbageførsel Test, godkendelse og ibrugtagning Oversigt over butikker Tilbageførsel af gebyrer Fakturering Hjælp at hente Indledning Nordea e-betaling i Danmark er en betalingsløsning, hvor en butik på internettet får mulighed for at modtage betaling direkte fra købers konto. Det er en forudsætning, at køber har adgang til Netbank. Med e-betaling får køberne på internettet mulighed for at betale uden at udlevere kortnummer. For butikkerne er fordelen bl.a. en straksbetaling, som kun gennemføres, hvis der på betalingstidspunktet er dækning på købers konto. Nordeas danske e-betaling kan bruges hver dag fra 6 morgen til 2 nat Netbanks åbningstid. På er der en oversigt over butikker, der har indgået aftale med Nordea om e-betaling. Domestic Payments and e-documents er den danske afdeling i Nordea, der er ansvarlig for oprettelse og vedligeholdelse af butikker med Nordeas danske e- betaling. 1.1 Gode råd og retningslinjer for nethandel Det er butikkens opgave at holde sig ajour med gældende love og retningslinjer. Butikken formulerer og designer selv dialogen med køber i overensstemmelse med de gældende regler og anbefalinger om fjernsalg via internettet. På kan butikker og forbrugere finde information om oplysningspligt, markedsføring og andre emner af betydning for internethandel. Lov om visse forbrugeraftaler indeholder regler om handel via internettet. Loven fastslår bl.a., at køberen som udgangspunkt har 14 dages fortrydelsesret ved fjernsalg. 1.2 Nordeas danske retningslinjer Vi lægger afgørende vægt på, at butikker med e- betaling lever op til forpligtelserne ved udbud og salg af varer og ydelser, se Aftale om Nordea e- betaling, side 1-3. Domestic Payments and e-documents overvåger løbende, at reglerne efterleves. I tvivlstilfælde kan butikken kontakte Domestic Payments and e-documents for fx at få accept af en formulering eller et layout. Ansvaret for at overholde reglerne er alene butikkens, også selvom der anvendes eksterne samarbejdspartnere, webbureau m.m.

2 I forbindelse med Nordea e-betaling på internettet skal butikken vise Nordeas logo der, hvor betalingsmulighederne præsenteres. Logoet skal vises efter de retningslinjer, der er beskrevet nedenfor. Butikken må ikke uden forudgående aftale med banken benytte Nordeas logo: Har butikken en samlet oversigt over mulige betalingsløsninger eller en beskrivelse af dem, skal følgende tekst anføres sammen med Nordeas logo. Er du kunde i Nordea, har du her mulighed for at betale direkte fra din konto, hvis du har Netbank. Beløbet overføres straks fra din konto til butikkens konto. Ønsker du at vide mere om denne betalingsmåde, så klik på Når butikken dirigerer køber videre til Nordea e-betaling, skal linket indlæses i hele vinduet. Dvs. hvis butikken bruger frameset, skal linket evt. have target="_top" eller andet target, der sørger for at indlæse linket i hele vinduet. Butikkens udveksling af betalingsdata fremgår af manualens kapitel 3. Det er vigtigt, at butikken beslutter, hvordan betalingsreferencen skal opbygges. Typisk er referencen identisk med et fakturanummer, ordrenummer eller lignende. 3. E-serveren godkender butikkens identitet og betalingsdata og starter herefter logon til købers Netbank. 4. Efter logon i Netbank præsenteres køber for et billede med fakturabeløb, navn på betalingsmodtager og købers konti med angivelse af de disponible beløb. Butikkens betalingsreference følger betalingen (skjult for køber), og køber har ikke mulighed for at ændre i referencen. Alt dette og følgende trin foregår på Nordeas hjemmeside. 5. Køber vælger Betal, og betalingen gennemføres herefter. Køber får en bekræftelse fra Nordea om, at betalingen er gennemført Beskrivelse af e-betaling i Danmark Køber 1. Bestiller varer 2. E-betaling Butik E-server Køber opfordres til at vende tilbage til internetbutikken, hvor butikken normalt også præsenterer en bekræftelse på ordren. Når køber går tilbage til butikken via det ønskede returlink, får butikken samtidig data fra Nordea, som viser, at betalingen er gennemført. Køber 3. Kontrol af butik og betalingsdata 4. Bekræfter betaling Butikken bør kontrollere, at beløbet er overført til butikkens konto. Det kan gøres ved hjælp af den http-baserede betalingskontrol, som er beskrevet under afsnit 3.2. Betalingskontrol kan også ske via kontoudskrift i Netbank, Unitel eller Corporate Netbank. 5. Betaling gennemføres Nordea 1.3 Beskrivelse af betalingsforløb 1. Køber bestiller varer i butikken på internettet. Butikken formulerer og designer selv dialogen med køber. 2. Når køber skal betale for varerne, viser butikken følgende: samlet fakturabeløb, købers navn og leveringsadresse. I fakturabilledet kan køber typisk vælge mellem flere forskellige betalingsmåder ved at klikke på et ikon. Nordeas logo placeres side om side med de øvrige betalingsformer, butikken tilbyder. 2 Sikkerhed Dataudvekslingen mellem butikken og Nordeas e-server er SSL-krypteret og MAC-kode-beskyttet. Det sikrer data-autenticitet hos både butikken og Nordea, dvs. afsender og modtager kan have fuld tillid til hinandens identitet. Dataudvekslingen mellem køber og Nordea er krypteret via Netbank. Det vil sige, at udenforstående hverken kan læse eller ændre de data, som overføres mellem køber og Nordea. Køber foretager logon i Nordeas webserver med personligt password til Netbank. Der udveksles ingen oplysninger om køber mellem butikken og Nordea. 2

3 Dataudveksling Køber SSL + MAC Butik E-server 3 Programmering og dataudveksling Nordea e-betaling baserer sig på HTML-programmering. Når køber klikker på betalingsikonet på butikkens hjemmeside, sendes data i en FORM til e-serveren. Beskrivelse af datafelter og serveradresser ses nedenfor. Køber SSL + MAC Krypteret Nordea Det er butikkens ansvar at tilrettelægge en procedure for sikker modtagelse og opbevaring af MACnøglen, så ingen kan få uretmæssig adgang til MAC-nøglen via lagringsmedier/servere m.m. Ansvaret gælder, uanset om butikken selv varetager opgaverne, eller det sker via en samarbejdspartner. Nordeas logoer kan downloades fra tilmelding. 3.1 Straksbetaling Butikkens betalingsdata sendes til Nordea med et FORM POST. Når butikken dirigerer køber videre til Nordea e-betaling, skal linket indlæses i hele vinduet (se 1.2). Strukturen er på HTML-sprog og skal indeholde følgende: E-betalingens initialoplysninger <FORM METHOD="POST" ACTION=" <INPUT NAME="..." TYPE="..." VALUE="..."> </FORM> Metode = POST Server: //solo3.nordea.fi/... E-betalingens reelle oplysninger: navn, type, værdi E-betalingens afslutning 3

4 3.1.1 Formatbeskrivelse F# Oplysning Oplysningens navn Værdi Type V/O DATA= INPUT NAME= VALUE= FORMAT= 1 Betalingsversion SOLOPMT_VERSION "0002" AN 4 O 2 Betalingskode SOLOPMT_STAMP Entydig kode til teknisk individua- AN 20 O lisering af betalingen 3 Butiks-ID SOLOPMT_RCV_ID Butikkens aftalenr. AN 10 O 4 Butikskonto SOLOPMT_RCV_ACCOUNT Anden konto end default-kontoen AN 14 V (registreringsnr. + kontonummer) (N4+N10) 5 Butiksnavn SOLOPMT_RCV_NAME Andet end default navn AN 20 V (maks. 20 karakterer) 6 Betalingssprog SOLOPMT_LANGUAGE 1 = finsk; 2 = svensk; 3 = engelsk AN 1 V 4 = estisk; 5 = dansk; default = 5 7 Betalingsbeløb SOLOPMT_AMOUNT Fx 2990,00 AN 19 O 8 Betalingsreference SOLOPMT_REF Entydig reference på betalingen AN 20 O 9 Betalingens SOLOPMT_DATE "EXPRESS" AN 10 O forfaldsdato 10 Betalings- SOLOPMT_MSG Blank; AN 234 V meddelelse feltet bruges ikke i Nordea Danmark 11 Returlink SOLOPMT_RETURN Returadresse efter betaling AN 120 O 12 Annuller-link SOLOPMT_CANCEL Returadresse ved annullering AN 120 O 13 Afvist-link SOLOPMT_REJECT Returadresse ved afvist betaling AN 120 O 14 MAC-kode SOLOPMT_MAC Kontrolkode for betalingen AN 32 O 15 Bekræftelse af SOLOPMT_CONFIRM YES eller NO A 3 O betalingen 16 Nøgleversion SOLOPMT_KEYVERS Fx 0001 N 4 O 17 Valutakode SOLOPMT_CUR DKK A 3 O Supplerende forklaringer AN = alfanumerisk, dvs. dataindholdet består af bogstaver og tal A = dataindholdet består af bogstaver N = dataindholdet består af tal V/O = oplysningen er valgfri eller obligatorisk. Felt 1 Version af betalingen: Med nummeret på betalingsversionen præciseres den form, der oplysningerne i betalingen skal præsenteres i. Felt 2 Felt 3 Betalingskoden defineres af butikken. Den gør betalingen unik og forhindrer, at betalingen indlæses to gange. Koden kan være en reference eller en kombination af dato, klokkeslæt og et løbende referencenummer. Butiks-ID er den identifikation, som Nordea tildeler butikken. Butiks-ID er nøglen til butikkens stamoplysninger, herunder forretningens navn og konti i banken. 4

5 Felt 4 Skal en anden konto end default-konto bruges, sættes den ind her. Det kræves dog, at den pågældende konto er registreret i Nordea. Felt 5 Felter bør altid være udfyldt med butikkens forkortede navn (maksimalt 20 karakterer). Felt 6 For danske butikker er dansk indtil videre eneste sprog over for køber. Felt 7 Felt 8 Beløbet, der skal trækkes på købers konto. Betalingens reference. Butikkens egen reference (fx fakturanummer), som følger betalingen for til sidst at fremgå af butikkens kontoudtog. Brug af specialtegn i referencen kan give problemer for MAC-beregningen. Evt. brug af specialtegn kan afprøves i vores testbutik, se kapitel 4. Felt 9 Viser betalingens forfaldsdato. Betalinger kan p.t. kun udføres som straksbetaling, dvs. feltet skal have værdien "EXPRESS". Felt 10 Betalingsmeddelelse til køber. Feltet bruges ikke af Nordea i Danmark. Eventuelt feltindhold slettes af Nordea. Felt 11 Returlink er den URL-adresse hos butikken, som køber ønskes dirigeret hen til, når e- betalingen er vel gennemført. Den skal bestå af en komplet URL-adresse i HTML-format, fx: Felt 12 Annuller-link er den URL-adresse hos butikken, som køber skal returnere til, hvis køber fortryder og annullerer undervejs i betalingsprocessen. Adressen skal bestå af en fuldstændig URL-adresse på HTML-sprog, fx: Felt 13 Afvist-link er den URL-adresse hos butikken, som køber kan returnere til, hvis betalingen afvises i bankens systemer, fx som følge af fejl i forretningens data eller fejl i bankens systemer. Adressen skal bestå af en fuldstændig URL-adresse på HTML-sprog, fx: Felt 14 MAC-kode (se 3.1.2) bekræfter butikkens identitet og sikrer, at betalingen ikke kan ændres. Den beregnes med en MD5-algoritme af de oplysninger i betalingen, som skal beskyttes. Felt 15 Bekræftelse af betalingen. Ønsker butikken, at køber returneres til butikkens URLadresse, efter at betalingen er gennemført, skal der stå "YES" i feltet. Ved "NO" fortæller butikken, at køber ikke skal returneres til det oplyste link i felt 11. Ved returnering (dvs. YES) medbringes data (se 3.1.3), som viser, om betalingen er vel udført. Felt 16 Nøgleversion viser, hvilken version af MACnøglen der er i brug (der kan forekomme flere nøgleversioner). Felt 17 Valutakoden viser betalingens valuta. Overførsler mellem danske butikker og danske købere skal være i DKK - danske kroner Kontrolkode til straksbetaling (MAC-koden) For at være sikker på, at ingen har pillet ved data undervejs, er data MAC-beregnet. For at lave en sådan beregning skal butikken bruge en MAC-nøgle. Denne MAC-nøgle leveres fra Nordea højst ti dage, efter at aftalen er indgået, se kapitel 4. Når nøglen er modtaget, er Nordea e-betaling i produktion. MAC-nøglen er kendetegnet ved at være:. 32 karakterer lang. specifik for den enkelte butik. Nøglen skal behandles sikkerhedsmæssigt korrekt, se kapitel 2. Ud fra butikkens nøgle og de data, der sendes til Nordea, beregnes en MAC-kode. MAC-koden til betalingen fremkommer på følgende måde: 1. En tegnstreng dannes af følgende felters værdier i nævnte rækkefølge: SOLOPMT_VERSION&SOLOPMT_STAMP& SOLOPMT_RCV_ID&SOLOPMT_AMOUNT& SOLOPMT_REF&SOLOPMT_DATE&SOLOPMT _CUR&Butikkens MAC-nøgle& Tegnstrengen har ikke blanktegn, og &-tegn er med i beregningen. Eksempelvis: 0002& & &315,00& &EXPRESS&DKK& & 2. Ved at bruge algoritmen MD5 beregnes en såkaldt hashværdi på basis af den nævnte tegnstreng, og den omformes til heksadecimal form 5

6 med maksimalt 32 karakterer. Resultatet af MD5- beregning af ovennævnte streng giver: 70b2d660bb93a34977c29717a Den opnåede hashværdi skal omformes til store bogstaver og føres til feltet SOLOPMT_MAC: SOLOPMT_MAC="70B2D660BB93A34977C2971 7A " Bekræftelse af straksbetaling Ved hjælp af informationer i returlinket til butikken (se 3.1.1, felt 11) kan butikken på sin webside få oplyst, om betalingen er gennemført. Bemærk: Den egentlige betaling, altså overførslen af pengene, bør altid kontrolleres ved en HTTPS request til bankens betalingssystem eller ved forespørgsel på kontoudskrift fx via Unitel eller Corporate Netbank. Har butikken bedt om en bekræftelse af betalingen ved at skrive "YES" i feltet "SOLOPMT_CONFIRM" (se 3.1.1, felt 16), giver bankens system parameteroplysninger i form af en såkaldt query string i slutningen af returlinket se nedenfor. Retursvaret er i form og indhold det samme som det, der blev sendt med den oprindelige betaling, på nær MAC-koden, som er beregnet ud fra returdata. (Bemærk, at der bruges bindestreg i felternes navne) Kontrolkode til bekræftelse af straksbetaling SOLOPMT-RETURN-MAC beregnes på samme måde som i den egentlige e-betaling ved at skabe en tegnstreng af indholdet i retursvaret ud fra felterne (se 3.1.2): SOLOPMT-RETURN-VERSION&SOLOPMT- RETURN-STAMP&SOLOPMT-RETURN-REF& SOLOPMT-RETURN-PAID&Butikkens MACnøgle& Tegnstrengen har ingen blanktegn, og &-tegnet er med i beregningen. Ved at bruge algoritmen MD5 beregnes en såkaldt hashværdi på basis af den nævnte tegnstreng, og den omformes til heksadecimal form med maksimalt 32 karakterer. Denne værdi returneres til butikken i returparameteren SOLOPMT-RETURN-MAC. Et eksempel på anvendelse af returlink og kontrolkode:. Feltet SOLOPMT_RETURN har værdien: VALUE=" Ved retur til butikken kan retur-url fx have følgende indhold: RETURN-VERSION=0002&SOLOPMT-RETURN- STAMP= &SOLOPMT-RETURN- REF=121857&SOLOPMT-RETURN- PAID= &SOLOPMT-RETURN- MAC=D4C6FCDF7FF349E2DCA96523F9797C04 F# Oplysning Oplysningens navn Værdi Type V/O DATA= INPUT NAME= VALUE= FORMAT= 1 Betalingsversion SOLOPMT-RETURN-VERSION 0002 AN 4 O 2 Betalingskode SOLOPMT-RETURN-STAMP Butikkens tekniske identificering AN 20 O af betalingen 3 Betalingsreference SOLOPMT-RETURN-REF Butikkens reference AN 20 O 4 Bekræftelses-ident SOLOPMT-RETURN-PAID Nordeas identifikation af betalingen AN 20 O 5 Retur MAC-kode SOLOPMT-RETURN-MAC Kontrolkode for bekræftelsen AN 32 O Supplerende forklaringer: AN = alfanumerisk, dvs. dataindholdet består af bogstaver og tal V/O = oplysningen er valgfri eller obligatorisk. 6

7 3.2 Betalingskontrol (enquiry) Betalingskontrollen initieres på følgende måde: Betalingskontrollens initialoplysninger <FORM METHOD="POST" ACTION=" <INPUT NAME="..."TYPE="..."VALUE="..."> </FORM> Metode = POST Server: //solo3.nordea.fi/... Betalingskontrollens reelle oplysninger: navn, type, værdi Betalingskontrollens afslutning Formatbeskrivelse F# Oplysning Oplysningens navn Værdi Type V/O DATA= INPUT NAME= VALUE= FORMAT= 1 Betalingskontrol- SOLOPMT_VERSION "0001" AN 4 O version 2 Tidspunkt for SOLOPMT_TIMESTMP YYYYMMDDHHMMSSnnnn, N 18 O forespørgsel hvor nnnn kan være et serienummer 3 Butiks-ID SOLOPMT_RCV_ID Butikkens aftalenr. AN 10 O 4 Betalingssprog SOLOPMT_LANGUAGE 1 = finsk, 2 = svensk, 3 = engelsk, N 1 O 4 = estisk, 5 = dansk (default) 5 Retursvartype SOLOPMT_RESPTYPE HTML AN 4 O 6 Informationer i SOLOPMT_RESPDATA Hvis FORM-datagruppe ønskes AN 200 V retursvaret med i retursvaret, tilføjes den fulde URL-adresse for datagruppen. Står feltet tomt, kommer FORMdatagruppen ikke med i retursvaret. 7 Retursvarets SOLOPMT_RESPDETL "Y"= Retursvarets FORM- N er default V FORM-datagruppe datagruppe synlig som HTML. synlig som HTML "N"= Retursvarets FORMdatagruppe ikke synlig 8 Betalingskode SOLOPMT_STAMP Entydig kode til identifikation af AN 20 O betalingen 9 Betalingsreference SOLOPMT_REF Entydig reference på betalingen AN 20 O 10 Nøgleversion SOLOPMT_KEYVERS Version af MAC-nøgle, som bruges, N 4 O fx Algoritmenummer SOLOPMT_ALG 01 N2 O 12 MAC-kode SOLOPMT_MAC Kontrolkode for betalingen AN 32 O Supplerende forklaringer AN = alfanumerisk, dvs. dataindholdet består af bogstaver og tal N V/O = dataindholdet består af tal = oplysningen er valgfri eller obligatorisk. 7

8 3.2.2 Kontrolkode til betalingskontrol SOLOPMT-MAC beregnes på samme måde som ved en straksbetaling, nemlig ved at skabe en tegnstreng ud fra følgende felter i nævnte rækkefølge (se 3.1.2): SOLOPMT_VERSION&SOLOPMT_TIMESTMP& SOLOPMT_RCV_ID&SOLOPMT_LANGUAGE& SOLOPMT_RESPTYPE&SOLOPMT_RESPDATA& SOLOPMT_RESPDETL&SOLOPMT_STAMP& SOLOPMT_REF&SOLOPMT_KEYVERS& SOLOPMT_ALG&Butikkens MAC-nøgle& Når MAC-koden skal beregnes, skal samtlige felter MAC-beregnes. Dvs. at hvis eventuelle valgfri felter udelades, skal disse ikke med i beregningen. Der skal således ikke være to &-tegn ved siden af hinanden. Det skal dog bemærkes, at hvis felt 7 er udfyldt, skal felt 6 også være det, mens det omvendte ikke er påkrævet Retursvar fra betalingskontrollen, forskellige muligheder Retursvaret fra en betalingskontrolforespørgsel indeholder en HTML-header, og hvis feltet SOLOPMT_RESPDATA er udfyldt med en URL, tilføjes en FORM-datagruppe med retursvaret. Retursvaret varierer afhængigt af, om forespørgslen afvises eller accepteres, og hvis den accepteres om betalingen kan findes eller ej. Forespørgslen afvises Afvises forespørgslen på grund af fejl i MAC-kode eller andre sikkerhedstjek, er tilbagesvaret en httpfejlmeddelelse med svarstatus "404, HTTP fejl 404 URL ikke fundet". Forespørgslen accepteres Accepteres forespørgslen, indeholder feltet SOLOPMT_RESPCODE en statuskode, der angiver, om betalingen blev fundet (OK), ikke fundet (Notfound), eller der skete en fejl (Error). I alle tilfælde indeholder svaret en header, hvori retursvaret ligger separeret med semikolon(;). Eksempelvis: <HEAD> <!-- SOLOPM10_RESPONSE_START;felt1=værdi1;felt2= værdi2;solopm10_response_end; --> </HEAD> Bemærk, at i øjeblikket er alle værdierne i headeren URL-kodede, på nær SOLOPMT_PAID. Da den kan indeholde mellemrum, er de ikke angivet ved plusser. Derimod er eventuelle mellemrum i SOLOPMT_REF angivet ved plusser. Betalingen findes Findes betalingen, indeholder feltet SOLOPMT_RESPCODE værdien "OK". Der returneres følgende felter, som i nævnte rækkefølge er i headeren separeret med semikolon(;). 8

9 F# Oplysning Oplysningens navn Værdi Type V/O DATA= INPUT NAME= VALUE= FORMAT= 1 Betalingsversion SOLOPMT_VERSION 0001 AN 4 O 2 Tidspunkt for SOLOPMT_TIMESTMP YYYYMMDDHHMMSSnnnn, N 18 O forespørgsel hvor nnnn kan være et serienummer 3 Butiks-ID SOLOPMT_RCV_ID Aftalenummer AN 10 O 4 Søgeresultat SOLOPMT_RESPCODE OK, Notfound, Error AN 8 O 5 Betalingskode SOLOPMT_STAMP Entydig kode til identifikation af AN 20 O betalingen 6 Butikskonto SOLOPMT_RCV_ACCOUNT Konto for indsat beløb AN14 V 7 Betalingsreference SOLOPMT_REF Entydig reference på betalingen AN 20 V 8 Betalingens SOLOPMT_DATE Dato for betaling AN 10 V forfaldsdato 9 Betalingsbeløb SOLOPMT_AMOUNT Fx Beløbet opgives i øre AN 19 V 10 Valuta SOLOPMT_CUR DKK A 3 V 11 Betalings-ID SOLOPMT_PAID AN 20 V 12 Statuskode, SOLOPMT_STATUS Prod = betalingsmiljø AN 4 V system miljø Test = testmiljø "Demo" = demomiljø (se kapitel 4) 13 Nøgleversion SOLOPMT_KEYVERS Version af MAC-nøglen, N 4 O som bruges, fx "0001" 14 Algoritmenummer SOLOPMT_ALG 01 N 2 O 15 MAC-kode SOLOPMT_MAC Kontrolkode for betalingskontrollen AN 32 V Supplerende forklaringer AN = alfanumerisk, dvs. dataindholdet består af bogstaver og tal A = dataindholdet består af bogstaver N = dataindholdet består af tal V/O = oplysningen er valgfri eller obligatorisk. Betalingen kan ikke findes, eller forespørgslen fejler Kan betalingen ikke findes, indeholder feltet SOLOPMT_RESPCODE værdien "Notfound". Er flere betalinger lavet med den samme reference, eller er noget gået galt undervejs, har SOLOPMT_RESP- CODE værdien "Error". Der returneres følgende felter, som i nævnte rækkefølge er i headeren separeret med semikolon(;). 9

10 F# Oplysning Oplysningens navn Værdi Type V/O DATA= INPUT NAME= VALUE= FORMAT= 1 Betalingsversion SOLOPMT_VERSION 0001 AN 4 O 2 Tidspunkt for SOLOPMT_TIMESTMP YYYYMMDDHHMMSSnnnn, N 18 O Forespørgsel hvor nnnn kan være et serienummer 3 Butiks-ID SOLOPMT_RCV_ID Aftalenummer AN 10 O 4 Søgeresultat SOLOPMT_RESPCODE OK, Notfound, Error AN 8 O 5 Betalingskode SOLOPMT_STAMP Entydig kode til identifikation AN 20 O af betalingen 6 Betalingsreference SOLOPMT_REF Entydig reference på betalingen AN 20 V 7 Statuskode, SOLOPMT_STATUS Prod = betalingsmiljø AN 4 V system miljø Test = testmiljø "Demo" = demomiljø (se kapitel 4) 8 Nøgleversion SOLOPMT_KEYVERS Version af MAC-nøglen, som bruges, N 4 O fx Algoritmenummer SOLOPMT_ALG 01 N 2 O 10 MAC-kode SOLOPMT_MAC Kontrolkode for betalingskontrollen AN 32 V Supplerende forklaringer AN = alfanumerisk, dvs. dataindholdet består af bogstaver og tal N = dataindholdet består af tal V/O = oplysningen er valgfri eller obligatorisk Kontrolkode til bekræftelse af betalingskontrol SOLOPMT_MAC beregnes på samme måde som tidligere (se 3.1.2). Der er forskel på, hvilke felter der returneres, afhængigt af om betalingen findes eller ej. Findes betalingen, beregnes MAC-koden ud fra følgende felter: SOLOPMT_VERSION&SOLOPMT_TIMESTMP& SOLOPMT_RCV_ID&SOLOPMT_RESPCODE& SOLOPMT_STAMP&SOLOPMT_RCV_ACCOUNT &SOLOPMT_REF&SOLOPMT_DATE&SOLOPMT_ AMOUNT&SOLOPMT_CUR&SOLOPMT_PAID& SOLOPMT_STATUS&SOLOPMT_KEYVERS& SOLOPMT_ALG&Butikkens MAC-nøgle& Findes betalingen ikke, beregnes MAC-koden ud fra: SOLOPMT_VERSION&SOLOPMT_TIMESTMP& SOLOPMT_RCV_ID&SOLOPMT_RESPCODE& SOLOPMT_STAMP&SOLOPMT_REF&SOLOPMT_ STATUS&SOLOPMT_KEYVERS&SOLOPMT_ALG &Butikkens MAC-nøgle& 10

11 3.3 Tilbageførsel (Refund) Tilbageførsel af en tidligere betaling initieres på følgende måde: Betalingskontrollens initialoplysninger <FORM METHOD="POST" ACTION=" <INPUT NAME="..."TYPE="..."VALUE="..."> </FORM> Metode = POST Server: //solo3.nordea.fi/... Betalingskontrollens reelle oplysninger: navn, type, værdi Betalingskontrollens afslutning 11

12 3.3.1 Tilbageførslens datagruppe FORM F# Oplysning Oplysningens navn Værdi Type V/O DATA= INPUT NAME= VALUE= FORMAT= 1 Betalingskontrol/ SOLOPMT_VERSION "0001" AN 4 O refund-version 2 Tidspunkt for SOLOPMT_TIMESTMP YYYYMMDDHHMMSSnnnn, N 18 O forespørgsel hvor nnnn kan være et serienummer 3 Butiks-ID SOLOPMT_RCV_ID Butikkens aftalenr. AN 10 O 4 Betalingssprog SOLOPMT_LANGUAGE 1 = finsk, 2 = svensk, 3 = engelsk, 4 = estisk, 5 = dansk (default) N 1 O 5 Retursvartype SOLOPMT_RESPTYPE HTML AN 4 O 6 Informationer i SOLOPMT_RESPDATA Hvis FORM-datagruppe ønskes AN 200 V retursvaret med i retursvaret, tilføjes den fulde URL-adresse for datagruppen. Står feltet tomt, kommer FORMdatagruppen ikke med i retursvaret. 7 Retursvarets SOLOPMT_RESPDETL "Y"= Retursvarets FORM-datagruppe N er default V FORM-datagruppe synlig som HTML. N = Retursvarets synlig som HTML FORM-datagruppe ikke synlig. 8 Betalingskode SOLOPMT_STAMP Entydig kode til identifikation AN 20 O af betalingen 9 Betalingsreference SOLOPMT_REF Entydig reference på betalingen AN 20 O 10 Beløb SOLOPMT_AMOUNT Beløb, som skal tilbageføres AN 19 O 11 Valutakode SOLOPMT_CUR DKK AN 3 O 12 Tilbageførsels- SOLOPMT_REF2 Butikkens egen reference ved AN 20 O reference tilbageførslen 13 Nøgleversion SOLOPMT_KEYVERS Version af MAC-nøgle, som bruges, N 4 O fx Algoritmenummer SOLOPMT_ALG 01 N 2 O 15 MAC-kode SOLOPMT_MAC Kontrolkode for betalingen AN 32 O Supplerende forklaringer: AN = alfanumerisk, dvs. dataindholdet består af bogstaver og tal N = dataindholdet består af tal V/O = oplysningen er valgfri eller obligatorisk. 12

13 3.3.2 Kontrolkode til tilbageførsel SOLOPMT_MAC beregnes på samme måde som ved en straksbetaling, nemlig ved at skabe en tegnstreng ud fra følgende felter i nævnte rækkefølge, hvis de er medtaget (se 3.1.2): SOLOPMT_VERSION&SOLOPMT_TIMESTMP& SOLOPMT_RCV_ID&SOLOPMT_LANGUAGE& SOLOPMT_RESPTYPE&SOLOPMT_RESPDATA& SOLOPMT_RESPDETL&SOLOPMT_STAMP& SOLOPMT_REF&SOLOPMT_AMOUNT& SOLOPMT_CUR&SOLOPMT_REF2&SOLOPMT_ KEYVERS&SOLOPMT_ALG&Butikkens MACnøgle& Når MAC-koden skal beregnes, skal samtlige felter MAC-beregnes. Dvs. at hvis eventuelle valgfri felter udelades, skal disse ikke med i beregningen. Der skal således ikke være to &-tegn ved siden af hinanden. Det skal dog bemærkes, at hvis felt 7 er udfyldt, skal felt 6 også være det, mens det omvendte ikke er påkrævet Retursvar ved tilbageførsel Retursvaret fra en tilbageførsel ligner en betalingsforespørgsel. Den indeholder en HTML-header, og hvis feltet SOLOPMT_RESPDATA er udfyldt med en URL, tilføjes en FORM-datagruppe med retursvaret. Retursvaret varierer, afhængigt af om forespørgslen afvises eller accepteres, og hvis den accepteres om betalingen kan findes eller ej. Forespørgslen afvises Afvises forespørgslen på grund af fejl i MAC-kode eller andre sikkerhedstjek, er tilbagesvaret en httpfejlmeddelelse med svarstatus "404, HTTP fejl 404 URL ikke fundet". Forespørgslen accepteres Accepteres forespørgslen, indeholder feltet SOLOPMT_RESPCODE en statuskode, der angiver, at tilbageførslen blev foretaget (OK), at den originale betaling ikke blev fundet (Notfound), eller at tilbageførslen ikke kunne foretages (Error). I alle tilfælde indeholder svaret en header, hvori retursvaret ligger separeret med semikolon(;). Eksempelvis: <HEAD> <!-- SOLOPM09_RESPONSE_START;felt1=værdi1;felt2= værdi2;solopm09_response_end; --> </HEAD> Tilbageførslen foretaget Findes den originale betaling, og tilbageførslen foretages, indeholder feltet SOLOPMT_RESPCODE værdien "OK". Feltet SOLOPMT_REF indeholder nu værdien af SOLOPMT_REF2 og er på butikkens kontoudtog. Der returneres følgende felter, som i nævnte rækkefølge er i headeren separeret med semikolon(;). 13

14 F# Oplysning Oplysningens navn Værdi Type V/O DATA= INPUT NAME= VALUE= FORMAT= 1 Betalingsversion SOLOPMT_VERSION 0001 AN 4 O 2 Tidspunkt for SOLOPMT_TIMESTMP YYYYMMDDHHMMSSnnnn, N 18 O Forespørgsel hvor nnnn kan være et serienummer 3 Butiks-ID SOLOPMT_RCV_ID Aftalenummer AN 10 O 4 Søgeresultat SOLOPMT_RESPCODE OK, Notfound, Error AN 8 O 5 Betalingskode SOLOPMT_STAMP Entydig kode til identifikation AN 20 O af betalingen 6 Butikskonto SOLOPMT_RCV_ACCOUNT Konto for indsat beløb AN14 V 7 Betalingsreference SOLOPMT_REF Reference på Refund AN 20 V 8 Betalingens SOLOPMT_DATE Dato for betaling AN 10 V forfaldsdato 9 Betalingsbeløb SOLOPMT_AMOUNT Fx 99000, beløbet opgives i øre AN 19 V 10 Valuta SOLOPMT_CUR DKK A 3 V 11 Betalings-ID SOLOPMT_PAID AN 20 V 12 Statuskode, SOLOPMT_STATUS Prod = betalingsmiljø AN 4 V systemmiljø Test = testmiljø "Demo" = demomiljø (se kapitel 4) 13 Nøgleversion SOLOPMT_KEYVERS Version af MAC-nøglen, som bruges, N 4 O fx Algoritmenummer SOLOPMT_ALG 01 N 2 O 15 MAC-kode SOLOPMT_MAC Kontrolkode for betalingskontrollen AN 32 V Supplerende forklaringer AN = alfanumerisk, dvs. dataindholdet består af bogstaver og tal A = dataindholdet består af bogstaver N = dataindholdet består af tal V/O = oplysningen er valgfri eller obligatorisk. 14

15 F# Oplysning Oplysningens navn Værdi Type V/O DATA= INPUT NAME= VALUE= FORMAT= 1 Betalingsversion SOLOPMT_VERSION 0001 AN 4 O 2 Tidspunkt for SOLOPMT_TIMESTMP YYYYMMDDHHMMSSnnnn, N 18 O forespørgsel hvor nnnn kan være et serienummer 3 Butiks-ID SOLOPMT_RCV_ID Aftalenummer AN 10 O 4 Søgeresultat SOLOPMT_RESPCODE OK, Notfound, Error AN 8 O 5 Betalingskode SOLOPMT_STAMP Entydig kode til identifikation af AN 20 O betalingen 6 Betalingsreference SOLOPMT_REF Entydig reference på betalingen AN 20 V 7 Statuskode, SOLOPMT_STATUS Prod = betalingsmiljø AN 4 V systemmiljø Test = testmiljø "Demo" = demomiljø (se kapitel 4) 8 Nøgleversion SOLOPMT_KEYVERS Version af MAC-nøglen, som bruges, N 4 O fx Algoritmenummer SOLOPMT_ALG 01 N 2 O 10 MAC-kode SOLOPMT_MAC Kontrolkode for betalingskontrollen AN 32 V Supplerende forklaringer AN = alfanumerisk, dvs. dataindholdet består af bogstaver og tal N = dataindholdet består af tal V/O = oplysningen er valgfri eller obligatorisk. Tilbageførslen kan ikke foretages Findes den originale betaling ikke, indeholder feltet SOLOPMT_RESPCODE værdien "Notfound". Kan tilbageførslen ikke foretages, har SOLOPMT_RESPCODE værdien "Error". Her indeholder SOLOPMT_REF en reference på den originale betaling, der skulle tilbageføres. Der returneres følgende felter, som i nævnte rækkefølge er i headeren separeret med semikolon(;) Kontrolkode til bekræftelse af tilbageførsel SOLOPMT_MAC beregnes på samme måde som tidligere (se 3.1.2). Der er forskel på, hvilke felter der returneres, afhængigt af om tilbageførslen blev foretaget eller ej. Foretages tilbageførslen, beregnes MAC-koden ud fra følgende felter: SOLOPMT_VERSION&SOLOPMT_TIMESTMP& SOLOPMT_RCV_ID&SOLOPMT_RESPCODE&; SOLOPMT_STAMP&SOLOPMT_RCV_ACCOUNT &SOLOPMT_REF&SOLOPMT_DATE&SOLOPMT_ AMOUNT&SOLOPMT_CUR&SOLOPMT_PAID& SOLOPMT_STATUS&SOLOPMT_KEYVERS& SOLOPMT_ALG&Butikkens MAC-nøgle&Blev betalingen ikke tilbageført, beregnes MAC-koden ud fra: SOLOPMT_VERSION&SOLOPMT_TIMESTMP& SOLOPMT_RCV_ID&SOLOPMT_RESPCODE&; SOLOPMT_STAMP&SOLOPMT_REF&SOLOPMT_ STATUS&SOLOPMT_KEYVERS&SOLOPMT_ALG &Butikkens MAC-nøgle& 4 Test, godkendelse og ibrugtagning Butikken kan til enhver tid teste e-betalinger og betalingskontrol, før aftalen træder i kraft. Du simulerer da en butik ved navn "test-butikken". Nedenfor er det danske test-setup beskrevet. Det kan afprøves på: " Vær opmærksom på, at sprogfeltet SOLOPMT_LANGUAGE skal være "5" for dansk, og valutakodefeltet SOLOPMT_CUR skal være: "DKK". Butiks-ID (SOLOPMT_RCV_ID): MAC-nøgle: (32 karakterer lang) Nøgleversion: 0001 Testkonto: (valgfri). 15

16 Testbutikken får svar med det samme fra testmodulet. Modtages data og MAC-kode korrekt, viser browseren et testbillede til brug for butikken eller webprogrammøren. Her kan der i den efterfølgende dialog vælges Fortsæt. Modtages data og/eller MAC-kode med fejl, gengives datafelter på et svarbillede sammen med en fejlkode. Når butikken har gennemført en grundig test af dataudvekslingen mellem butikken og e-serveren, skal den tage kontakt til Domestic Payments and e- documents for at aftale tidspunkt for igangsætning i produktionsmiljø. Adressen fremgår af kapitel 8, "Hjælp at hente". Ønsker butikken yderligere test med e-betaling, skal der laves en aftale med Nordea om e-betaling. Butikken skal huske at udskifte testnøglen med den fremsendte MAC-nøgle og butiks-id ved overgangen til produktion. 5 Oversigt over butikker Domestic Payments and e-documents sørger for, at der oprettes et link til butikkens hjemmeside fra hvis det er aftalt med butikken. Oprettelsen sker samtidig med, at Nordeas danske e-betaling er endeligt testet og godkendt. Oprettelsen på kan ske, når følgende er opfyldt:. Testen er vel gennemført (se kapital 4 ovenfor).. Butikken har modtaget sit butiks-id (se kapitel 4 ovenfor).. Butikken har givet kort beskrivelse af hvilke produkter, den handler med (max. 50 karakterer inkl. mellemrum) og hvilken varegruppe, de tilhører. Oplysningerne mailes til Domestic Payments and e-documents på adressen: e-betaling@nordea.dk. Bekræftelse på de modtagne oplysninger mailes tilbage til butikken på den adresse, der er anført i aftalen. Varegrupper Varegruppen er bestemmende for, hvor butikken placeres på oversigten. Butikken kan vælge flere varegrupper, hvis den udbyder varer inden for flere kategorier. Derudover bliver butikkerne vist i alfabetisk orden. De mulige varegrupper fremgår af på adressen Oplysningerne sendes i en mail til Domestic Payments and e-documents. Bekræftelse på de modtagne oplysninger mailes tilbage til butikken på den adresse, der er anført i aftalen. Ændringer skal meddeles til Domestic Payments and e-documents. Kort beskrivelse Der er mulighed for at få vist en kort beskrivelse (max. 50 karakterer inkl. mellemrum). Oprettelse og ændringer sker på samme måde som beskrevet ovenfor under varegrupper. 6 Tilbageførsel af beløb Fortryder køber sit køb eller har indsigelser over for det købte, skal køber først og fremmest henvende sig til butikken. Eksempler på indsigelser: den leverede vare lever ikke op til den forventede kvalitet, eller varen er slet ikke leveret. Butikken har i sådanne tilfælde pligt til straks at tilbageføre beløbet eller den krævede del deraf til køber, mens indsigelsen behandles. En køber, der henvender sig til Domestic Payments and e-documents eller en af Nordeas filialer i forbindelse med indsigelser eller fortrydelse, bliver som udgangspunkt henvist til butikken. Kun hvis denne henvendelse er uden resultat, tilbagefører rådgiveren beløbet til købers konto. Den underskrevne indsigelsesblanket fra køber indsendes til Domestic Payments and e-documents som trækker pengene fra butikkens konto. Spørgsmål om betaling for den solgte ydelse er herefter banken uvedkommende. 7 Fakturering De aktuelle danske gebyrer fremgår af Prisliste for nordea e-betaling. Oprettelsesgebyr opkræves, umiddelbart efter at Aftale om Nordea e-betaling er underskrevet. Abonnements- og transaktionsgebyrer opkræves kvartalsvis bagud. Transaktionsgebyrer trækkes på den konto, hvor salget er blevet bogført. Bruger butikken flere konti til Nordea e-betaling, trækkes transaktionsgebyr på hver enkelt konto i henhold til gældende priser. Postering af handler har følgende ordlyd: "e-betaling". 16

17 8 Hjælp at hente Er der problemer eller spørgsmål i oprettelsesog testfasen, kontakt da Domestic Payments and e-documents på e-betaling@nordea.dk eller pr. telefon på Åbningstiden er 9-16 alle hverdage Nordea Bank Danmark A/S, CVR-nr , København 17