Maksulinkki

Owned by Viivi Ahlqvist
Last updated: Sept 02, 2024
2 min read

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_Extranet.PNG

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.

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.

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ä.

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) 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ä.

Hae

Hae-välilehdellä voit hakea luotuja maksulinkkejä haluamaltasi aikaväliltä ja haluamillasi hakuehdoilla:

Maksulinkki_Extranet_hae.PNG

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. Se tilitetään ja palkkiot veloitetaan palvelulle määritellyn mallin ja hintojen mukaisesti.

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öönotto vaatii:

  • 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

  1. Verkkokauppa välittää tilauksen ja maksun tiedot Svea Paymentsille server-to-server tyyppisesti:

    1. Kauppa kutsuu Svean rajapintaa NewPaymentExtended.pmt:

      1. → Pyyntö: Create Payment | Request (S2S HTTP POST), S2S basic auth.

      2. ← Vastaus: XML, jonka sisällä maksulinkki pmt_paymenturl

  2. Kauppa vastaanottaa ja tallentaa vastaussanomasta maksulinkin.

  3. Kauppa toimittaa maksulinkin ostajalle haluamallaan tavalla.

    1. 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:

    2. Mikäli maksutapa on välitetty Svealle esivalittuna, ohjataan ostaja suorittamaan maksu loppuun ko. maksutavan prosessin mukaisesti.

  4. Ostaja suorittaa maksun.

  5. Ostaja palaa kaupan OK-paluuosoitteeseen selaimella tai Svean palvelin tekee callback-kutsun kauppaan.

  6. 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:

Maksulinkin voimassaolo

Maksulinkille voi asettaa voimassaoloajan joko Create Payment -kutsun pmt_paymenturlexptime-parametrissa tai jälkikäteen erillisellä API-kutsulla, lue lisää täältä: Payment URL and URL Expiration.

Maksun vahvistuksen callback

  1. Ostaja on maksanut maksun. Ostaja on saattanut palata selaimella kauppaan tai sitten ei.

  2. Maksun vahvistuksen saamisen jälkeen Svea tekee kaupan OK-paluuosoitteeseen server-to-server-kutsun

    1. Tulee kahden (2) minuutin viiveellä suhteessa siihen kun maksu on vahvistettu Svealle ja ostaja on mahdollisesti ohjattu kauppaan

  3. Kauppa tarkistaa callback-kutsun saatuaan oliko tilauksen maksu jo aiemmin vahvistettu. Jos ei ollut, voidaan se nyt vahvistaa Svean tilan kyselyn kautta:

    1. Kauppa varmistaa tilan kyselyllä Svealta että maksu oli oikeasti vahvistettu

      1. → Pyyntö: Request and Response | Request (S2S HTTP POST)

      2. ← Vastaus: Tieto oliko maksu vahvistettu. Payment and Delivery status code values

    2. Kauppa merkitsee tilauksen maksetuksi jos kysely sen vahvisti.

Maksun tilan kysely

  • Yleisohjeita: Payment Status Query

  • 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.

  1. → Pyyntö: Request and Response | Request (S2S HTTP POST)

  2. ← Vastaus: Request and Response | Response (XML)

    1. Maksettu: 20,30,40,91,92,93,95,98 (Mitä tahansa 20 .. 98).

    2. EI maksettu: 00,01,10,11,15,19  (Mitä tahansa 00 ... 19)

    3. 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ä.