Suomen Verkkomaksut Oy

Versio 1.0.4
21.12.2010
Suomen Verkkomaksut Oy
Maksujärjestelmän rajapintakuvaus
Kanavamalli
Suomen Verkkomaksut Oy
Ohjelmakaari 10
40500 JYVÄSKYLÄ
Versio 1.0.4
21.12.2010
Suomen Verkkomaksut Oy
Ohjelmakaari 10
40500 JYVÄSKYLÄ
Sisällysluettelo
Versiohistoria...............................................................................................................................3
Kanavapalvelun kuvaus.............................................................................................................. 4
Rajapinnan kuvaus......................................................................................................................5
Yleistä................................................................................................................................................................ 5
Lähetettävät kentät............................................................................................................................................ 5
Kenttien selitteet................................................................................................................................................ 7
Maksutiedon käsittely................................................................................................................10
Tarkisteen laskeminen..................................................................................................................................... 11
Esimerkki tarkisteen laskemisesta................................................................................................................... 11
Testaus...................................................................................................................................... 12
Testitunnukset.................................................................................................................................................. 12
Esimerkki......................................................................................................................................................... 12
Avun saaminen asennuksiin..................................................................................................... 16
Versio 1.0.4
21.12.2010
Suomen Verkkomaksut Oy
Ohjelmakaari 10
40500 JYVÄSKYLÄ
Versiohistoria
Päivämäärä
Versio
Muutokset
10.09.2009
1.0
- Kanavamallin ensimmäinen rajapintakuvaus
04.11.2009
1.0.1
- Korjattu esimerkki, |-merkin enkoodaus URL:ss' on %7C eikä %C7
28.04.2010
1.0.2
- Päivitetty uusi palvelun osoite (action)
21.09.2010
1.0.3
- Korjattu AUTHCODE esimerkissä
- Korjattu maininta virheellisestä demokanavatunnuksesta 12345. Oikea tunnus on
123.
21.12.2010
1.0.4
- Lisätty taulukkoon puuttuva CHANNEL_ID arvo. Esimerkissä arvo oli huomioitu
oikein.
- Lisätty esimerkkiin AUTHCODE laskettuna molemmissa tuetuissa merkistöissä.
Aiemmin tiiviste oli laskettu virheellisesti ISO-8859-1 -merkistössä, vaikka
esimerkissä kerrottiin käytettävän UTF-8 -merkistöä.
Versio 1.0.4
21.12.2010
Suomen Verkkomaksut Oy
Ohjelmakaari 10
40500 JYVÄSKYLÄ
Kanavapalvelun kuvaus
Suomen Verkkomaksujen myyntikanavamalli antaa myyntikanavalle mahdollisuuden tuoda haluttu
maksukokonaisuus maksettavaksi Suomen Verkkomaksujen palvelussa. Yksittäinen maksukokonaisuus voi
sisältää useiden eri yritysten myymiä tuotteita. Näiden yritysten on kuitenkin aina oltava Suomen
Verkkomaksujen asiakkaita sekä hyväksynyt kyseisen myyntikanavan käytön. Jokaiselle palveluun tuotavalle
tuoteriville määritellään yksikäsitteisesti yritys, joka kyseisen tuotteen myy.
Myyntikanavamalli antaa myyntikanavalle mahdollisuuden määritellä tuoteriveittäin myyntikanavan veloittama
provisio. Myyntikanava voi laskea provision vapaasti määrittämällään kaavalla. Myyntikanavan veloittaman
provision laskentamalli määritellään Suomen Verkkomaksujen ja myyntikanavan välisessä sopimuksessa ja
provision laskennassa tulee käyttää sovittua laskentatapaa.
Myös Suomen Verkkomaksut veloittaa myyntikanavan ja Suomen Verkkomaksujen välisen sopimuksen
mukaisen provision kaikista myyntikanavan kautta tuoduista maksuista. Myyntikanavan tulee huolehtia siitä, ettei
palveluun välitetä sellaista tuotekokonaisuutta, että provisiot ylittävät tuotteiden summan.
Myyntikanavaa käyttävät yritykset näkevät myyntikanavan kautta tulleet maksutapahtumat kauppiaspaneelissa.
Yritykset näkevät myyntikanavan kautta tulleista maksuista ainoastaan yritystä itseään koskevat tuoterivit, jos
maksukokonaisuus sisältää useampien yritysten tuotteita.
Versio 1.0.4
21.12.2010
Suomen Verkkomaksut Oy
Ohjelmakaari 10
40500 JYVÄSKYLÄ
Rajapinnan kuvaus
Yleistä
Kanavamallin maksupalvelu toimii SSL-salatussa osoitteessa https://payment.verkkomaksut.fi/channel-payment.
Maksukokonaisuuden tiedot lähetetään palveluun POST-kyselynä. Kun maksu on suoritettu, käyttäjä ohjataan
takaisin verkkopalveluun verkkopalvelun määrittämään paluuosoitteeseen. Paluuosoitteeseen välitetään lisäksi
parametrit, joiden perusteella maksu voidaan turvallisesti kuitata maksetuksi.
Lähetettävät kentät
Seuraavissa taulukoissa on kuvattu maksupalveluun lähetettävät tiedot. Taulukossa annetut pituudet ovat
kenttien maksimiarvoja. Mikäli annettu pituus ylitetään, ei maksua hyväksytä.
Kenttien muodoksi on merkitty taulukossa aina joko N, F tai AN. N tarkoittaa numeerista ja arvo on siten luku. F
tarkoittaa desimaalilukua. Desimaaliluvuissa tuetaan korkeintaan kahden numeron tarkkuutta. Desimaalilukujen
desimaalierottimena käytetään pistettä. AN tarkoittaa alfanumeerista, eli näiden kenttien tietosisältö voi olla mitä
tahansa merkkejä. Kentät voidaan lähettää palveluun joko merkistössä UTF-8 tai ISO-8859-1. Merkistöjä ei voi
käyttää sekaisin.
Huomaa! Minkään kentän arvo ei saa sisältää |-merkkejä (pipe, vertical bar). Arvot tulee poistaa tai korvata
toisella merkillä ennen välittämistä Suomen Verkkomaksujen palveluun. Jos |-merkkejä halutaan tuoda
paluuosoitteissa, suosittelemme tuomaan osoitteen URL-enkoodattuna (Esim. PHP-kielessä funktio urlencode).
Erityisesti |-merkki tulee tällöin korvata merkeillä %7C.
Kenttien pakollisuus on kerrottu kentässä Pakollinen/Valinnainen. Valinnaisista kentistä erityisesti
NOTIFY_ADDRESS-kentän tarjoamaa toiminnallisuutta kuitenkin suositellaan käytettäväksi aina.
Kenttä
Tiedon nimi
Pituus
max.
Muoto
Pakollinen /
Valinnainen
Kanavatunnus
CHANNEL_ID
11
N
P
Tilausnumero
ORDER_NUMBER
64
AN
P
Valuutta
CURRENCY
3
AN
P
Palautusosoite / Onnistunut
maksu
RETURN_ADDRESS
255
AN
P
Palautusosoite / Peruutunut
maksu
CANCEL_ADDRESS
255
AN
P
Huomautusosoite
NOTIFY_ADDRESS
255
AN
P
Rajapinnan versio
VERSION
2
N
P
Kulttuurikoodi
CULTURE
5
AN
V
Maksutavan esivalinta
METHOD_PRESELECT
2
AN
V
Versio 1.0.4
21.12.2010
Kenttä
Tiedon nimi
Suomen Verkkomaksut Oy
Ohjelmakaari 10
40500 JYVÄSKYLÄ
Pituus
max.
Muoto
Pakollinen /
Valinnainen
Tunnistekoodi
AUTHCODE
32
AN
P
Maksajan puhelinnumero
CONTACT_TELNO
64
AN
V
Maksajan
matkapuhelinnumero
Maksajan sähköpostiosoite
CONTACT_CELLNO
64
AN
V
CONTACT_EMAIL
255
AN
P
Maksajan etunimi
CONTACT_FIRSTNAME
64
AN
P
Maksajan sukunimi
CONTACT_LASTNAME
64
AN
P
Maksajan yritys
CONTACT_COMPANY
128
AN
O
Maksajan postiosoite
CONTACT_ADDR_STREET
128
AN
P
Maksajan postinumero
CONTACT_ADDR_ZIP
16
N
P
Maksajan postitoimipaikka
CONTACT_ADDR_CITY
64
AN
P
Maksajan kotimaa
CONTACT_ADDR_COUNTRY
2
AN
P
Arvonlisäveron sisältyminen
INCLUDE_VAT
1
N
P
Tuoterivien määrä
ITEMS
8
N
P
Lisäksi tilaukseen liitetyt tuotteet voidaan tuoda Suomen Verkkomaksujen palveluun seuraavilla toistuvilla
kentillä.
Kenttä
Tiedon nimi
Pituus
max.
Muoto
Pakollinen /
Valinnainen
Tuotteen nimi
ITEM_TITLE[X]
255
AN
P
Tuotenumero
ITEM_NO[X]
16
AN
V
Tuotteiden määrä
ITEM_AMOUNT[X]
10
F
P
Tuotteen hinta
ITEM_PRICE[X]
10
F
P
Tuotteen veroprosentti
ITEM_TAX[X]
10
F
P
Tuotteen kauppias-id
ITEM_MERCHANT_ID[X]
8
N
P
Tuotteen kanavaprovisioluokan ID
ITEM_CP[X]
10
F
V
Tuotteen alennus-prosentti
ITEM_DISCOUNT[X]
10
F
V
Tuotetyyppi
ITEM_TYPE[X]
2
N
V
Versio 1.0.4
21.12.2010
Suomen Verkkomaksut Oy
Ohjelmakaari 10
40500 JYVÄSKYLÄ
Kenttien selitteet
Kenttä
Selite
Kanavatunnus
Kanavatunnus on Suomen Verkkomaksut Oy:n myyntipaikalle antama tunniste.
Kanavatunnus muodostuu pelkistä numeroista. (pakollinen)
Tilausnumero
Tilausnumero on tilauksen yksilöivä merkkijono. (pakollinen)
Valuutta
Maksun valuutta. Vain EUR sallittu. (pakollinen)
Palautusosoite /
Onnistunut maksu
Osoite johon ohjataan sen jälkeen kun maksu on suoritettu onnistuneesti
Suomen maksupalvelu Oy:lle. (pakollinen)
Palautusosoite /
Peruutunut maksu
Osoite, johon ohjataan jos maksu on peruuntunut tai epäonnistunut. (pakollinen)
Huomautusosoite
Osoite, jota kutsutaan, kun maksu merkitään onnistuneeksi. Tätä osoitetta
kutsutaan ohjelmallisesti samoilla GET-parametreillä kuin
RETURN_ADDRESS:ia kun maksu on suoritettu. (pakollinen)
Maksurajapinnasta käytettävän version numero. Kanavarajapinnan versio on 1.
(pakollinen)
Versio
Kulttuuri
Maksutavan esivalinta
Kulttuuri vaikuttaa maksutapavalintasivun oletuskieleen ja summien
esitystapaan. Käytettävissä on kulttuurit “fi_FI” , "sv_SE" ja "en_US”.
Oletuskulttuuri on “fi_FI”. (vapaaehtoinen)
Tämä kenttä ei ole toistaiseksi käytössä. Kenttä on kuitenkin huomioitava
tyhjänä merkkijonona AUTHCODE-arvon laskennassa.
Tunnistekoodi
Tunnistekoodi on MD5-algoritmillä merkkijonosta laskettu tiivistearvo, jonka
avulla estetään väärinkäytöksiä. Laskennassa käytetään kaikkia tilauksen tietoja
sekä kanavalle annettua erillistä ns. kanavavarmennetta. Katso laskentatapa
esimerkistä. (pakollinen)
Maksajan puhelinnumero Maksajan puhelinnumero (vapaaehtoinen)
Maksajan
matkapuhelinnumero
Maksajan matkapuhelinnumero (vapaaehtoinen)
Maksajan etunimi
Maksajan etunimi (pakollinen)
Maksajan sukunimi
Maksajan sukunimi (pakollinen)
Maksajan yritys
Maksajan yritys (vapaaehtoinen)
Versio 1.0.4
21.12.2010
Kenttä
Suomen Verkkomaksut Oy
Ohjelmakaari 10
40500 JYVÄSKYLÄ
Selite
Maksajan postiosoite
Maksajan postiosoite eli lähiosoite (pakollinen).
Maksajan postinumero
Maksajan postinumero (pakollinen)
Maksajan postitoimipaikka Maksajan postitoimipaikka (pakollinen)
Maksajan kotimaa
Arvonlisäveron
sisältyminen
Tuotteiden määrä
Maksajan kotimaa. Tieto toimitetaan ISO-3166-1 -standardin mukaisesti
kaksinumeroisena merkkijonona. Esimerkiksi Suomi on FI ja Ruotsi on SE.
Merkkien kirjainkoolla ei ole merkitystä. (pakollinen)
Arvonlisäveron sisältyminen -kenttä kertoo sisältyykö tuoteriveissä ilmaistu hinta
arvonlisäveron. Arvo 1 tarkoittaa arvonlisäveron sisältyvän tuotuun hintaan ja 0,
että arvonlisävero lisätään annettuihin hintoihin. Käytä siis arvoa 1, jos
tuotteiden hinnat on tallennettu verkokaupassa arvonlisäverollisina ja arvoa 0
jos hinnat on tallennettu arvonlisäverottomina. (pakollinen)
Tuoterivien määrä. Vastaavat tuoterivit on oltava mukana seuraavan taulukon
mukaisesti. (pakollinen)
Seuraavassa on listattu tuotetietojen selitykset.
Kenttä
Selite
Tuotteen nimi
Vapaamuotoinen nimi tuotteelle. (pakollinen)
Tuotenumero
Vapaaehtoinen tuotenumero, joka näytetään kauppiaspaneelissa tuotteen
kohdalla. Tämän käyttö saattaa helpottaa oikeaan tuotteeseen kohdistamista.
(vapaaehtoinen)
Tuotteiden määrä
Jos tilaus sisältää useita samoja tuotteita, voidaan tässä kertoa tuotteiden
määrä, jolloin jokaista tuotetta ei tarvitse tuoda omana rivinään. Yleensä tässä
tuodaan siis arvo 1. (pakollinen)
Tuotteen hinta
Yhden tuotteen hinta. Jos kentässä INCLUDE_VAT=0, on tämä hinta
arvonlisäveroton hinta. Jos INLUCDE_VAT=1, on tämä hinta arvonlisäverollinen.
Hinnan tulee olla aina positiivinen luku. Alennukset voidaan tuoda
tuotekohtaisella alennusprosentti-kentällä. (pakollinen)
Tuotteen veroprosentti
Tuotteelle käytetty veroprosentti. Suomessa arvonlisävero useimmille tuotteille
22%. (pakollinen)
Tuotteen kauppias
Yksi Suomen Verkkomaksujen palveluun tuotava maksu voi sisältää useiden eri
yritysten tuotteita. Jokaisella tuoterivillä tuodaan tuotteen myyjän
kauppiastunnus. (pakollinen)
Tuotteen
kanavarovisioluokan ID
Myyntikanavalle voidaan määrittää tarvittaessa useita provisioluokkia. Jokaiselle
tuotteelle voidaan määrittää käytettävä provisioluokka erikseen. Tämä
mahdollistaa esimerkiksi eri hinnoittelun premium-asiakkaille tai halvemman
provision arvokkaammille tuotteille. Suomen Verkkomaksut toimittaa
sopimuksen mukaiset provisioluokkien ID:t myyntikanavalle. (pakollinen)
Versio 1.0.4
21.12.2010
Kenttä
Suomen Verkkomaksut Oy
Ohjelmakaari 10
40500 JYVÄSKYLÄ
Selite
Tuotteen alennusprosentti Jos tuotteesta on myönnetty alennus, voidaan tässä kentässä tuoda
alennusprosentti, joka on luku 0-100. Oletusarvo alennukselle on 0.
(vapaaehtoinen)
Tuotetyyppi
Tuoteriville voidaan määrittää tyyppi. Tyyppi 1 tarkoittaa normaalia tuoteriviä.
Postikuluille voidaan käyttää arvoa 2 ja käsittelykuluille arvoa 3. Oletusarvo
kentälle on 1. (vapaaehtoinen)
Versio 1.0.4
21.12.2010
Suomen Verkkomaksut Oy
Ohjelmakaari 10
40500 JYVÄSKYLÄ
Maksutiedon käsittely
Kun asiakas on suorittanut maksun verkkopankissa, ohjataan käyttäjä takaisin siihen osoitteeseen, joka
kentässä RETURN_ADDRESS on määritelty. Jos maksu on epäonnistunut tai peruuntunut, asiakas ohjataan
vastaavasti CANCEL_ADDRESS -kentässä määriteltyyn osoitteeseen.
Lisäksi käytössä on huomautusosoite NOTIFY_ADDRESS, jota kutsutaan ohjelmallisesti kun Suomen
Verkkomaksut kirjaa maksun onnistuneeksi. Tyypillisesti NOTIFY_ADDRESS-osoitetta kutsutaan välittömästi
ennen RETURN_ADDRESS-osoitteeseen siirtymistä. On mahdollista, että asiakas ei jostain syystä palaa pankin
palvelusta Suomen Verkkomaksujen palveluun. Tällöin maksu vahvistetaan yhden pankkipäivän viiveellä
Suomen Verkkomaksujen toimesta ja maksun vahvistamisen yhteydessä tehdään NOTIFY_ADDRESSosoitteeseen kutsu. NOTIFY_ADDRESS-osoitteen kutsu sisältää vastaavat GET-parametrit kuin
RETURN_ADDRESS-osoitteeseen siirtyminen.
Osoitteisiin RETURN_ADDRESS ja CANCEL_ADDRESS siirtymisessä sekä NOTIFY_ADDRESS-osoitteen
ohjelmallisessa kutsussa on mukana alla kuvatut GET-parametrit, joista maksun oikeellisuus tulee tarkistaa.
Kenttä
Tieto
Tiedon nimi
1.
Tilausnumero
ORDER_NUMBER
2.
Aikaleima
TIMESTAMP
3.
Maksutunnus
PAID
4.
Tarkistekenttä
RETURN_AUTHCODE
Seuraavassa listauksesa on kuvattu näiden kenttien tarkoitus.
Kenttä
Selite
Tilausnumero
Sama tilausnumero, joka lähetettiin aiemmin maksujärjestelmään. Tilausnumero
yksilöi jokaisen maksun.
Aikaleima
Suomen Verkkomaksujen tuottama aikaleima, jota käytetään tarkisteen
laskemiseen. Aikaleima on UNIX-muodossa, joka lasketaan sekunteina
vuorokauden 1.1.1970 vaihtumisesta.
Maksutunnus
Suomen Verkkomaksujen tuottama tunnus joka palautetaan vain onnistuneen
maksun paluutiedoissa.
Tarkistekenttä
Tarkistekenttä sisältää maksupalvelun laskeman hash-arvon, johon kauppias voi
verrata itse laskemaansa arvoa. Mikäli kauppiaan laskema arvo on sama kuin
maksupalvelun ilmoittama, on tieto maksusta tullut perille muuttumattomana.
Tarkiste voi olla sama, vaikka maksu olisikin epäonnistunut tai peruuntunut.
Versio 1.0.4
21.12.2010
Suomen Verkkomaksut Oy
Ohjelmakaari 10
40500 JYVÄSKYLÄ
Tarkisteen laskeminen
Tarkiste lasketaan suorittamalla seuraavat vaihdeet:
1. Muodostetaan merkkijono yhdistämällä kentät tilausnumero, aikaleima, maksutunnus ja
kauppiasvarmenne tässä järjestyksessä. Kaikkien mainittujen kenttien väliin sijoitetaan |-merkki (pipe,
vertical bar). Epäonnistuneen maksun tapauksessa paluutiedot eivät sisällä arvoja maksutunnus ja
maksutapa – näitä ei myöskään huomioida tarkisteen laskennassa.
2. Lasketaan muodostetusta merkkijonosta MD5-tiiviste
3. Huomioidaan saatu arvo 32-merkkisenä heksadesimaalisena esityksenä ja korvataan pienet kirjaimet
suurilla.
Esimerkki tarkisteen laskemisesta
Tilausnumero:
123456
Aikaleima:
1176557554
Maksutunnus:
F4SDGF23FS
Maksutapa:
1
Kanavavarmenne:
12345678901234567890123456789012345678901234567890123456789012345678901234567890123456789
012345678901234567890123456789012345678
Muodostetaan merkkijono: 15153|1176557554|F4SDGF23FS|1|
12345678901234567890123456789012345678901234567890123456789012345678901234567890123456789
012345678901234567890123456789012345678
Md5-funktiolla merkkijonosta laskettu hash-arvo:
65fd308175c2a06096536cacecf70465
Muutetaan pienet kirjaimet isoiksi:
65FD308175C2A06096536CACECF70465
Mikäli laskettu tarkiste on sama kun maksupalvelusta saatu arvo (RETURN_AUTHCODE), on maksukuittaus
saapunut virheettömänä.
Versio 1.0.4
21.12.2010
Suomen Verkkomaksut Oy
Ohjelmakaari 10
40500 JYVÄSKYLÄ
Testaus
Testitunnukset
Kanavamallia voidaan testata allaolevilla tunnuksilla.
Kanavatunnus (CHANNEL_ID): 123
Kanavavarmenne:
12345678901234567890123456789012345678901234567890123456789012345678901234567890123456789
012345678901234567890123456789012345678
Lisäksi jokaiselle testitilauksessa palveluun tuodulle tuotteelle on käytettävä kauppiastunnusta 13466.
Kanavamallin provisioluokan ID on testauksessa aina arvo 1.
Esimerkki
Tässä on listattu esimerkkikoodi painikkeelle, joka lähettää maksun Suomen Verkkomaksujen palveluun.
<form action="https://payment.verkkomaksut.fi/channel-payment" method="post">
<input name="CHANNEL_ID" type="hidden" value="123">
<input name="ORDER_NUMBER" type="hidden" value="12345678">
<input name="CURRENCY" type="hidden" value="EUR">
<input name="RETURN_ADDRESS" type="hidden" value="https://www.esimerkki.fi/ok">
<input name="CANCEL_ADDRESS" type="hidden" value="https://www.esimerkki.fi/cancel">
<input name="NOTIFY_ADDRESS" type="hidden" value="https://www.esimerkki.fi/notify">
<input name="VERSION" type="hidden" value="1">
<input name="CULTURE” type="hidden" value="fi_FI">
<input name="CONTACT_TELNO" type="hidden" value="+35812345678">
<input name="CONTACT_EMAIL" type="hidden" value="[email protected]">
<input name="CONTACT_FIRSTNAME" type="hidden" value="Matti">
<input name="CONTACT_LASTNAME" type="hidden" value="Meikäläinen">
<input name="CONTACT_COMPANY" type="hidden" value="Testi Oy Ab">
<input name="CONTACT_ADDR_STREET" type="hidden" value="Testikatu 1">
<input name="CONTACT_ADDR_ZIP" type="hidden" value="43210">
<input name="CONTACT_ADDR_CITY" type="hidden" value="Jyväskylä">
<input name="CONTACT_ADDR_COUNTRY" type="hidden" value="FI">
<input name="INCLUDE_VAT" type="hidden" value="1" />
<input name="ITEMS" type="hidden" value="2">
<input name="ITEM_TITLE[0]" type="hidden" value="Esimerkkituote 1">
<input name="ITEM_NO[0]" type="hidden" value="12345">
<input name="ITEM_AMOUNT[0]" type="hidden" value="1">
<input name="ITEM_PRICE[0]" type="hidden" value="10.00">
<input name="ITEM_TAX[0]" type="hidden" value="22.00">
<input name="ITEM_MERCHANT_ID[0]" type="hidden" value="13466">
<input name="ITEM_CP[0]" type="hidden" value="1">
<input name="ITEM_DISCOUNT[0]" type="hidden" value="0">
<input name="ITEM_TYPE[0]" type="hidden" value="1">
Versio 1.0.4
21.12.2010
Suomen Verkkomaksut Oy
Ohjelmakaari 10
40500 JYVÄSKYLÄ
<input name="ITEM_TITLE[1]" type="hidden" value="Esimerkkituote 2">
<input name="ITEM_NO[1]" type="hidden" value="12346">
<input name="ITEM_AMOUNT[1]" type="hidden" value="2">
<input name="ITEM_PRICE[1]" type="hidden" value="5.00">
<input name="ITEM_TAX[1]" type="hidden" value="22.00">
<input name="ITEM_MERCHANT_ID[1]" type="hidden" value="13466">
<input name="ITEM_CP[1]" type="hidden" value="1">
<input name="ITEM_DISCOUNT[1]" type="hidden" value="20.00">
<input name="ITEM_TYPE[1]" type="hidden" value="1">
<input name="AUTHCODE" type="hidden" value="657BAE6236F0FB709388FABB6467BFDB">
<input type="image" src="https://ssl.verkkomaksut.fi/logo/payhere_fin.jpg">
</form>
Ylläolevassa listauksessa viimeinen hidden-kenttä, AUTHCODE, on laskettu alla kuvatulla tavalla.
Yhdistetään kaikki kentät järjestyksessä, jossa ne on mainittu dokumentaatiossa. Kentät yhdistetään asettamlla
|-merkki (pipe, vertical bar) kenttien väliin. Jos jotakin kenttää ei lähetetä, asetetaan kentän kohdalle
laskennassa tyhjä merkkijono, jolloin merkkijonoon tulee kaksi tai useampia peräkkäisiä |-merkkejä.
Ensimmäisenä kenttänä laskennassa huomioidaan kanavavarmenne. AUTHCODE muodostetaan tästä
merkkijonosta laskemalla MD5-summa. Saatu arvo muutetaan heksadesimaaliseen, 32-merkkiä pitkään
esitysmuotoon ja merkkijonosta muutetaan pienet kirjaimet isoiksi.
Huomaa! Tässä esimerkissä laskenta tehdään UTF-8 -merkistössä. Suomen Verkkomaksujen palvelu tukee
UTF-8- ja ISO-8859-1 -merkistöjä. AUTHCODE:n laskenta on aina suoritettava samassa merkistössä, missä
tiedot lähetetään Suomen Verkkomaksujen palveluun. Suomen Verkkomaksujen palvelu tunnistaa
vastaanotetusta aineistosta automaattisesti käytetyn merkistön ja käyttää varmenteen laskennassa samaa
tunnistettua merkistöä.
Ylläolevassa esimerkissä kenttien arvot ovat seuraavat:
Versio 1.0.4
21.12.2010
Suomen Verkkomaksut Oy
Ohjelmakaari 10
40500 JYVÄSKYLÄ
Kanavavarmenne
1234567890123456789012345678901234567890123
4567890123456789012345678901234567890123456
789012345678901234567890123456789012345678
Kanavatunnus
123
Tilausnumero
12345678
Valuutta
EUR
Paluuosoite/onnistunut maksu
https://www.esimerkki.fi/ok
Paluuosoite/epäonnistunut maksu
https://www.esimerkki.fi/cancel
Huomautusosoite
https://www.esimerkki.fi/notify
Versionumero
1
Kulttuuri
fi_FI
Maksajan puhelinnumero
+35812345678
Maksajan matkapuhelinnumero
Maksajan sähköpostiosoite
[email protected]
Maksajan etunimi
Matti
Maksajan sukunimi
Meikäläinen
Maksajan yritys
Testi Oy Ab
Maksajan lähiosoite
Testikatu 1
Maksajan postinumero
43210
Maksajan postitoimipaikka
Jyväskylä
Maksajan kotimaa
FI
Arvonlisäveron sisältyminen
1
Tuoterivien määrä
2
Tuote #1, otsikko
Esimerkkituote 1
Tuote #1, numero
12345
Tuote #1, määrä
1
Tuote #1, hinta
10.00
Tuote #1, veroprosentti
22.00
Tuote #1, kauppiastunnus
13466
Tuote #1, kanavaprovision ID
1
Tuote #1, alennusprosentti
0
Tuote #1, tyyppi
1
Tuote #2, otsikko
Esimerkkituote 2
Tuote #2, numero
12346
Tuote #2, määrä
2
Tuote #2, hinta
5.00
Tuote #2, veroprosentti
22.00
Versio 1.0.4
21.12.2010
Tuote #2, kauppiastunnus
13466
Tuote #2, kanavaprovision ID
1
Tuote #2, alennusprosentti
20.00
Tuote #2, tyyppi
1
Suomen Verkkomaksut Oy
Ohjelmakaari 10
40500 JYVÄSKYLÄ
Nyt AUTHCODE:n laskemiseen käytettävä merkkijono saadaan yhdistämällä edelliset kentät:
12345678901234567890123456789012345678901234567890123456789012345678901234567890123456789
012345678901234567890123456789012345678|123|12345678|EUR|https://www.esimerkki.fi/ok|
https://www.esimerkki.fi/cancel|https://www.esimerkki.fi/notify|1|fi_FI||+35812345678||[email protected]|
Matti|Meikäläinen|Testi Oy Ab|Testikatu 1|43210|Jyväskylä|FI|1|2|Esimerkkituote 1|12345|1|10.00|22.00|13466|1|
0|1|Esimerkkituote 2|12346|2|5.00|22.00|13466|1|20.00|1
Tästä lasketaan MD5-tiiviste:
29322dbeebc3c86b1e1b1f31a007b4dc
(ISO-8859-1: 657bae6236f0fb709388fabb6467bfdb)
Muutetaan kirjaimet isoiksi, jolloin saadaan lopullinen varmenne:
29322DBEEBC3C86B1E1B1F31A007B4DC
(ISO-8859-1: 57BAE6236F0FB709388FABB6467BFDB)
Versio 1.0.4
21.12.2010
Suomen Verkkomaksut Oy
Ohjelmakaari 10
40500 JYVÄSKYLÄ
Avun saaminen asennuksiin
Voit soittaa tekniseen tukeemme numeroon 0207 1818 31 tai voit lähettää sähköpostia osoitteeseen:
[email protected].