SPARBANKENS NÄTBETALNING BRUKSANVISNING OCH POSTBESKRIVNINGAR 1.8.2016 version 1.4

SPARBANKENS NÄTBETALNING

BRUKSANVISNING OCH POSTBESKRIVNINGAR

1.8.2016

version 1.4

Innehållsförteckning

1 Allmänt 1

2 Serviceavtal 1 3 Namnet på och logotypen för betalningen 1 4 Säkerhet 2

5 Postbeskrivningar 2

5.1 Betalningens version 2

5.2 Betalningens kod 2

5.3 Säljarens signum 2

5.4 Säljarens konto 3

5.5 Säljarens namn 3

5.6 Betalningens språk 3

5.7 Betalningens belopp 3

5.8 Valutaslag 3

5.9 Betalningens referens 3

5.10 Betalningens förfallodag 3

5.11 Betalningens meddelande 3

5.12 Retur-länk 3

5.13 Annullera-länk 3

5.14 Förkasta-länk 4

5.15 Betalningens kontrollsumma 4

5.16 Betalningens bekräftelse 4

5. 17 Algoritm 5

5.18 Nyckelns version 6

6 Testning 6

7 Ibruktagning 6 8 Säästöpankin verkkomaksun kyselytoiminto 6

8.1 Beskrivning av tjänsten 7

8.2 Service agreement 7

8.3 Postbeskrivningar för förfrågningar om Sparbankens nätbetalning 7

8.3.1 Information som säljaren ger 7

8.3.2 Uppgifterna i s varsmeddelandet till förfrågan om Sparbankens nätbetalning 10

8.3.3 Förfrågan över bankgruppsgränserna 12

9 Sparbankens nätbetalnings återbetalningsfunktion 12

9.1 Serviceavtal om återbetalningsfunktionen 12

9.2 Postbeskrivningar för återbetalning av Sparbankens nätbetalning 12

9.2.1 Uppgifter som säljaren ger 12

10 Stöd för nättjänster 15

1 Allmänt

Denna anvisning definierar för säljarföretaget förutsättningarna för ibruktagningen av tjänsten samt postbeskrivningarna för uppbyggandet av systemet.

Handeln över internet växer hela tiden. Med Sparbankens nätbetalning kan kunderna köpa varor över Internet, bekvämt, snabbt och säkert.

Ibruktagningen kräver av säljarföretagets system förmåga att med webbteknik bilda en elektronisk faktura åt köparen samt de uppgifter som en Sparbankens nätbetalning kräver.

Säljaren får vid behov omedelbart en uppgift om kundens betalning då en kontrolluppgift om att betalningen har lyckats fogas till returmeddelandet. Säljaren kan också kontrollera betalningen på följande kontoutdrag eller från transaktionslistan på maskinspråk. Kontoutdragen och transaktionslistorna på maskinspråk bildas enligt kundens avtal.

Sparbankens nätbetalnings webbadress är xxxxx://xxxxxxxxxxx.xxxxxxxxxxxx.xx/xx/xxxxx.xxxx

Sparbankens nätbetalning kan användas dygnet runt.

2 Serviceavtal

Säljarföretaget ingår ett skriftligt avtal om ibruktagningen av tjänsten med banken.

3 Namnet på och logotypen för betalningen

För bankens nätbetalning kan antingen namnet Säästöpankin verkkomaksu eller Sparbankens nätbetalning användas. Andra namn får inte användas.

Säljarföretaget kopierar logotypen till sin egen server från adressen nedan.

xxxxx://x00xxx0xxxxxx0.xxxxxxxxxx.xxx/-/xxxxx/xxxxx/xxxxxxxxxx/xxxxxxxxxxxx0.xxx? la=fi-fi&hash=591F29CFA317389EF8BB253A9B14182F345243BA

Storleken och färgen av logotypen får inte ändras.

Logotypen/namnet får inte överlåtas till eller användas för annat ändamål än det som överenskommits i avtalet om Sparbankens nätbetalning.

Efter det att avtalet har hävts skall säljaren omedelbart ta bort logotypen för/namnet på Sparbankens nätbetalning från sina sidor.

4 Säkerhet

Den till betalningen anslutna datakommunikatio nen mellan kunden och banken krypteras med TLS 1.2 -krypteringsmetoden. Krypteringen av datakommunikationen skyddar meddelandena mellan banken och kunden mot läsning och ändring.

5 Postbeskrivningar

Sparbankens nätbetalning, FORM –blankettens fält. Begäranden till nätbetalningsprogrammet ska vara i POST-form.

	Uppgift	Uppgiftens namn INPUT NAME=	Exempel	Form AN=alfanumerisk A=alfabetisk N=numerisk	P=Obligatorisk V=Valbar
1.	Betalningens version	NET_VERSION	003	N 3	P
2.	Betalningens kod	NET_STAMP		AN 20	P
3.	Säljarens signum	NET_SELLER_ID		AN 13	P
4.	Säljarens konto	NET_SELLER_ACC	Ej i bruk
5.	Säljarens namn	NET_NAME	Ej i bruk
6.	Betalningens språk	NET_LANG	Ej i bruk
7.	Betalningens belopp	NET_AMOUNT	”12345,67”	AN 9	P
8.	Valutslag	NET_CUR	EUR	A 3	P
9.	Betalningens referens	NET_REF		N 20	P
10.	Betalningens förfallodag	NET_DATE	”EXPRESS”	AN 10	P
11.	Betalningens meddelande	NET_MSG		AN 210	V
12.	Retur-länk	NET_RETURN		AN 160	P
13.	Annullera-länk	NET_CANCEL		AN 160	P
14.	Förkastad-länk	NET_REJECT		AN 160	P
15.	Betalningens kontrollsiffra	NET_MAC		AN 64	P
16.	Betalningens bekräftelse	NET_CONFIRM	YES el. NO	A 3	P
17.	Algoritm	NET_ALG	03=SHA256	N 2	P
18.	Nyckelns version	NET_KEYVERS	Ej i bruk

5.1 Betalningens version

Använd version ”003”.

5.2 Betalningens kod

Säljaren ger betalningen en individualiserande kod. Koden kan användas som nyckelinformation för förfrågan och återbetalning av nätbetalningen.

5.3 Säljarens signum

På basis av signumet fastställs mottagarens kontonummer och mottagarens namn som kommer på betalningsblanketten Signumet har antecknats i det avtal som har ingåtts med banken. Signumet har sammanlagt 13 tecken och innehåller inga skiljetecken. Ex. servicesignumet är 9999999999 och kontrollsiffran 001. Då är säljarens signum 9999999999001.

5.4 Säljarens konto

Egenskapen används inte.

5.5 Säljarens namn

Egenskapen används inte.

5.6 Betalningens språk

Egenskapen används inte.

5.7 Betalningens belopp

Maximibeloppet för en nätbetalning bestäms enligt den övre gräns för betalning som användaren satt på kontot. Minimibeloppet är 0,01 euro. Beloppet skall ges utan tecken som skiljer tusentalen. Decimaltecknet är obligatoriskt och för det används kommatecknet. Beloppet visas alltid med två decimaler.

5.8 Valutaslag

EUR

5.9 Betalningens referens

Normal referens som antecknas på faktura.

5.10 Betalningens förfallodag

Endast Betala genast-betalningar är möjliga. Värdet är EXPRESS.

5.11 Betalningens meddelande

Om man så önskar kan man i meddelandefältet på kundens betalningsblankett skriva in uppgifter som individualiserar betalningen. Det finns 210 tecken till förfogande: sex rader med 35 tecken på varje rad.

5.12 Retur-länk

Handelsplatsens sida till vilken man går tillbaka efter en lyckad betalning.

Retur-länken som skickas från handelsplatsen kan exempelvis vara av formen xxxx://xxxxx.xxxxxx.xx/xxx-xxx/xxxxxx?xxxxxxxxxx varvid retur-länken då man flyttar från banken till handelsplatsen är av formen xxxx://xxxxx.xxxxxx.xx/xxx- bin/valmis&suoritettu&003& 01234567890123456789&123&20000101457898I11234&laskettu_mac om värdet i uppgiftsfältet NET_CONFIRM är YES. I produktionsanvändningen används den länk som sparats i bankens system från avtalet.

5.13 Annullera-länk

Den sida på handelsplatsen till vilken man flyttar sig i det fall att kunden avbryter betalningsfunktionen i Sparbankens nätbetalning.

5.14 Förkasta-länk

Den sida på handelsplatsen till vilken man går om betalningen förkastas i Sparbankens nätbetalning.

5.15 Betalningens kontrollsumma

Betalningens kontrollsumma räknas enligt SHA256-algoritm på så sätt att först bildas en teckensträng av följande fält i följande ordning:

NET_VERSION& NET_STAMP& NET_SELLER_ID& NET_AMOUNT& NET_REF& NET_DATE& NET_CUR& NET_RETURN& NET_CANCEL& NET_REJECT& NET_ALG&

Turvatarkiste&

Teckensträngen får inte innehålla tomma tecken och &-tecknen ingår i beräkningen. Exempelvis av teckensträngen003&1365485826567&0000010014001&1,20&12344&EXPRESS&EUR

&xxxx://xxxx/xxxxxx?XXXXXXxXXXXX_XXXXXXX& xxxx://xxxx/xxxxxx?XXXXXXxXXXXXXXX_XXXXX& xxxx://xxxx/xxxxxx?XXXXXXxXXXXX&00&00000000000000000000000000000000000

11111111111111111111111111111& fås resultatet 6D6E351D42D2E8C8FFFF6C05B426FAC8FBE31D0177A386D9FA5ECD88EFAAC

7C1

5.16 Betalningens bekräftelse

Om fältet NET_CONFIRM har värdet ”YES”, får säljaren i retur-länken en uppgift om behandlingen av betalningen. Då retur-länken bildas används en MAC–kontroll med vilken säljaren kan försäkra sig om att Sparbankens nätbetalning har lyckats. En fullständig säkerhet på en lyckad betalning får säljaren emellertid först via sitt kontoutdrags- eller referensgiromaterial. Säljaren kan också göra en separat kontotransaktionsförfrågan.

Då värdet är ”YES”, fogas följande uppgifter till retur-länken:

NET_RETURN_VERSION	”003”
NET_RETURN_STAMP	Betalningens ursprungliga

	individualiserande kod
NET_RETURN_REF	Betalningens ursprungliga referensnummer
NET_RETURN_PAID&	Transaktionens individualiserande identifierare i bankens system. Uppgift i AN-form vars maximilängd är 20 tecken
NET_ALG	”03”, SHA256-algoritm
NET_RETURN_MAC	Kontroll av returuppgifterna

NET_RETURN_VERSION	”003”
NET_RETURN_STAMP	Betalningens individualiserande kod
NET_RETURN_REF	Betalningens ursprungliga referensnummer
NET_RETURN_PAID	Transaktionens individualiserande identifierare i bankens system
NET_ALG	”03”, algoritmen
NET_RETURN_MAC	Kontroll av returuppgifterna

Returuppgifternas kontrollsumma räknas enligt SHA256-algoritm på så sätt att först bildas en teckensträng av följande fält i följande ordning:

NET_RETURN_VERSION& NET_RETURN_STAMP& NET_RETURN_REF& NET_RETURN_PAID& NET_ALG&

Säkerhetskod&

Med SHA256 – algoritm beräknas av den teckensträng som bildas ett hash–värde, som ändras till en hexadecimalisk framställningsform på 64 tecken.

Teckensträngen får inte innehålla tomma tecken och &-tecknen ingår i beräkningen. Exempelvis av teckensträngen 003&01234567890123456789&123&20000101457898I11234&03&111111111111111

11111& fås resultatet 4D580E3C797C9ACFDC465F7A66BDC7F7060AC5A75F2ABC480FE06DDB23B96

6D9.

5. 17 Algoritm

Använd version ”03”, dvs. SHA-256-algoritmen.

5.18 Nyckelns version

Nyckelns version NET_KEYVERS är inte i bruk. Om det i tjänsteleverantörens program måste finnas en versionsuppgift för MAC-nyckel används ”0001”.

6 Testning

Säljaren kan testa Sparbankens nätbetalning i produktionsmiljön på så sätt att han använder testkoder innan den egentliga ibruktagningen sker. Vid testningen skall informationsfälten NET_RETURN, NET_CANCEL och NET_REJECT finnas med. Vid testningen används samma nätadress som i produktionen, dvs. xxxxx://xxxxxxxxxxx.xxxxxxxxxxxx.xx/xx/xxxxx.xxxx

Notera att det att man klickar på länken i dokumentet inte utför testningsfunktionen.

Om kunden annullerar utförandet av betalningen förmedlas länkuppgiften enligt informationsfältet NET_CANCEL och om betalningen förkastas enligt informationsfältet NET_REJECT.

Säljarens koder är: 0000000000

Endast en testköpare kan betala till testsäljaren och ingen betalning erläggs. Åt testanvändaren visas de felaktiga fälten som sådana, för felsituationer som sker i produktionen finns egna sidor.

7 Ibruktagning

Tjänsten kan användas från den dag som har antecknats på avtalet som ibruktagningsdag.

8 Säästöpankin verkkomaksun kyselytoiminto

Förfrågningen om Sparbankens nätbetalning är ett system för de företagskunder som använder Sparbankens betalningsknapp på sina egna näthandelssidor. Med hjälp av tjänsten kan företagen göra förfrågningar om de transaktioner som har gjorts med Sparbankens betalningsknapp. Huvudsyftet är att göra det möjligt för nätbutikerna att göra förfrågningar om de transaktioner som i samband med betalningen av någon orsak misslyckats dvs. besked om att betalningen lyckats eller misslyckats når inte företagets näthandelssystem. Med hjälp av tjänsten kan näthandelsföretagen omedelbart försäkra sig om osäkra betalningsuppgifter. På så sätt kan nätbutiken i och med den lyckade betalningen också genast erbjuda kunden den tjänst eller produkt som kunden har betalat i nätbutiken och som det också var meningen att leverera till kunden genast efter den lyckade betalningen.

8.1 Beskrivning av tjänsten

Kunden förflyttas tillbaka till nätbutikens sida från sidan där en lyckad betalning kvitteras eller så flyttar Sparbankens nätbetalningssystem kunden automatiskt till nätbutikens sida. Tillsammans med flyttningen går information till nätbutiken om att betalningen lyckats och nätbutiken kan omedelbart ge kunden produkten/tjänsten. Om ingen flyttning sker (kunden gör inte som han eller hon ska, det sker ett fel i systemet eller i datakommunikationen) förmedlas inte informationen om att betalningen lyckats till nätbutiken.

I nätbutiken har företaget självt byggt en transaktionsförfrågan som startar automatiskt eller förfrågan görs manuellt när information om transaktionen inte når nätbutiken.

Förfrågan görs så att nätbutiken s koder fungerar som identifierare i Samlinks riktning (precis som när man förflyttas från nätbutiken till Sparbankens betalning). Nätbutiken ger de identifierande uppgifter som behövs om betalningen utgående från vilka betalningen tillförlitligt kan hittas och återsändas till nätbutiken.

8.2 Service agreement

Säljarföretaget ingår ett skriftligt avtal om ibruktagningen av tjänsten med banken. När säljarföretagets konto finns på en av Sparbanksgruppens banker, kan förfrågningar göras på vilken som helst av Sparbanksgruppens Sparbanker.

När den part som ingått avtalet är betalningsförmedlare krävs inte ett kontonummer på Sparbanksgruppens bank i avtalet. Kontot kan finnas på vilken bank som helst i Finland. Betalningsförmedlaren kan göra förfrågningar över bankgruppsgränserna. I förfrågningar visas betalarens kontonummer på nytt för betalningsförmedlaren med betalningens version ”004”.

8.3 Postbeskrivningar för förfrågningar om Sparbankens nätbetalning

Säljarföretaget bygger ett eget förfrågningssystem. Nätadressen till Sparbankens nätbetalningsförfrågningsfunktion är

xxxxx://xxxxxxxxxxx.xxxxxxxxxxxx.xx/xx/xxxxxx.xxxx .

Sparbankens nätbetalning är tillgänglig 24 h/dygn.

8.3.1 Information som säljaren ger

	Uppgift	Uppgiftens namn INPUT NAME=	Exempel	Form	P/V
1.	Betalningens version	NET_VERSION	”003”eller ”004”	N 3	P
2.	Säljarens signum	NET_SELLER_ID	9999999999001	AN 13	P
3.	Betalningens kod	NET_STAMP	Den ursprungliga betalningens kod som köpmannen gett	AN 20	V	P
4.	Identifierande referens för den betalning som förfrågas	NET_REF	Den ursprungliga betalningens referens	N 20	V	P

			som köpmannen angett
5.	Returadress	NET_RETURN	Adressen till returlänken	AN160	P
6	Algoritm	NET_ALG	03 = SHA256	N2	P
7.	Förfrågningens kontrollsumma	NET_MAC	Kontrollsumma som beräknats av den som gjort förfrågan	AN 64	P
8.	Nyckelns version	NET_KEYVERS	Ej i bruk

Förfrågningens kontrollsumma

NET_MAC

Kontrollsumma som beräknats av den

som gjort förfrågan

AN 64

Nyckelns version

NET_KEYVERS

Ej i bruk

8.3.1.1 Betalningens version

Versionen i betalningens förfrågan är ”003”.

När säljarföretaget är betalningsförmedlare kan företaget använda version ”004” i sin förfrågningsfunktion. Då kan företaget göra förfrågningar över bankgruppsgränserna och förfrågan visar på nytt även betalarens kontonummer.

8.3.1.2 Säljarens signum

Signumet har antecknats i punkten ”Nätbetalning/Servicesignum” i det nätbetalningsavtal som har ingåtts med banken. Signumet har 13 tecken. Signumet bildas av en teckensträng utan skiljetecken. Exempelvis servicesignumet är 9999999999 och kontrollsiffran 001. Då är säljarens signum 9999999999001.

8.3.1.3 Betalningens kod

Den ursprungliga betalningens kod som köpmannen angett. Antingen betalningens kod eller referens ska anges. Om båda anges ska båda stämma.

8.3.1.4 Identifierande referens för den betalning som förfrågas

Den ursprungliga betalningens referens som köpmannen angett. Antingen betalningens kod eller referens ska anges. Om båda anges ska båda stämma.

8.3.1.5 Returadress

Sida till vilken man går tillbaka efter förfrågan.

Uppgifterna i svarsmeddelandet läggs till efter returadressen. Returadressen kan anges ti l exempel i följande form: ”xxxxx://xxxxx.xxxxxx.xx/xxx-xxx/xxxxxx”. Då blir adressen ti l exempel ”xxxxx://xxxxx.xxxxxx.xx/xxx- bin/valmis?NET_VERSION=003&NET_SELLER_ID=0003516379000&NET_RESPC ODE=OK&NET_STAMP=1525694059384&NET_REF=11235&NET_DATE=201805 07&NET_AMOUNT=2,50&NET_CUR=EUR&NET_PAID=20180507457610I84358

&NET_ALG=03&NET_RETURN_MAC=ADA0DEC4E59553D122FA560614840E35 B225A22D52BA479B22BBFA7A486147AA”.

8.3.1.6 Algoritm

Använd version ”03”, dvs. SHA-256-algoritmen används vid kontrollberäkning.

Betalningens kontrollsumma räknas med SHA256–algoritmen så att först bildas en teckensträng av följande datafält i den här ordningen:

NET_VERSION& NET_SELLER_ID& NET_STAMP& NET_REF& NET_ALG&

Säkerhetskod&

Säkerhetskoden består av två delar. Den första delen skickas till den mottagare av den första delen av nyckeln som kunden har utsett i avtalet till den adress som anges i kundens avtal. Den andra delen skickas per e-post till e-postadressen för mottagaren av den andra delen av nyckeln. De frivilliga fälten tas endast med om de är närvarande. Teckensträngen får inte innehålla tomma tecken och &-tecknen ingår i beräkningen. Av den teckensträng som bildats räknas med SHA256-algoritm ett hash-värde som ändras till en hexadecimalisk framställningsform på 64 tecken där stora bokstäver används.

Teckensträngen får inte innehålla tomma tecken och &-tecknen ingår i beräkningen. Exempelvis av teckensträngen 003&0000010014001&12312313&12344&03&11111111111111111111111111111111

11111111111111111111111111111111& fås resultatet

6FD6CE331A49759150AA06A69D8158E5E9006E9D6F7740529829A07E7FA76383.

8.3.1.8 Nyckelns version

Inte i bruk.

8.3.2 Uppgifterna i svarsmeddelandet till förfrågan om Sparbankens nätbetalning

	Uppgift	Uppgiftens namn= INPUT NAME	Exempel	Form	P/V
1.	Förfrågningens version	NET_VERSION	”003”eller ”004”	N 3	P
2.	Säljarens signum	NET_SELLER_ID		AN 13	P
3.	Returuppgift	NET_RESPCODE	”OK”: Betalningen hittades och den är godkänd ”NOTFOUND”: Betalningen hittades inte ”ERROR” : Oklart i betalningen eller fel i förfrågningsuppgifterna eller annat fel	A 8	P
4.	Betalningens kod	NET_STAMP		AN 20	V	P
5.	Betalningens referens	NET_REF		N 20	V	P
6.	Betalningsdag	NET_DATE	i formen ”vvvvkkpp”	N 10	V
7.	Betalningens belopp	NET_AMOUNT	”12345,67”	AN 9	V
8.	Valutaslag	NET_CUR	EUR	A 3	V
9.	Betalningens arkiveringskod	NET_PAID	Bankens arkiveringskod	AN 20	V
10	Algoritm	NET_ALG	03 = SHA256	N 2	P
11.	Betalarens kontonummer	NET_BUYER_ACC	FI9988887777666655 IBAN-kontonummer Lämnas endast till betalningsförmedlaren med version ”004”.	AN 18	V
12.	Förfrågningens kontrollsiffra	NET_RETURN_MAC	Beräknad kontrollsumma för förfrågningssvaret	AN 64	P
13.	Nyckelns version	NET_KEYVERS	Inte i bruk		V

1. Förfrågningens version

I version ”003” är förfrågningar över bankgruppsgränserna inte möjliga. I version ”004” är förfrågningar över bankgruppsgränserna möjliga för betalningsförmedlaren.

2. Säljarens signum

Signumet har 13 tecken och anges i avtalet.

3. Returuppgift

Uppgift om huruvida betalningen har godkänts eller betalningen inte hittas eller det finns ett fel i uppgifterna i förfrågan. Om flera betalningar hittas med samma nyckeluppgifter återbetalas detta som fel.

4. Betalningens kod

Betalningens kod, om en sådan har angetts för betalningen.

5. Betalningens referens

Betalningens referens, om en sådan har angetts för betalningen.

6. Betalningsdag

Dag som transaktionen utfördes. Återbetalas endast med svaret ”OK”.

7. Betalningens belopp

Betalningens belopp med två decimaler. Återbetalas endast med svaret ”OK”.

8. Valutaslag

”EUR”. Återbetalas endast med svaret ”OK”.

9. Betalningens arkiveringskod

Bankens arkiveringskod för betalningen. Återbetalas endast med svaret ”OK”.

10. Algoritm

Använd version ”03”, dvs. SHA-256-algoritmen används vid kontrollberäkning.

11. Betalarens kontonummer

Kontonumret visas på nytt endast om version ”004” används och om den som använder förfrågningsfunktionen är betalningsförmedlare. ”NET_BUYER_ACC” är ett IBAN- kontonummer på 18 tecken.

Återbetalas endast med svaret ”OK”.

12. Förfrågningens kontrollsumma

Förfrågningssvarets kontrollsumma räknas enligt SHA256-algoritm på så sätt att först bildas en teckensträng av följande fält i följande ordning:

NET_VERSION& NET_SELLER_ID& NET_RESPCODE& NET_STAMP& NET_REF& NET_DATE& NET_AMOUNT& NET_CUR& NET_PAID& NET_ALG& NET_BUYER_ACC&

Säkerhetskod&

Uppgifterna NET_DATE, NET_AMOUNT, NET_CUR, NET_PAID och NET_BUYER_ACC är med i beräkningen av kontrollsumman enbart med svaret “OK”. ”NET_BUYER_ACC är med i beräkningen av kontrollsumman enbart i version ”004” för betalningsförmedlaren.

Av den teckensträng som bildats räknas med SHA256-algoritm ett hash-värde som ändras till en hexadecimalisk framställningsform på 64 tecken där stora bokstäver används.

De frivilliga fälten tas endast med om de är närvarande.

Exempelvis av teckensträngen 003&0000010014001&NOTFOUND&122323&12344&03&11111111111111111111111

1111

1111111111111111111111111111111111111&

fås resultatet

FD912E6BCE90B18FA014B2AF8B93990AFB249E217FEF1D4E1F921A3F23AEBDD C.

8.3.3 Förfrågan över bankgruppsgränserna

När säljarföretaget är betalningsförmedlare kan betalningsförmedlaren göra förfrågningar över bankgruppsgränserna, även om betalningsförmedlarens konto i avtalet finns i en annan bankgrupp. Detta förutsätter att betalningsförmedlaren bygger upp en förfrågningsfunktion genom att använda version ”004” för uppgiften NET_VERSION. Då visas betalarens kontonummer (NET_BUYER_ACC) på nytt för betalningsförmedlaren. Uppgiften NET_BUYER_ACC läggs till i den teckensträng som används vid MAC-beräkningen. Förfrågningar över bankgruppsgränserna är endast möjliga för betalningsförmedlare.

9 Sparbankens nätbetalnings återbetalningsfunktion

Återbetalning av en Sparbankens nätbetalning är ett system för de företagskunder som använder Sparbankens betalningsknapp på sina egna nätbutiksidor. Med hjälp av tjänsten kan företagen återbetala transaktioner som gjorts med Sparbankens betalningsknapp. Huvudavsikten med systemet är att ge nätbutikerna en möjlighet att återbetala sådana transaktioner som de av någon orsak blir tvungna att återbetala till kunderna. Det belopp som återbetalas behöver inte vara lika stort som den ursprungliga betalningen men det kan inte vara större än den. I en transaktion kan inte ingå flera återbetalningar.

-En återbetalning av en nätbetalning kan göras ännu 60 dagar efter betalningen

-Summa kan vara bara en del av betalningens summa.

-Återbetalning kan göras bara en gång fastän det återbetalda beloppet är mindre än betalningens summa.

9.1 Serviceavtal om återbetalningsfunktionen

Säljarföretaget ingår ett skriftligt avtal men Banken om att ta tjänsten i bruk.

Handelsplatsens kontonummer och avtal ska finna s i en och samma bankgrupp för att säljarföretaget ska kunna börja använda återbetalningsfunktionen.

9.2 Postbeskrivningar för återbetalning av Sparbankens nätbetalning

Säljarföretaget konstruerar ett eget återbetalningssystem. Sparbankens nätbetalnings återbetalningsfunktion finns på adressen xxxxx://xxxxxxxxxxx.xxxxxxxxxxxx.xx/xx/xxxxxxxx.xxxx

Sparbankens nätbetalning är tillgänglig 24 h/dygn.

9.2.1 Uppgifter som säljaren ger

Uppgift

Uppgiftens namn INPUT NAME=

Exempel

Form

P/V

Återbetalningens version

NET_VERSION

”003”

Säljarens signum

NET_SELLER_ID

AN13

Återbetalningens kod

NET_STAMP

AN20

Återbetalningens referens

NET_REF

N20

Återbetalningens belopp

NET_AMOUNT

”12345,67”

AN9

Valutaslag

NET_CUR

”EUR”

Återbetalningens meddelande

NET_MSG

AN210

Den ursprungliga betalningens kod

NET_STAMP_ORG

AN20

Den ursprunliga betalningens kod

NET_REF_ORG

N20

10.

Returlänkens adress

NET_RETURN

AN160

Algoritm

NET_ALG

03 = SHA256

N 2

12.

Betalningens kontrollsumma

NET_MAC

AN64

13.

Nyckelversion

NET_KEYVERS

Inte i bruk

SHA256 -algoritm

Kontrollsumman räknas med SHA256-algoritmen så att först bildas en teckensträng av följande fält i följande ordning:

NET_VERSION& NET_SELLER_ID& NET_STAMP& NET_REF& NET_AMOUNT& NET_CUR& NET_STAMP_ORG& NET_REF_ORG& NET_RETURN& NET_ALG&

Säkerhetskod&

Säkerhetskoden är 64 tecken lång. Säkerhetskoden består av två delar. Den första delen skickas till den av kunden utsedda mottagaren av den första delen av nyckeln till den adress som anges i kundens avtal.

Den andra delen skickas per e-post till e-postadressen för mottagaren av den andra delen av nyckeln.

Teckensträngen får inte innehålla tomma tecken och &-tecknen ingår i beräkningen. Av den teckensträng som bildats räknas med SHA256-algoritm ett hash-värde som ändras till en hexadecimalisk framställningsform på 64 tecken där stora bokstäver används.

Exempelvis av teckensträngen” 003&0000010014001&12312312&12344&1,20&EUR&12312312&12344&xxxx://xxxx/

kauppa/palautus?ACTION=paluu&03&11111111111111111111111111111111111111 11111111111111111111111111&” fås resultatet "6466FB6144718D253A8998C5BBCDA28A1B3360FF9A04AEE34DCEDAE7D980D 451".

9.3.2 Uppgifterna i svarsmeddelandet till återbetalning av Sparbankens nätbetalning

Uppgift	Uppgiftens namn INPUT NAME=	Exempel	Form	P/V
Återbetalningens versionsnummer.	NET_VERSION	”003”	N3	P
Säljarens signum.	NET_SELLER_ID		AN13	P
Återbetalningens identifierande kod.	NET_STAMP		AN20	P
Återbetalningens identifierande referens.	NET_REF		N20	P
Svarskod	NET_RESPCODE	”OK”: återbetalningen lyckades ”NOTFOUND”: den ursprunliga betalningen hittades inte ”ERROR”: återbetalningen lyckades inte	A8	P
Återbetalningens arkiveringskod	NET_PAID		AN20	P
Felförklaring	NET_ERRO_MSG	Tilläggsförklaring om svarskoden är ”ERROR”.	A512	V
Algoritm	NET_ALG	03 = SHA256	N 2	P
Betalningens kontrollsumma	NET_MAC		AN64	P
Nyckelversion	NET_KEYVERS	Inte i bruk

SHA256-algoritmen används vid beräkningen av MAC-kontrollsumman för svarsmeddelandet till återbetalning.

Nedan finns de datafält som ska användas vid beräkningen av MAC-kontrollsumman för svarsmeddelandet till återbetalning.

NET_VERSION& NET_SELLER_ID& NET_STAMP& NET_REF& NET_PAID&

NET_ALG&

Säkerhetskod&

10 Stöd för nättjänster

För Sparbankernas kunder, telefon 0000-0000 (1,17 €/min + lna). E-post: xxxx@xxxxxxx.xx

Document Metadata

Table of Contents

SPARBANKENS NÄTBETALNING BRUKSANVISNING OCH POSTBESKRIVNINGAR 1.8.2016 version 1.4

Document Metadata