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].
© Copyright 2024