E-maksu Palvelukuvaus
Sisällys 1 E-maksu...3 1.1 Yleiskuvaus... 3 1.2 Palvelun edut... 3 1.3 Käytettävyys... 3 1.4 Turvallisuus... 3 2 Palvelusopimus, käyttöohje ja käyttöönotto... 4 2.1 Palvelun edellytykset... 4 2.2 Palvelusopimus... 4 2.3 Testaus... 4 2.4 E-maksun käyttöohje verkkomaksamisessa... 5 2.4.1 Maksamisen nimi... 5 2.4.2 Solo-tavaramerkin ja Nordea-logon käyttö... 5 2.4.3 Maksamisliittymä myyjän sivulla... 5 2.4.4. E-Maksun toteuttaminen kauppiaan palvelussa... 5 2.4.5. E-maksu mobiilissa... 6 2.5 Käyttöönotto... 6 3 Tietuekuvaukset... 7 3.1 Yleistä... 7 3.2 E-maksun FORM-tietoryhmä... 7 3.3 E-maksun tarkiste... 9 3.4 Paluuseen liitetyt varmistetut tiedot... 10 4 E-maksu WAP:lla... 11 4.1 Yleiskuvaus... 11 4.2 Palvelun edellytykset... 11 4.3 Testaus... 11 5 E-maksun kysely... 13 5.1 Yleistä... 13 5.2 E-maksun kyselyn käyttö kauppiaan palvelussa... 13 5.3 E-maksun kyselyn tiedot ja muoto... 14 5.4 E-maksun kyselyn vastaussanoman tiedot... 15 5.5 astauksen muoto eri tilanteissa... 16 6 E-maksun palautus... 16 6.1 Yleistä... 16 6.2 Rajoitukset... 16 6.3 E-maksun palautuksen käyttö kauppiaan palvelussa... 16 6.4 E-maksun palautuksen tiedot ja muoto... 16 6.5 Palautuspyynnön vastauksen tiedot... 18 6.6 astauksen muoto eri tilanteissa... 18 7 Neuvonta ja tuki... 19
1 E-maksu 1.1 Yleiskuvaus E-maksu on elektroninen maksamisen tapa, jossa ostaja ostaa ja maksaa ostoksensa yhden ja saman verkkoyhteyden aikana. Ostajan maksu voi siirtyä heti tai myöhemmin myyjälle. Myyjä saa tiedon ostajan suorituksesta e-maksun viitteen avulla. Myyjällä on käytössään myös kyselyja palautus-toiminnot. Kyselytoiminnon avulla myyjä voi varmistua e-maksun onnistumisesta. Palautustoiminnon avulla e-maksua käyttävä myyjä voi palauttaa e-maksulla maksetun ostoksen tai osan siitä. 1.2 Palvelun edut Myyjän ei tarvitse postittaa ostajalle erillistä laskua eikä käyttää postiennakkoa tavaran toimitukseen, jolloin laskutus- ja toimituskuluja säästyy. Myyjä saa halutessaan heti ostajan suorituksen tililleen ja voi myös heti varmistua siitä. Myyjän ei tarvitse hankkia uusia ohjelmia e-maksua varten, koska se perustuu samaan WWWtekniikkaan myyjän palvelun kanssa. Myyjällä on turvallinen tapa laskuttaa sähköisistä palveluistaan. 1.3 Käytettävyys E-maksu on käytettävissä 24 h/vrk. 1.4 Turvallisuus Ostajan ja Nordean välisessä tiedonvaihdossa käytetään SSL-turvatekniikkaa. Se salakirjoittaa koko tietoliikenteen jatkuvasti vaihtuvilla avaimilla, jolloin ulkopuoliset eivät voi lukea eivätkä muuttaa siirrettävää tietoa. Turvatekniikalla voidaan myös varmistaa, että ostaja asioi nimenomaan Nordean e-maksu -palvelimen kanssa, ja tarkistaa, että maksamiseen liittyvät tiedot eivät muutu tietoliikenneyhteyden aikana missään vaiheessa. E-maksussa kukaan ulkopuolinen ei pääse käyttämään maksajan tiliä, sillä Nordea tunnistaa maksajan luotettavasti asiakasnumeron ja käyttökerroittain vaihtuvan tunnuksen avulla. Maksaja vahvistaa myös jokaisen e-maksun vahvistustunnuksella. Marraskuu 2006 3
2 Palvelusopimus, käyttöohje ja käyttöönotto 2.1 Palvelun edellytykset Myyjäyrityksen laskutusjärjestelmän on kyettävä muodostamaan WWW-tekniikalla ostajalle lasku, jossa on laskutustietojen lisäksi myös e-maksun tiedot. Kun ostaja on hyväksynyt laskun, pitää tämä tieto välittää laskutus- ja tilaustenkäsittelyjärjestelmään. e-maksu ei edellytä kuitenkaan mitään tiettyä WWW-palvelinohjelmistoa. Ostajan suoritusten seurantaan myyjäyritys tarvitsee Nordean maksuliikepalveluista tapahtumaotteen, tiliotteen tai viitemaksun. Esim. pankkiohjelmalla ja verkkopankissa aineistot voidaan noutaa pankin eräsiirtopalvelusta. Noudetut tiedostot voi jatkokäsitellä reskontraohjelmistoissa. 2.2 Palvelusopimus Myyjäyritys tekee kirjallisen palvelusopimuksen Nordean kanssa. Myyjän tiedot rekisteröidään pankissa, josta hän saa käyttöönsä myyjän tunnuksen. Pankki edellyttää turvatarkisteen käyttöä ja antaa tarkisteavaimen myyjäyritykselle. Myyjäyritys ilmoittaa konttoriin, kun hänen palveluunsa tai tietoihinsa tulee muutoksia. Konttori täydentää tarvittaessa sopimusta muuttuneilla tiedoilla. 2.3 Testaus Myyjä voi testata e-maksua tuotantoympäristössä käyttämällä testitunnuksia jo ennen kuin sopimus on tehty. Myyjän tunnukset: Turvatarkiste mukana: Myyjän tunnus (RC_ID) 12345678 ja tarkisteavain LEHTI Testitilinä 29501800000014 tai 29501800008512 Testimyyjälle voi maksaa ainoastaan testiostaja. Tällöin maksua ei makseta, mutta työnkulun voi testata. Maksun palautusta ei voi testitunnuksilla testata, kuten ei myöskään tehtyjen maksujen kysely toimintoa. Marraskuu 2006 4
2.4 E-maksun käyttöohje verkkomaksamisessa 2.4.1 Maksamisen nimi Nordean verkkomaksaminen on nimeltään e-maksu. Muita nimityksiä ei saa käyttää. 2.4.2 Solo-tavaramerkin ja Nordea-logon käyttö Myyjäyrityksen palvelusivulla e-maksun käyttö on ilmaistava Nordea-logolla tai tekstillä Nordea, Solo ja sen on oltava selvästi näkyvillä. Nordea-logoa käytetään myös painikkeena, jolloin se toimii maksamisen linkkinä. Tällöin Nordea-logosta käytetään nimeä Nordea-kuvake. Kuva 1. Nordean e-maksun esitys tekstinä. Kuva 2. Nordean e-maksun esitys kuvakkeena. Kun myyjä allekirjoittaa palvelusopimuksen, hän sitoutuu käyttämään Nordea-logoa ja Solo tavaramerkkiä Nordean hyväksymällä tavalla. Tavaramerkkiä ei saa luovuttaa tai käyttää muuhun tarkoitukseen kuin palvelusopimuksessa on sovittu. Nordea-logoa ja Solo -tavaramerkkiä ei saa itse tehdä eikä muotoilla. Myyjäyritys kopioi Nordea-logon palvelimellensa Nordean palvelimelta. 2.4.3 Maksamisliittymä myyjän sivulla Sopimus edellyttää myyjää käyttämään Nordea-logoa ja tilisiirtolomaketta maksamisessa. Nordealogosta ja tilisiirtolomakkeesta asiakas tunnistaa maksamistoiminnon. Tämä edistää kaupankäyntiä, koska paperinen ja maksuautomaatin kuvaruudun tilisiirtolomake ovat asiakkaalle tuttuja ennestään. Tilisiirtolomake on helppolukuinen ja se herättää asiakkaassa luottamusta. Tilisiirtolomakkeeseen on liitettävä Solo-kuvake. 2.4.4. E-Maksun toteuttaminen kauppiaan palvelussa On suositeltavaa toteuttaa e-maksu kauppiaan internet-palvelussa mahdollisimman suoraviivaisesti ja yksinkertaisesti. Kehysten (frameset, frame) käyttö ei ole hyväksyttävää ja maksu saattaa epäonnistua johtuen ostajan laitteista, selaimesta ja sen versioista tai asetuksista. astaavat seikat tulee huomioida myös käytettäessä selaimen nk. ikkunointi-tekniikkaa. Jos tätä halutaan ehdottomasti käyttää, on ikkunointi toteutettava siten, että perustettuun ikkunaan luodaan myyjän palvelusta tässä dokumentissa kuvattu e-maksu lomake ja myyjän kuittaus hyväksytystä maksusta. armistaaksemme e-maksun turvallisen käytön maksutapana, ei e-maksua saa välittää sähköpostitse tai muilla vastaavilla tavoilla. Marraskuu 2006 5
2.4.5. E-maksu mobiilissa E-maksua on mahdollista hyödyntää myös mobiilissa kanavassa. Erillistä palvelusopimusta ei tarvita, vaan e-maksun sopimus sisältää myös e-maksun käyttöönoton mobiilissa. Palveluntarjoajalla on oltava vähintää yksi sivu mobiilissa kanavassa, josta ostaja voi siirtyä Nordean e-maksupalveluun. Ostajalla pitää olla Nordean verkkopankkitunnukset, ja mahdollisuus käyttää selainta tukevaa matkapuhelinta. E-maksu mobiilissa toimii samalla tavalla kuin e-maksu internetissä. Palveluntarjoaja välittää maksupyynnön Nordealle samalla tietoryhmällä kuin internetissä maksamisessakin. Ainoastaan kenttä 18 yksilöi, että kyseessä on mobiilissa tapahtuva e-maksu. Tällöin maksajalle esitetään internetissä käytetyn e-maksun sijasta mobiili e-maksu. Asiakkaan maksettua ostoksensa palataan palveluntarjoajan palveluun samalla tavalla kuin e-maksulla internetissäkin. On huomioitavaa, että myös mobiilissa kanavassa on palattava palvelutarjoajan palveluun, jotta kuittaus maksutapahtuman onnistumisesta välittyy paluun yhteydessä palveluntarjoajalle. 2.5 Käyttöönotto Palvelun käyttöönottopäivä sovitaan, kun sopimus tehdään. Marraskuu 2006 6
3 Tietuekuvaukset 3.1 Yleistä Myyjän antamat laskutustiedot ovat Nordea-logon FORM-tietoryhmässä. Tietoryhmän rakenne on HTML-kielellä: <form method= post action= https://solo3.nordea.fi/cgi-bin/solopm01 > <input name=... type=... value=... > </form> E-maksun alkutiedot: Menetelmä=POST Palvelin: //solo3.nordea.fi/... E-maksun varsinaiset tiedot: Tiedon nimi, tyyppi ja arvo E-maksun loppu 3.2 E-maksun FORM-tietoryhmä Kenttä Tieto Tiedon nimi Arvo Muoto P/ INPUT NAME= ALUE= 1. Maksun versio SOLOPMT_ERSION 0003 AN 4 P 2. Maksun tunnus SOLOPMT_STAMP Maksun yksilöivä tunnus N 20 P 3. Myyjän tunnus SOLOPMT_RC_ID Asiakastunnus AN 15 P 4. Myyjän tili SOLOPMT_RC_ACCOUNT Muu kuin oletustili AN 15 5. Myyjän nimi SOLOPMT_RC_NAME Muu kuin oletusnimi AN 30 6. Maksun kieli SOLOPMT_LANGUAGE 1 = suomi N 1 2 = ruotsi 3 = englanti 7. Maksun määrä SOLOPMT_AMOUNT Esim. 990,00 AN 19 P 8. Maksun viite SOLOPMT_REF Standardiviite AN 20 P 9. Maksun eräpäivä SOLOPMT_DATE EXPRESS tai PP.KK. AN 10 P 10. Maksun viesti SOLOPMT_MSG Ostajan viesti AN 234 11. Paluu-linkki SOLOPMT_RETURN Paluuosoite maksamisen jälkeen AN 120 P 12. Peruuta-linkki SOLOPMT_CANCEL Paluuosoite peruutuksessa AN 120 P 13. Hylätty-linkki SOLOPMT_REJECT Paluuosoite hylätyssä maksussa AN 120 P 14. Maksun tarkiste SOLOPMT_MAC Turvatarkiste AN 32 P 15. Maksun vahvistus SOLOPMT_CONFIRM YES tai NO A 3 16. Avaimen versio SOLOPMT_KEYERS Esim. 0001 N 4 P 17. aluuttakoodi SOLOPMT_CUR EUR A 3 P 18. Päätelaitteen tyyppi SOLOPMT_PMTTYPE M A 1 Marraskuu 2006 7
Lisäselvitykset A/N= Alfa/numeerinen, eli tietosisältö aakkosia tai numeroita. Pituus ilmaisee kentän maksimipituuden /P= tieto valinnainen tai pakollinen ersiossa 0003 voivat maksun kenttien nimet olla myös ilman alkuliitettä SOLOPMT_ eli esim. SOLOPMT_ERSION sijaan voidaan käyttää myös nimeä ERSION. Näin toimittaessa vastaava pitää paikkansa myös paluutiedoissa. Kentän 1 Maksun versio: maksun versionumerolla tarkennetaan maksun tietojen esittämismuotoa. Hyväksymme versioit 0002 ja 0003, suosittelemme version 0003 käyttöä. Kentän 2 Maksun tunnus on myyjän maksulle antama yksilöivä tunnus, jonka avulla estetään maksun syntyminen kahteen kertaan esim. reload-toiminnon vuoksi. Tunnuksena voi olla viite tai yhdistelmä päivämäärästä, kellon ajasta ja juoksevasta tunnuksesta. Kentän 3 Myyjän tunnus on Nordea asiakastietorekisterissään antama tunnus myyjälle (= sopimuslomakkeessa Asiakastunnus ). Tunnuksen perusteella tulee maksulle saajan nimi ja tili pankin rekisteristä. Tunnus on sopimuslomakkeessa ja syötetään ilman väliviivaa. Kentässä 8 on maksun viite. Koska e-maksussa käytetään MAC-tarkistetta, pitää viite esittää ilman viitestandardin mukaista ryhmittelyä ja välilyöntejä. Tapahtumalle annetusta tunnuksesta esim. 1234567 voidaan muodostaa viite laskemalla viimeiseksi merkiksi tarkiste painoilla 7-3-1. Tunnuksen numerot kerrotaan oikealta alkaen painoilla ja tulot lasketaan yhteen. Summa vähennetään seuraavasta kymmenestä ja erotus on luvun perään lisättävä tarkiste. Luku 1 2 3 4 5 6 7 Kerroin 7 1 3 7 1 3 7 Summat 7 2 9 28 5 18 49 = 118 Tarkiste 120-118 = 2 Tapahtuman viite on 12345672 Kentässä 9 on maksun eräpäivä. Jos eräpäivänä on EXPRESS tai HETI, tilisiirto ostajalta myyjälle tehdään välittömästi ostajan hyväksyttyä maksun. Jos eräpäivänä on kuluvaa päivää myöhempi ajankohta, maksu tallentuu pankin järjestelmään ja maksetaan annettuna eräpäivänä. Jos eräpäivä on jokin muu kuin pankkipäivä, niin pankin järjestelmä maksaa maksun eräpäivää lähimpänä seuraavana pankkipäivänä. Kentän 10 Maksun viesti pitää muotoilla tiliotteen viestirivien mukaan 35 merkin riveiksi, joita voi olla korkeintaan kuusi kappaletta. iestitieto välittyy vain ostajalle. Kentän 11 Paluu-linkki on jatkokohta myyjän palvelussa. Tiedon on oltava täydellinen HTML-kielen mukainen, johon myyjä on voinut liittää nk. query-string:n tai parametri-tietoja. Esimerkkejä: ALUE= http://tuote.kauppa.fi/tilaus/kiitos.htm tai ALUE= http://tuote.kauppa.fi/cgi-bin/kiitos?tilnro=1234. Kentän 12 Peruuta-linkki on jatkokohta myyjän palvelussa, jos ostaja peruu E-maksun. Tiedon on oltava HTML-kielen mukainen täydelllinen url-osoite, esim. ALUE= http://tuote.kauppa.fi/tilaus/lasku.htm. Kentän 14 Maksun tarkiste (turvatarkiste käsikirjan kohdassa 3.3) lasketaan MD5-algoritmilla maksun suojattavista tiedoista ja myyjän tarkisteavaimesta. Maksun tarkiste tallennetaan ISOILLA kirjaimilla. Marraskuu 2006 8
Kenttä 15 Jos kentässä on YES, myyjä saa kaikissa paluulinkeissä (ok-maksu, keskeytetty, hylätty) tiedon maksun käsittelystä. Kentässä 16 ilmoitetaan käytetyn salausavaimen versionumero. ersionumero löytyy nyt toimitettujen uusien turvatarkisteiden kuorista. Jos palvelussa käytetään turvatarkistetta, versionumero on pakollinen. Kentässä 17 ilmoitetaan tapahtuman valuutta. Kentässä on aina oltava valuuttakoodi (EUR). Kentässä 18 ilmoitetaan päätelaitteen tyyppi jos kyseessä on mobiili (XHTML)-selaimessa suoritettu e-maksu, M=Mobiili päätelaite. Päätelaitteen tyyppi tulee merkitä ISOLLA. Tämä kenttä on valinnainen. Jos kenttä puuttu, niin maksupyyntö käsitellään internetissä tapahtuvana e-maksuna. 3.3 E-maksun tarkiste Maksun tarkiste saadaan seuraavasti: 1. Muodostetaan merkkijono seuraavista kentistä SOLOPMT_ERSION& SOLOPMT_STAMP& SOLOPMT_RC_ID& SOLOPMT_AMOUNT& SOLOPMT_REF& SOLOPMT_DATE& SOLOPMT_CUR& Myyjän tarkisteavain& Merkkijonossa ei ole tyhjä-merkkejä ja &-merkit ovat mukana laskennassa. Huom. e-maksun versio on 0003 tai 0002 ja tietojen on oltava kuvatussa järjestyksessä. Esimerkki: 0003&1998052212254471&12345678&570,00&55&EXPRESS&EUR&LEHTI& Laskennan tulos: 60FC3A5668E0AFF3CB27CF32C610CB70 2. MD5-algoritmilla lasketaan em. merkkijonosta hash-arvo, joka muutetaan heksadesimaaliseen, 32- merkkiä pitkään esitysmuotoon. 3. Saatu hash-arvo viedään Maksun tarkiste -kenttään. Myyjän tarkisteavain on pankin antama tunnus ja se on seuraavanlainen: 32 merkkiä pitkä Myyjäkohtainen Avain toimitetaan postitse sopimuksen teon jälkeen Marraskuu 2006 9
3.4 Paluuseen liitetyt varmistetut tiedot Käytettäessä MAC-tarkistetta e-maksussa, paluuseen voidaan pyytää lisätietoja ja niille tarkiste. Myyjän WWW-järjestelmä voi näiden avulla varmistua, että paluu tapahtui onnistuneesta, hylätystä tai keskeytetystä e-maksusta. Huom: 100 %:n varmuuden rahan siirtymisestä kauppa saa viitesiirto- tai tilioteaineistosta, tai tekemällä erillisen tilitapahtumakyselyn. Jos paluulinkkiin on haluttu lisätiedot ja varmiste asettamalla e-maksun kentän SOLOPMT_CONFIRM arvoksi YES, laskee pankin järjestelmä paluulinkin loppuun seuraavat parametritiedot nk. query-string muodossa: SOLOPMT_RETURN_ERSION=0003 SOLOPMT_RETURN_STAMP=maksun yksilöivä tunnus SOLOPMT_RETURN_REF=maksun viitenumero SOLOPMT_RETURN_PAID=tapahtuman arkistointitunniste pankin järjestelmässä (uusi tieto) SOLOPMT_RETURN_MAC=paluutietojen tarkiste Paluutiedot ovat muodoltaan ja sisällöltään samat kuin vastaavat kentät alkuperäisessä maksussa. SOLOPMT_RETURN_PAID on heti (express)-maksuilla uusi paluutieto, jonka pituus on maksimissaan 20 merkkiä. Eräpäivämaksuilla, hylätyillä tai keskeytetyillä maksuilla tätä parametritietoa ei liitetä paluulinkkiin. SOLOPMT_RETURN_MAC lasketaan samoin kuin varsinaisella e-maksulla muodostamalla merkkijono seuraavien paluutietojen sisällöstä: SOLOPMT_RETURN_ERSION& SOLOPMT_RETURN_STAMP& SOLOPMT_RETURN_REF& SOLOPMT_RETURN_PAID& (ei mukana eräpäivämaksuilla) myyjän tarkisteavain& Merkkijonossa ei ole tyhjä-merkkejä ja &-merkit ovat mukana laskennassa. MD5-algoritmilla lasketaan em. merkkijonosta hash-arvo, joka muutetaan heksadesimaaliseen, 32-merkkiä pitkään esitysmuotoon. Tämä palautetaan myyjälle palaute-parametrissä SOLOPMT_RETURN_MAC. Esimerkki paluu-linkin ja -tarkisteen käytöstä: alkuperäinen paluulinkki: ALUE= http://tuote.kauppa.fi/cgi-bin/kiitos?tilnro=1234 palattaessa myyjälle on paluu-url:n sisältönä seuraavaa: http://tuote.kauppa.fi/cgi-bin/kiitos?tilnro=1234&solopmt_return_ ERSION=0003&SOLOPMT_RETURN_STAMP=123456&SOLOPMT_RETURN_REF=578344 65&SOLOPMT_RETURN_PAID=960531258874B85991&SOLOPMT_RETURN_MAC=35C922 08C7A1B02CEA10A65447D65825 Marraskuu 2006 10
4 E-maksu WAP:lla 4.1 Yleiskuvaus E-maksu WAP:lla on yksi yhteen kopio Internetin e-maksusta. E-maksun koodi konvertoidaan WMLkieleen. Kaikki liikenne ja WAP-protokollat kulkevat Nordean gatewayn kautta. Maksut voidaan tehdä ainoastaan Nordean gatewayn kautta. Muita palveluja voidaan käyttää muiden gatewayden kautta. Myyjäyrityksen linkki asetetaan Nordean WAP Solo-torille. Koska WAP-standardissa ei ole vielä gateway switchingiä, palvelu rakennetaan niin, että ostaja tulee kirjautuu palveluun Nordean soittosarjasta (Solo-torille) pankin serverille. Solo-torilta on linkki kauppiaan sivuille, joka voi sijaita millä tahansa WAP-severillä. Ostajan siirtyessä Nordeasta kauppiaan serverille istunnon hallinta siirtyy kauppiaalle. Ostoksensa tehtyään ostaja valitsee maksupainikkeen kauppiaan sivuilla, jolloin istunto palautuu Nordeaan ja asiakas syöttää Solotunnuksensa ja vaihtuvan salasanan sisäänkirjautumista varten. WML kontekstissa tulevat maksun tiedot, joiden avulla muodostetaan maksu Solossa. Kauppiaas saa paluuviestissä tiedon maksun onnistumisesta ja istunto siirretään takaisin kauppiaalle. Liikenne kauppiaan ja Nordean välillä on MAC-koodattua mutta ei WTLS-suojattua. 4.2 Palvelun edellytykset Myyjäyrityksellä on oltava http-palvelu, joka tukee WML 1.1:stä. Laskun on sisällettävä samat tiedot WAP:ssä kuin internetissä tehtävässä e-maksussa. Edellytykset ovat muten samat, kuin e-maksussa internetissä. Erillistä palvelusopimusta ei tarvita, vaan E-maksun sopimus sisältää myös e-maksun käyttöönoton WAP:ssa. 4.3 Testaus Testaaminen tapahtuu QA-ympäristössä. Testattaessa asetetaan kotisivuksi kauppiaan testi WML-sivu. Gateway on 192.163.87.3. E-maksun URL on http://192.163.87.2:891/cgi-bin/wapspm01. Testattaessa e-maksua (demo ja Nokia 7110) käytetään salasanana 3333:a ja vahvistustunnuksena 6666:a. Asiakasnumerona käytetään E-maksun kauppias-id:tä ja mac-koodia (kts kappale 2.3). Esimerkki WAP e-maksusta Kyseessä on yleinen esimerkki siitä, miltä Solon e-maksu näyttää WAP:ssä. <anchor>maksa<go method="post" href="http://solow.merita.fi/cgi-bin/wapspm01"> postfield name="solopmt_return value="http://wap.merita.fi/wap/h6420004.asp?lang=1&a=ok"/> postfield name="solopmt_cancel value="http://wap.merita.fi/wap/h6420004.asp?lang=1&a=pe"/> postfield name="solopmt_reject value="http://wap.merita.fi/wap/h6420004.asp?lang=1&a=hy"/> postfield name="solopmt_ersion" value="0002"/> <postfield name="solopmt_stamp" value="10919991130363829"/> <postfield name="solopmt_rc_id" value="12345678"/> <postfield name="solopmt_rc_name" value="solo-kauppa"/> <postfield name="solopmt_amount" value="37.00"/> <postfield name="solopmt_ref" value="55"/> <postfield name="solopmt_date" value="express"/> <postfield name="solopmt_msg" value="esittelyostos"/> <postfield name="solopmt_mac" value="eab83744a7782ee0a67c4f1e1ea074c2"/> <postfield name="solopmt_confirm" value="yes"/> <postfield name="solopmt_cur" value="eur"/> </go></anchor> Marraskuu 2006 11
Nokian 7110 ja jotkut muut päätelaitteet eivät hyväksy post-metodia. Tällöin e-maksu näyttää seuraavalta. <anchor title="pai">maksa <go method="get" href="http://solow.merita.fi/cgibin/wapspm01?solopmt_language=1& SOLOPMT_RETURN=http://localhost/wap/h64004.asp?lang=1& SOLOPMT_CANCEL=http://localhost/wap/h6420005.asp?lang=1& SOLOPMT_REJECT=http://localhost/wap/h6420006.asp?lang=1& SOLOPMT_ERSION=0002& SOLOPMT_STAMP=101119991537469183& SOLOPMT_RC_ID=12345678& SOLOPMT_RC_NAME=Solo-kauppa& SOLOPMT_AMOUNT=27.00& SOLOPMT_REF=55& SOLOPMT_DATE=EXPRESS&SOLOPMT_MSG=Esittelyostos&SOLOPMT_MAC=FD92 8F9A8E678190B444AA39744813B3& SOLOPMT_CONFIRM=YES& SOLOPMT_CUR=EUR"/> </anchor> Seuraavassa on esimerkki e-maksun paluulinkistä. <go sendreferer="true href="http://194.211.252.167/wap/h6420004.asp?lang=1&a=ok& SOLOPMT_RETURN_ERSION=0002& SOLOPMT_RETURN_STAMP=10919991130363829& SOLOPMT_RETURN_REF=55& SOLOPMT_RETURN_PAID=10092588INW10008& SOLOPMT_RETURN_MAC=E314D11B623C5D7E4DBFF22C2CAB698D"/> Tämä linkki ohjataan myyjän paluu URL:n automaattisella ajoitustapahtumalla asiakkaan (ostajan) WAP-selaimen toimesta. Seuraavassa kaaviokuvassa on esitetty Solo WAP-palveluympäristön testi. Internet Use any ISP or Toolkit Nokia WAP Server Solo Internet Test (WEB & WAP) Merchant WML Test-service Banking Payment Solo Market Solo News Unauthorized usage prohibited Marraskuu 2006 12
WAP:n tuotantoympäristö näyttää seuraavalta. Nokia 7110 Ericsson Mc218, R320 Siemens C35i COMPAQ Aero 2500 etc INTL Sonera Telia RL Dedicated GSM dial-in Nokia WAP Server Solo Internet Applications (WEB & WAP) Banking Payment Internet Solo payment Merchants (WML) Solo Market Solo News 5 E-maksun kysely 5.1 Yleistä E-maksun kyselytoiminnon avulla e-maksua käyttävä voi varmistua maksun hyväksymisestä ja pikamaksuissa maksamisesta epäselvissä e-maksutilanteissa. 5.2 E-maksun kyselyn käyttö kauppiaan palvelussa E-maksun kysely on tarkoitettu automaattiseksi, ohjelmallisesti toteutetuksi toiminnoksi, jolla kauppias voi kysellä kaikkia tai avoimia maksujaan. Kauppiaan www-palvelin voi esimerkiksi käydä läpi tilauksia, joihin palvelin ei ole saanut normaalia maksamiseen liittyvää kuittausta. Avoimen tilauksen kohdalla palvelin muodostaa kyselytapahtuman, jossa on mm. ko. kauppiaan tunnus, maksun tunnus ja joka on suojattu tunnistamista ja muuntamattomuutta varten MAC-tarkisteella. Kysely lähetetään pankin palvelimelle http-lomakkeena salattua ssl-yhteyttä käyttäen ja pankin palvelin vastaa samoin. Pankin vastauksessa on halutussa muodossa maksun tarkat yksilöintitiedot, jos alkuperäinen ostaja on maksun hyväksynyt. Heti maksuilla palaute sisältää myös varsinaisen maksun yksilöintitiedon. astaus on muotoiltu siten, että kauppiaan palvelin voi käsitellä vastauksen ohjelmallisesti ja päivittää tilauksen tiedot. Koska ohjelmallisen SSL-(https)-yhteyden käyttö saattaa eräissä tilanteissa olla työlästä ja hankalaa, on näitä uusia E-maksun ominaisuuksia myös mahdollista käyttää selaimen avulla "manuaalisesti". Tällöin kauppiaan www-palvelimella on esimerkiksi palveluohjelma, jolla selainkäyttäjä voi hakea seuraavan avoimen tilauksen selaimeensa siten että se on muotolitu kuten yllä ja voidaan lähettää Nordean palvelimelle käyttäen selaimen ssl-ominaisuuksia (siis kuten varsinaiset E-maksutkin). Kun käyttäjä nyt lähettää palvelimensa muodostaman e-maksukyselyn Nordean palvelimelle, e-maksun kyselyn vastaus tuleekin takaisin tälle käyttäjän selaimelle. Tällöin siinä mukana on piilolomake ja nappi, jolla käyttäjä voi lähettää Nordean e-maksun kyselyn vastauksen toiselle palvelinohjelmalleen joka voi nyt päivittää tilauksen tiedot. Lisäksi tässä vastauksessa on myös ko. maksun tiedot näkyvinä. Marraskuu 2006 13
5.3 E-maksun kyselyn tiedot ja muoto E-maksun kysely form-muodossa ja siinä on oltava seuraavat tiedot: Form action https://solo3.nordea.fi/cgi-bin/solopm10 Form method post Kenttä Tieto Tiedon nimi Arvo Sisältö ja pituus 1. Maksun versio SOLOPMT_ERSION 0001 AN 4 P 2. Kyselyn aika SOLOPMT_TIMESTMP muodossa KKPPHHMMSSnnnn missä nnnn on tarvittaessa järjestysnumero 3. Myyjän tunnus SOLOPMT_RC_ID Kauppiaan tunnus sopimuslomakkeesta; syötetään ilman väliviivaa 4. Kielikoodi SOLOPMT_LANGUAGE 1= suomi 2= ruotsi 3= englanti 5. astauksen tyyppi SOLOPMT_RESPTYPE "html" => astaus palautetaan htmlmuodossa "xml" => astaus palautetaan xmlmuodossa 6. astauksen lisätiedot SOLOPMT_RESPDATA html: Jos vastaukseen halutaan mukaan form-tietoryhmä, tässä ilmoitetaan ko. form-tietoryhmän action osoite täydellisenä. Jos tyhjä, form-tietoryhmää ei liitetä vastaukseen. xml: Jos xml-muotoisen vastauksen mime-tyypiksi halutaan joku muu kuin "text/html" se kerrotaan tässä kentässä. 7. Ohjelmamuotoisten tietojen näyttäminen 8. Alkupäisen ts. kyseltävän e-maksun yksilöivä tunnus (joko stamp tai ref oltava) 9. Alkuperäisen ts. kyseltävän e-maksun yksilöivä viite (joko stamp tai ref oltava) SOLOPMT_RESPDETL SOLOPMT_STAMP " " Ei 'ohjelmamuotoisia' tietoja näkyvään html:ään "Y" 'Ohjelmamuotoiset' tiedot näytetään Kauppiaan antama alkuperäisen maksun tunnus N 18 AN 15 N 1 A 4 AN 120 A 1 N 20 SOLOPMT_REF Standardiviite AN 20 10 Maksun määrä SOLOPMT_AMOUNT esim. 0000000009900 (=99 eur) AN 13 11. Maksun valuuttatieto SOLOPMT_CUR EUR A 3 12. Käytössä olevan avaimen versio SOLOPMT_KEYERS esim. 0001 N 4 P 13. Käytetty algoritmi SOLOPMT_ALG "01" N 2 P 14. Maksun tarkiste SOLOPMT_MAC Kyselyn tarkiste SOLOPMT_MAC muodostetaan kyselyssä mukana olevista tiedoista. Jos joku kenttä jää pois (SOLOPMT_REF) niin mac laskennasta jää pois ko. kenttä ja &- merkki. AN 32 P/ P P P Marraskuu 2006 14
Esimerkki mac-laskennasta: 0001&199911161024590001&12345678&1&html&http://158.233.9.9/hsmok.htm&Y&501&0001&01 &LEHTI& Laskennan tulos: D5543FF001A863681A39DD84DD7E33FB 5.4 E-maksun kyselyn vastaussanoman tiedot astauksella on seuraavat tiedot: Kenttä Tieto Tiedon nimi Arvo Sisältö ja pituus 1. Kyselyn versio SOLOPMT_ERSION 0001 AN 4 2. Kyselyn aika SOLOPMT_TIMESTMP Muodossa KKPPHHMMSSnnnn, missä nnnn on tarvittaessa järjestysnumero N 18 3. Myyjän tunnus SOLOPMT_RC_ID Kauppiaan tunnus AN 15 4. Paluutieto SOLOPMT_RESPCODE "OK" Jos maksu löytyi ja se on hyväksytty "Notfound" Jos maksua ei löytynyt "Error" Maksussa on jotain epäselvää (yhteys pankkiin) 5. Alkuperäisen maksun tunnus SOLOPMT_STAMP Kauppiaan antama alkuperäisen maksun tunnus 6. Myyjän tili SOLOPMT_RC_ACCOUNT Muu kuin oletustili AN 15 7. Maksun viite SOLOPMT_REF Standardiviite AN 20 8. Maksupäivä SOLOPMT_DATE vvvvkkpp -muodossa AN 10 9. Maksun määrä SOLOPMT_AMOUNT esim. 0000000009900 (=99 eur) 10. Maksun valuuttatieto SOLOPMT_CUR EUR A 3 11. Maksun arkistotunnus hetimaksuilla A 8 N 20 AN 13 SOLOPMT_PAID Pankin arkistointitunnus AN 16 12. Maksun tila SOLOPMT_STATUS Prod=tuotantomaksu, Test=testimaksu 13. Avaimen versio SOLOPMT_KEYERS Kuten e-maksussa, esim. 0001 N 4 14. Käytetty algoritmi SOLOPMT_ALG "01" N 2 15. Kyselyn tarkiste SOLOPMT_MAC Kyselyn tarkiste AN 32 A 4 Marraskuu 2006 15
5.5 astauksen muoto eri tilanteissa Jos kysely ei mene MAC-ym. turvatarkastuksista läpi, vastauksena tulee http-virheilmoitus, response status 404, http error 404 url not found. Jos maksua ei löydy tai samalla viitteellä tehty useampi maksu, maksun tietoja ei palauteta vaan vastauksena tulee Maksu ei löydy -virheilmoitus. Ohjelmamuotoisessa osassa näytetään kyselyn tiedot (pyydettäessä). Html muotoiset vastaukset (SOLOPMT_RESPTYPE="html"): Pelkkä html-vastaus: SOLOPMT_RESPDATA ei mukana. Pelkkä maksupohja: SOLO_RESPDETL ei mukana. Maksupohja ja ohjelmamuotoiset tiedot: SOLO_RESPDETL="Y". Painike ("Rekisteröi") maksun tietojen välitykseen ohjelmallisesti: SOLO_RESPDATA mukana. 6 E-maksun palautus 6.1 Yleistä E-maksun palautustoiminnon avulla e-maksua käyttävä myyjä voi palauttaa e-maksulla ostoksen maksaneelle asiakkaalle koko summan tai osan siitä. Palautus voi tulla kysymykseen jos esim. koko tilausta ei saada toimitettua, ostoksen lopullinen hinta ei ole tiedossa kaupantekohetkellä tai ostaja palauttaa tuotteen postimyyntisäännösten mukaisesti. 6.2 Rajoitukset Palautuksella on seuraavat rajoitukset: palautuksen suuruus voi olla korkeintaan alkuperäisen maksun suuruinen palautuksen voi tehdä vain sille tilille mistä alkuperäinen maksu on tullut tehtyä maksua kohden voi tehdä vain yhden palautuksen palautus tulee tehdä viiden (5) viikon kuluessa alkuperäisestä maksusta 6.3 E-maksun palautuksen käyttö kauppiaan palvelussa Myyjä muodostaa palautuspyynnön, jossa on mm. myyjän tunnus, maksun tunnus tai viite ja palautettava määrä ja maksun valuutta joka on suojattu tunnistamista ja muuntamattomuutta varten MAC-tarkisteella. Palautuspyyntö lähetetään pankin palvelimelle http-lomakkeena salattua SSLyhteyttä käyttäen ja pankin palvelin vastaa samoin. astaus on muotoiltu siten, että kauppiaan palvelin voi käsitellä vastauksen ohjelmallisesti. 6.4 E-maksun palautuksen tiedot ja muoto E-maksun palautus on form-muodossa ja siinä on oltava seuraavat tiedot: Form action https://solo3.nordea.fi/cgi-bin/solopm09 Form method Post Marraskuu 2006 16
Kenttä Tieto Tiedon nimi Arvo Sisältö P/ 1. Palautuksen versio SOLOPMT_ERSION 0001 AN 4 P 2. Palautuspyynnön aika SOLOPMT_TIMESTMP muodossa KKPPHHMMSSnnnn, missä nnnn on tarvittaessa järjestysnumero 3. Myyjän tunnus SOLOPMT_RC_ID Kauppiaan tunnus N 18 AN 15 P P 4. Maksun kieli SOLOPMT_LANGUAGE 1= suomi 2= ruotsi 3= englanti 5. astauksen tyyppi SOLOPMT_RESPTYPE "html" => astaus palautetaan htmlmuodossa "xml" => astaus palautetaan xmlmuodossa 6. astauksen lisätiedot SOLOPMT_RESPDATA html: Jos vastaukseen halutaan mukaan form-tietoryhmä, tässä ilmoitetaan ko. form-tietoryhmän action osoite täydellisenä. Jos tyhjä, formtietoryhmää ei liitetä vastaukseen. xml: Jos xml-muotoisen vastauksen mime-tyypiksi halutaan joku muu kuin "text/html" se kerrotaan tässä kentässä. 7. Ohjelmamuotoisten tietojen näyttäminen 8. Alkupäisen ts. palautettavan e- maksun yksilöivä tunnus (joko stamp tai ref oltava) 9. Alkuperäisen ts. palautettavan e- maksun yksilöivä viite (joko stamp tai ref oltava) SOLOPMT_RESPDETL SOLOPMT_STAMP " " Ei 'ohjelmamuotoisia' tietoja näkyvään html:ään "Y" 'Ohjelmamuotoiset' tiedot näytetään Kauppiaan antama alkuperäisen maksun tunnus N 1 A 4 AN 20 A 1 N 20 SOLOPMT_REF Standardiviite AN 20 10. Palautettava määrä SOLOPMT_AMOUNT esim. 990,00 Huomioi, että määrä ei saa ylittää alkuperäisen e-maksun määrää 11. aluuttakoodi SOLOPMT_CUR EUR aluuttakoodin arvo lasketaan mukaan palautuksen MAC-kenttään määräkentän jälkeen. AN 19 12. Palautuksen viite SOLOPMT_REF2 Maksun palautuksen viite AN 20 13. Käytössä olevan avaimen versio SOLOPMT_KEYERS esim. 0001 N 4 P 14. Käytetty algoritmi SOLOPMT_ALG "01" N 2 P 15. Palautuksen tarkiste SOLOPMT_MAC Palautuksen tarkiste SOLOPMT_MAC muodostetaan palautuspyynnössä mukana olevista tiedoista. Jos jokin kenttä jää pois (SOLOPMT_REF), jää mac-laskennasta pois ko. kenttä ja &- merkki. A 3 AN 32 Esimerkki MAC-laskennasta: 0001&199911161015500001&12345678&1&html&http://158.233.9.9/hsmok.htm&Y&501&5&EUR &0001&01&LEHTI& Laskennan tulos: 0CF5D017C23FB3DF0F7C1F1E341DA127 P P P Marraskuu 2006 17
6.5 Palautuspyynnön vastauksen tiedot astauksella on seuraavat tiedot: Kenttä Tieto Tiedon nimi Arvo Sisältö ja pituus 1. Palautuksen versio SOLOPMT_ERSION 0001 AN 4 2. Palautuspyynnön aika SOLOPMT_TIMESTMP muodossa KKPPHHMMSSnnnn, missä nnnn on tarvittaessa järjestysnumero N 18 3. Myyjän tunnus SOLOPMT_RC_ID Kauppiaan tunnus AN 15 4. Paluutieto SOLOPMT_RESPCODE "OK" Palautus onnistunut "Notfound" Jos maksua ei löytynyt "Error" Palautusta ei voitu suorittaa 5. Alkuperäisen maksun tunnus SOLOPMT_STAMP Kauppiaan antama alkuperäisen maksun tunnus 6. Kauppiaan tilinumero SOLOPMT_RC_ACCOUNT Tili, jolta palautus tehdään AN 15 7. Palautuksen viite SOLOPMT_REF Standardiviite AN 20 8. Palautuksen SOLOPMT_DATE EXPRESS tai KKPP AN 10 maksupäivä 9. Palautuksen määrä SOLOPMT_AMOUNT ESIM. 0000000009900 (=99 EUR) AN 13 10. Palautuksen arkistotunnus A 8 N 20 SOLOPMT_PAID Palautusmaksun arkistointitunnus AN 16 11. Maksun tila SOLOPMT_STATUS Prod=tuotantomaksu, Test=testimaksu A 4 12. Avaimen versio SOLOPMT_KEYERS Kuten e-maksussa, esim. 0001 N 4 13. Käytetty algoritmi SOLOPMT_ALG 01 N 2 14. Palautuksen tarkiste SOLOPMT_MAC Palautuksen tarkiste SOLOPMT_MAC muodostetaan palautuspyynnössä mukana olevista tiedoista. Jos jokin kenttä jää pois (SOLOPMT_REF) niin mac-laskennasta jää pois ko. kenttä ja &- merkki. AN 32 6.6 astauksen muoto eri tilanteissa Jos palautus ei mene MAC- ym. turvatarkastuksista läpi, vastauksena tulee http-virheilmoitus, response status 404, http error 404 url not found. Jos samaa e-maksua yritetään palauttaa uudestaan, tulee ilmoitus Maksu on jo pankissa. Jos palautettava määrä ylittää alkuperäisen maksun määrän, tulee ilmoitus Maksun määrä ylittää sallitun rajan Jos maksua ei löydy tai samalla viitteellä tehty useampi maksu, maksun tietoja ei palauteta. Ohjelmamuotoisessa osassa näytetään kyselyn tiedot (pyydettäessä). Html-muotoiset vastaukset (SOLOPMT_RESPTYPE="html"): Pelkkä html-vastaus: SOLOPMT_RESPDATA ei mukana. Pelkkä maksupohja: SOLO_RESPDETL ei mukana. Maksupohja ja ohjelmamuotoiset tiedot: SOLO_RESPDETL="Y". Painike ("Rekisteröi") maksun tietojen välitykseen ohjelmallisesti: SOLO_RESPDATA mukana. Marraskuu 2006 18
7 Neuvonta ja tuki Pulmatilanteissa auttaa Yritysten Solo-neuvonta, joka palvelee kaikkina pankkipäivinä. Myyjän tunnuksen ilmoittaminen nopeuttaa asiointia. Yritysasiakkaiden Solo-tuki Solo-neuvonta suomeksi 0200 67210 0,11 euroa / min + pvm/ mpm, pankkipäivinä 8-18, lyhyinä pankkipäivinä 8-14 ruotsiksi 0200 67220 0,11 euroa/ min + pvm/ mpm, pankkipäivinä 9-16.30, lyhyinä pankkipäivinä 9-14 englanniksi 0200 67230 0,11 euroa/ min + pvm/ mpm, pankkipäivinä 9-18, lyhyinä pankkipäivinä 9-14 Automaattinen Solo-neuvonta 0100 6730 24/7, pvm/ mpm. suomi, ruotsi, englanti Marraskuu 2006 19