Maksulinkki
Svea Paymentsin maksulinkin voi luoda Extranet-palvelussa tai integroimalla kaupan omaan järjestelmään. Alla on kuvattu molemmat tavat.
Sivun sisältö:
Maksulinkin luominen Extranetissä
Kun palvelulle on aktivoitu maksulinkki-toiminnallisuus, voi maksulinkin luoda Extranetin Maksulinkki-välilehdellä.
Maksulinkki on suunniteltu niin, että se olisi nopea ja kätevä luoda, joten pakollisia tietoja on vain muutama - “Valinnaiset” -painikkeesta avatuu lisää kenttiä, joihin voit halutessasi syöttää lisätietoja.
Extranetin maksulinkki on luotu käytettäväksi ilman integraatiota, joten se on helppokäyttöinen mutta maksulinkin kautta luodut tilaukset on tarvittaessa lisättävä manuaalisesti kaupan omiin järjestelmiin.
Maksajan tiedot
Pakollisia tietoja ovat nimi ja sähköpostiosoite. Jos maksulinkki lähetetään sähköpostiin, menee se tässä kohdassa ilmoitettuun osoitteeseen.
Valinnaisissa tiedoissa voit täyttää maksajan osoitteen ja toimitusosoitteen, sekä y-tunnuksen. Jos syötät tässä kohdassa y-tunnuksen, se näkyy esitäytettynä maksulomakkeella, mikäli maksaja valitsee maksutavaksi yrityslaskun. Jos ostaja on yritys ja syötät maksajan tietoihin y-tunnuksen, niin lisääthän myös yrityksen osoitteen ja toimitusosoitteen. Tietoja voidaan käyttää osto-oikeuden tarkistuksessa.
Tilauksen tiedot
Tässä kohdassa voit lisätä yhden tai useamman tilausrivin, niiden määrät, summat ja ALV-kannan. Vähintään yksi tilausrivi on pakollinen.
Valinnaisissa tiedoissa voit määritellä tilausnumeron ja/tai viitenumeron. Tilausnumero on max. 50-merkkinen arvo, joka voi sisältää kirjaimia ja numeroita. Tilausnumero näkyy raporteilla ja sillä voi mm. hakea maksutapahtumaa myöhemmin Extranetistä. Viitenumeron tulee olla 4-20 merkkiä validi suomalainen viitenumero. Se näkyy myös raporteilla ja sitä voidaan käyttää tapahtumahaussa, lisäksi jos palvelussa on käytössä tapahtumakohtaiset tilitykset, se toimii tilitysviitteenä. Jos et määrittele tilaus- tai viitenumeroa, niin järjestelmämme generoi ne puolestasi ja ne näkyvät maksulinkillä ja maksutapahtumalla sen luomisen jälkeen.
Maksulinkin tiedot
Oletuksena maksulinkki on voimassa 7 päivää, mutta voit tässä kohdassa muuttaa voimassaoloaikaa. Maksulinkki voi maksimissaan olla voimassa 3 kuukautta. Voit myös mitätöidä maksulinkin sen luomisen jälkeen, riippumatta tässä kohdassa määritellystä voimassaoloajasta.
Näet tässä myös maksulinkin tunnisteen - tämä on tunniste, jonka avulla asiakkaasi voi varmistua maksulinkin aitoudesta. Tunniste näkyy sinulle maksulinkillä Extranetissä, ja asiakkaallesi hänen saamassaan maksulinkki-viestissä. Voit käyttää oletustunnistetta tai luoda tässä oman.
Maksulinkki voidaan lähettää sähköpostitse tai tekstiviestinä, tai voit luoda siitä QR-koodin. Sähköposti tai tekstiviesti ovat käteviä erityisesti kun ostaja ei ole paikan päällä, QR-koodilla taas ostaja voi maksaa heti, jos on myyjän kanssa kasvotusten. Tekstiviesti voidaan lähettää suomalaiseen puhelinnnumeroon.
Valinnaisissa tiedoissa voit valita maksulinkin kielen (suomi, ruotsi, englanti) jolloin maksusivu näkyy oletuksena valitulla kielellä ja kirjoittaa halutessasi maksajalle maksusivulla näkyvän viestin.
Tarkista tiedot ja luo linkki
Lopuksi voit viimeisessä kohdassa tarkistaa linkin tiedot ja luoda sen. Näet tässä myös maksulinkille mahdollisesti määritetyt laskutuslisät. Voit muokata laskutuslisiä maksulinkin Asetukset-välilehdellä. Laskutuslisä koskee vain laskua ja yrityslaskua.
Hae
Hae-välilehdellä voit hakea luotuja maksulinkkejä haluamaltasi aikaväliltä ja haluamillasi hakuehdoilla:
Ennen linkin vanhenemista sitä pääsee hakutulosten kautta klikkaamalla muokkaamaan, sen voi mitätöidä tai kopioida uudeksi maksulinkiksi. Jos linkki on vanhentunut, sitä ei voi muokata tai mitätöidä, mutta sen voi edelleen kopioida uuden maksulinkin pohjaksi.
Kun maksulinkki on maksettu, se löytyy myös Tapahtumat-välilehdeltä muiden tapahtumien joukosta.
Asetukset
Jos maksulinkkiin kytketyssä palvelussa on lasku ja/tai yrityslasku käytössä, voi maksulinkin Asetukset-välilehdellä määritellä niille laskutuslisät halutessasi.
Huomioi eritysesti kuluttajalaskun kohdalla, että laskutuslisän tulee perustua todellisiin kustannuksiin ja maksimi on 5,00 EUR.
Maksun jälkeen
Kun maksulinkin kautta luotu tilaus on maksettu, se tulee näkyviin Tapahtumat-välilehdelle ja sitä käsitellään kuin tavallista, verkkokaupan kautta maksettua tilausta. Huomioi kuitenkin, että tilaus ei tule automaattisesti näkyviin verkkokauppaan tai muihin taustajärjestelmiin.
Maksulinkin kautta maksettuja tilauksia koskevat samat asetukset kuin verkkokaupan tilauksia. Ne tilitetään ja palkkiot veloitetaan palvelulle määritellyn mallin ja hintojen mukaisesti, ja maksulinkin kautta maksetut tilaukset tulevat mukaan myös raporteille samaan tapaan kuin verkkokaupan tilaukset. Myös palautukset käsitellään kuten palvelulle on määritelty. Mikäli palvelu on konfiguroitu niin, että kauppiaan tulee käynnistää laskutus, niin se on muistettava tehdä myös maksulinkin kautta maksettujen tilausten kohdalla, ja sen voi tehdä Extranetissä.
On myös mahdollista perustaa maksulinkille oma palvelu, mikäli se halutaan konfiguroida verkkokaupan palvelusta poikkeavasti.
Maksulinkin luominen kauppiaan omassa järjestelmässä
Svea Payments palauttaa maksulinkin Create Payment -kutsun vastaussanomassa (XML). Normaalissa maksutilanteessa, jossa ostaja itse on tekemässä tilausta ja maksua, kauppa ohjaa ostajan taustalla suoraan vastaussanoman maksulinkkiin, ilman että prosessi on ostajalle näkyvä.
Käytettäessä vastaussanoman linkkiä maksulinkin tapaan, kauppa luo tilauksen Create Payment -kutsulla ilman ostajan osallistumista, ja poimii linkin Svean vastaussanomasta. Tämän jälkeen kauppa voi käyttää maksulinkkiä haluamallaan tavalla, esimerkiksi lähettää sen ostajalle sähköpostilla tai tekstiviestillä.
Linkki vie ostajan ko. palvelun maksutavan valintasivulle, jossa ostajan valittavana on palveluun aktivoidut maksutavat, tai mikäli maksusanomassa välitetään maksutapa esivalittuna, ohjataan ostaja suorittamaan maksu loppuun ko. maksutavan prosessin mukaisesti.
Maksulinkin käyttöönoton vaatimukset
Aktiivisen palvelun Svea Paymentsilla
Maksamisen rajapinnan (Create Payment) integroimisen
Kyvykkyyden käsitellä Svea Paymentsin lähettämiä callback-kutsuja
Tilan kyselyn rajapinnan (Payment Status Query) integroimisen
Toiminnallisuudet maksusanoman luomiseen, linkin poimimiseen/tallentamiseen ja sen lähettämiseen ostajalle
Prosessi
Verkkokauppa välittää tilauksen ja maksun tiedot Svea Paymentsille server-to-server tyyppisesti:
Kauppa kutsuu Svean rajapintaa NewPaymentExtended.pmt:
→ Pyyntö: https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657012476/Create+Payment#Request-(S2S-HTTP-POST), S2S basic auth.
← Vastaus: XML, jonka sisällä maksulinkki
pmt_paymenturl
Kauppa vastaanottaa ja tallentaa vastaussanomasta maksulinkin.
Kauppa toimittaa maksulinkin ostajalle haluamallaan tavalla.
Ostajalle näytetään Svea Paymentsin maksutavan valintasivu, josta ostaja valitsee haluamansa maksutavan (sivulla näytetään ne maksutavat, jotka palveluun on aktivoitu ja jotka ovat ostoksen summan perusteella valittavissa). Tai:
Mikäli maksutapa on välitetty Svealle esivalittuna, ohjataan ostaja suorittamaan maksu loppuun ko. maksutavan prosessin mukaisesti.
Ostaja suorittaa maksun.
Ostaja palaa kaupan OK-paluuosoitteeseen selaimella tai Svean palvelin tekee callback-kutsun kauppaan.
Kauppa tarkistaa OK-paluukutsun tai callback-kutsun saatuaan oliko tilauksen maksu jo aiemmin vahvistettu. Jos ei ollut, voidaan se nyt yrittää vahvistaa Svean tilan kyselyn kautta:
Kauppa varmistaa tilan kyselyllä Svealta että maksu oli oikeasti vahvistettu
← Vastaus: Tieto oliko maksu vahvistettu. https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657012617
Kauppa merkitsee tilauksen maksetuksi jos kysely sen vahvisti.
Maksulinkin voimassaolo
Maksulinkille voi asettaa voimassaoloajan joko Create Payment -kutsun pmt_paymenturlexptime-parametrissa tai jälkikäteen erillisellä API-kutsulla, lue lisää täältä: https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1719926812.
Maksun vahvistuksen callback
Ostaja on maksanut maksun. Ostaja on saattanut palata selaimella kauppaan tai sitten ei.
Maksun vahvistuksen saamisen jälkeen Svea tekee kaupan OK-paluuosoitteeseen server-to-server-kutsun
Tulee kahden (2) minuutin viiveellä suhteessa siihen kun maksu on vahvistettu Svealle ja ostaja on mahdollisesti ohjattu kauppaan
Kauppa tarkistaa callback-kutsun saatuaan oliko tilauksen maksu jo aiemmin vahvistettu. Jos ei ollut, voidaan se nyt vahvistaa Svean tilan kyselyn kautta:
Kauppa varmistaa tilan kyselyllä Svealta että maksu oli oikeasti vahvistettu
← Vastaus: Tieto oliko maksu vahvistettu. https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657012617
Kauppa merkitsee tilauksen maksetuksi jos kysely sen vahvisti.
Maksun tilan kysely
Yleisohjeita: https://sveapayments.atlassian.net/wiki/spaces/DOCS/pages/1657012569
Maksun tilan kyselyllä voi varmistaa että maksu oli todella maksettu kun ostaja palaa kaupan OK-urliin tai Svea kutsuu kaupan OK-paluuosoitetta callback-tyyppisesti.
Lisäksi tilan kyselyä voi tehdä ajastetusti. Tämä ei kuitenkaan ole suositeltavaa eikä tarpeellista mikäli kauppa tukee callbackeja Svealta.
← Vastaus: Request and Response | Response (XML)
Maksettu: 20,30,40,91,92,93,95,98 (Mitä tahansa 20 .. 98).
EI maksettu: 00,01,10,11,15,19 (Mitä tahansa 00 ... 19)
99 on kokonaan peruutettu, joten tilausta ei kannata merkitä maksetuksi vaikka se voi olla käynytkin maksettu-tilassa ennen tähän tilaan päätymistä.
Shopifyn maksulinkki
Shopifyta käyttävät kauppiaat voivat hyödyntää myös Shopifyn sisäänrakennettua maksulinkkiä. Tämän ominaisuuden käyttöönotosta tulee sopia erikseen Svean kanssa - ota yhteyttä omaan myyjääsi tai Svean tekniseen tukeen support.payments@svea.fi.
Shopifyn maksulinkkiä voidaan käyttää esim. uuden tilauksen luomiseen Shopifyssa tai tuotteiden lisäämiseksi olemassa olevaan tilaukseen.