Paytrail

Paytrailin ominaisuudet ja dokumentaatio

Paytrailin ominaisuudet ja dokumentaatio

Kokosimme tälle sivulle tärkeimpiä ohjeita maksupalvelumme tehokkaaseen käyttöön. 

Aihetta klikkaamalla pääset suoraan etsimääsi osioon:

1. Palvelun käyttöönotto 
2. Maksutapojen valinta
3. Palvelun toteutus
4. Maksutavan valintasivun ohitus

5. Palautukset
6. Tilitykset
7. Reaaliaikainen maksukuittaus
8. Kirjanpito
9. Testitunnukset
10. Saatavuus
11. Kauppiaspaneeli
12. In-app maksaminen

Jos palvelustamme herää jotain kysyttävää, myyntimme auttaa sinua mielellään: 020 718 1824, myynti@paytrail.com.

 

1. Palvelun käyttöönotto

Vaiheittainen käyttöönotto:

  1. Tilaa palvelu osoitteessa: https://ssl.paytrail.com/register/
  2. Asiakaspalvelumme on teihin yhteydessä.
  3. Saatte Kauppiaspaneelin tunnukset sähköpostitse ja kauppiasvarmenteen, kun yrityksen nimenkirjoitusoikeudellinen henkilö allekirjoittaa sopimuksen sähköisesti verkkopankkitunnuksillaan.
  4. Kauppiastunnuksella ja kauppiasvarmenteella aktivoidaan palvelu.
  5. Palvelu valmis käytettäväksi.

Sopimus: toistaiseksi voimassa oleva yhden kalenterikuukauden irtisanomisajalla.

 

2. Maksutapojen valinta

Logopalkki

Suosittelemme kaikkien maksutapojen aktivoimista, jolloin asiakas löytää aina haluamansa tutun maksuvaihtoehdon.

Kaikkien kotimaisten pankkien verkkomaksupainikkeet: Nordea, Osuuspankki, Danske Bank, Säästöpankki, Oma Säästöpankki, POP Pankki, Aktia, Handelsbanken, Ålandsbanken ja S-Pankki.

Lasku- ja osamaksupalvelut: Collector ja Jousto.

Korttimaksaminen: Visa, Visa Electron, Mastercard, American Express, Eurocard ja Diners Club.

Mobiilimaksaminen: MobilePay.

 

3. Palvelun toteutus

Verkkokauppa-alustaan liittyvät moduulit

Palvelumme toteutus riippuu myös käyttämästänne verkkokauppa-alustasta. Tietyt verkkokauppa-alustat vaativat moduulin, jonka avulla voit käyttää maksupalvelumme. Kyseisiä alustoja ovat esimerkiksi WooCommerceMagento ja Prestahop. Lisätietoa yhteensopivista alustoista löydät verkkosivuiltamme.

Avoimen lähdekoodin kirjasto E2-rajapinnalle

Olemme julkaisseet avoimen lähdekoodin kirjaston, jonka avulla voit tehdä helposti maksuja E2-rajapintaamme.

Kirjaston käyttö vaatii PHP 7.2 -version tai uudemman ja se löytyy GitHub ja Packagist -palveluista. Tarkemmat käyttöohjeet löytyvät edellämainituista linkeistä.

Jos kirjastomme herättää kysymyksiä, ota meihin yhteyttä. Voit myös osallistua kirjaston jatkokehittämiseen yhdessä kehittäjiemme kanssa GitHubissa.

E2-rajapinta - ominaisuudet laajasti käyttöön

E2-rajapintaversio on Paytrailin tuorein rajapinta. Sen kautta saat maksupalvelumme ominaisuudet käyttöön mahdollisimman laajasti. 

E2 mahdollistaa seuraavat ominaisuudet:

  • Suosittu lasku- ja osamaksutapa Collector Bank 
  • Tilin omistajan tiedot välittyvät verkkopankkimaksamisessa – Kauppiaspaneelista näet kenen verkkopankista maksu on tehty
  • Notify-toteutus
  • Maksun aikakatkaisu 
  • Toteutus voi olla laaja, tai halutessasi hyvin suppea. Minimissään tarvitset tilausnumeron ja tilauksen summan
  • Sales Rescue: ostoskorin pelastaja, jos maksu jää jostain syystä kesken

E2 dokumentaatiossa ››

Kauppiasrajapinta - Merchant API

Merchant API dokumentaatiossa ›› 

Kauppiasrajapintaa kannattaa hyödyntää silloin, kun halutaan etäkäyttää Paytrailin Kauppiaspaneelia. Kauppiasrajapinta mahdollistaa maksupalvelun ominaisuuksien toteuttamisen suoraan kauppiaan omiin järjestelmiin. Alla on kuvattu eri ominaisuuksia, joita voidaan toteuttaa Kauppiasrajapinnan avulla. Rajapinnan avulla automatisoidaan tiedon kulkua ja helpotetaan verkkokauppiaan ja kirjanpitäjän arkea.

Palautukset

Palautukset voidaan käynnistää kaikilla maksutavoilla joko Kauppiaspaneelista tai Merchant APIn kautta. 

Merchant APIn kautta voit toteuttaa seuraavia toimia: 

  • Palautuksen käynnistys 
  • Palautuksen tilakysely
  • Palautuksen peruutus

Tilitykset 

Esimerkkikutsut Merchant APIin liittyen voit katsoa dokumentaatiosta

Maksuaineisto

  • Yksittäisen maksun tietojen kyselyt 
  • Maksuaineiston haku konekielisenä

Merchant APIn testidata

Esimerkki ››

 

4. Maksutavan valintasivun ohitus

Maksutavan valintasivun ohitus

Perinteisesti asiakas siirtyy yhteystietojen täyttämisen ja tilauksen vahvistamisen jälkeen erilliselle maksutavan valintasivulle, jossa hän valitsee maksutapansa. Valintasivun ohituksella maksutavat tuodaan suoraan verkkokauppaan näkyville, esimerkiksi ostoskoriin. 

Ohitusta käyttämällä myös maksuprosessi pysyy täysin kaupan brändin ja ilmeen näköisenä, ilman että Paytrail tulee näkyviin. 

Ohituksen avulla verkkokauppa voi päättää miten maksutavat toteutetaan: miten maksutavat esitetään, minkälaisilla logoilla, missä järjestyksessä maksutavat ovat ja halutaanko jotain ottaa pois käytöstä.

Ohitus aktivoidaan päälle Paytrailin asiakaspalvelun toimesta.

Ohitus dokumentaatiossa ››

Toteutus yleisimpiin alustoihin

Maksusivun ohitus on toteutettu lähes kaikkiin verkkokauppa-alustoihin. Alta löydät linkit käytetyimpien alustojen moduuleihin.

WooCommerce
Magento
MyCashflow
Vilkas
CloverShop
Oscar Software

Jos et ole löydä moduulia omaan alustaasi, tai sinulla on kysyttävää ohituksen toteutuksesta, ota yhteyttä ja autamme mielellämme:  
020 718 1824, myynti@paytrail.com.

Esimerkki toteutuksesta

Alla esimerkkinä Pentikin verkkokauppaan tehty toteutus. Voit tutustua ohituksen toteutukseen myös demokaupassamme.


Pentik-Ohitus-2019

5. Palautukset

Palautukset hoituvat kauttamme kätevästi kaikilla maksutavoilla. Maksu palautetaan sille maksutavalle, jolla maksu alunperin tehtiin. Alta löydät prosessikaaviot palautuksista eri maksutapoihin liittyen.

Verkkopankkimaksut - malli 1

Palautukset-uusi-malli


Verkkopankkimaksut - malli 2

Palautukset-vanha-malli


Palautusprosessi verkkopankkimaksuissa


A) Malli 1

Palautus-pankki-API



B) Malli 2

Palautus-pankki-IBAN


Palautusprosessi korttimaksuissa


Palautus-kortti-1


Palautusprosessi Collector-maksussa


Palautus-Collector-1

 
Mikäli kuluttaja on jo ehtinyt maksaa osan tai koko summan Collectorille, Collector palauttaa kyseisen summan kuluttajalle. 

Palautukset Merchant APIn kautta

Palautukset voidaan käynnistää kaikilla maksutavoilla Merchant APIn kautta. 

Merchant APIn kautta voit toteuttaa seuraavia toimia: 

  • Palautuksen käynnistys 
  • Palautuksen tilakysely
  • Palautuksen peruutus

Merchant APIn palautukset dokumentaatiossa ››

 

6. Tilitykset

Tilitysviiveet

Maksutapa Viive
Pankkimaksut 1 pankkipäivä
Korttimaksut 5 pankkipäivää
Collector 3 pankkipäivää (markkinoiden lyhyin)

 

Tilitysmallit

1. Nettotilitysmalli

Nettotilitysmalli on Paytrailin oletustilitysmalli. Nettotilitysmallissa maksuliikennekulut vähennetään automaattisesti koontitilityksistä. Koontitilityssykli on valittavissa päivittäin, viikoittain tai kuukausittain. Suosittelemme päivittäistä mallia, silloin pääoman kierto on nopeaa ja maksujen palautukset toimivast parhaiten.

Soveltuu esimerkiksi: Paytrailin oletustilitysmalli, soveltuu laajasti erilaisiin verkkokaupparatkaisuihin.

2. Bruttotilitysmalli

Bruttotilitysmalli sopii liiketoimintaasi, kun haluat saada tilitykset ilman, että niistä on vähennetty maksuliikennekuluja. Maksuliikennekulut laskutetaan erillisellä laskulla sopimuksen mukaan.

Soveltuu esimerkiksi: isoille verkkokaupoille ja silloin, kun halutaan käsitellä kokonaisia summia esimerkiksi rahastotuotteet.

3. Yksittäistilitysmalli

Yksittäistilitymalli palvelee toimintaasi, kun haluat yksittäisen tilityksen jokaisesta maksutapahtumasta tilillesi. Tällöin verkkokaupan viitenumero seuraa ainaa tiliotteelle asti, jolloin maksujen kohdentaminen on helpompaa. Huomioithan tällöin, että maksujen palautukset eivät ole mahdollisia Paytrailin palvelun kautta.

Soveltuu esimerkiksi: jos kirjanpitojärjestelmä edellyttää tilauskohtaisen viitteen kuljettamista koko järjestelmän läpi. 

Tilitysrytmit

Tilitysmalli pankkipäivän mukaisesti: klo 08-16 T+1 (oletustilitysmalli)

Tässä tilitysmallissa tilitykseen yhdistetään kaikki maksut (maksutavasta riippumatta), joilla on sama tilityspäivä. Tilityspäivän laskenta tehdään pankkipäivän sisällä, eli klo 08-16 arkipäivisin. Maksutavan tilitysviive lisätään tähän, eli esimerkiksi maanantaina klo 12:00 tehty pankkimaksu maksetaan seuraavana päivänä. Maksun siirtyessä pankkipäivän ulkopuolelle, eli esimerkiksi maanantaina klo 16:40 tehty maksu siirtyy seuraavalle päivälle, eli maksetaan keskiviikkona.

Maksun tilitys pankkipäivä-mallissa:
Maksu tehty pankkipäivän sisällä (08-16): maksu tilitetään tilitysviiveen mukaisesti
Maksu tehty pankkipäivän ulkopuolella (16-08): maksun tilitysviiveeseen lisätään yksi pankkipäivä 

Tilitysmalli vuorokauden mukaisesti: klo 00-24 T+2

Tässä tilitysmallissa tilitykseen yhdistetään saman vuorokauden aikana tehdyt maksut, joilla on sama tilitysviive. Tilitysmalli on suunniteltu käyttötapauksiin, joissa maksuja halutaan käsitellä vuorokausikohtaisesti. Pankkipäivän sulkeutuessa normaalisti klo 16 joudutaan tässä tilitysmallissa tilitysviiveeseen lisäämään yksi pankkipäivä, eli maksun tilitysviive on aina yhden pankkipäivän normaalia pidempi. Kaikkia saman vuorokauden aikana tehtyjä maksuja ei kuitenkaan yhdistetä samaan tilitykseen, jotta esimerkiksi pankkimaksut saadaan maksettua nopeammin (ei tarvitse odottaa korttimaksujen viiden päivän viivettä).

Maksun tilitys vuorokausi-mallissa:
Maksu tehty maanantaina (00-24), maksun tilitysviiveeseen lisätään yksi pankkipäivä, eli esimerkiksi pankkimaksu maksetaan keskiviikkona, korttimaksu seuraavan viikon maanantaina.

Tilityksen viitenumeron muodostuminen

Tilityksen viitenumero muodostuu seuraavalla tavalla: pankin id, jonne tilitetään + inkrementaalinen numero (yleensä 1) + kauppiastunnus + vuosi + kuukausi + päivä (kaikki kahdella numerolla) + tarkiste. Eli jos tilitetään OP:n tilille (OP:n id = 2), kauppiastunnus on 12345, ja päivämäärä 28.6.2018 niin numero muodostuu: 2, 1, 12345, 180628, ja tarkistenumero 5, eli näillä tiedoilla viitenumero olisi: 2112 34518 06285.

Kustomoidaksesi tilitysviitettä, olethan yhteydessä asiakaspalveluumme.

Esimerkki tilitysaineistosta

Esimerkki ››

 

7. Reaaliaikainen maksukuittaus 

Reaaliaikainen maksukuittaus

Reaaliaikainen maksukuittausPaytrailin järjestelmä välittää tiedon jokaisesta onnistuneesta pankkimaksusta niin verkkokauppaan kuin kuluttajalle lähes reaaliaikaisesti.

Ominaisuus poistaa yhden verkkomaksamiseen liittyvän kiusallisen ongelman. Joissain tilanteissa käy niin, että kuluttaja ei palaa takaisin verkkokauppaan maksamisen jälkeen. Tämä voi johtua esimerkiksi siitä, että kuluttajan verkkoyhteys on katkennut tai hän on sulkenut verkkoselaimen ollessaan vielä verkkopankissa. Tällöin tieto maksun tilasta on jäänyt keskeneräiseksi ja se on saatu vahvistettua vasta jälkikäteen.

Jatkossa uuden ominaisuuden myötä saamme myös näissä tilanteissa tiedon maksun onnistumisesta käytännössä heti. Pankista riippuen tiedon saapuminen on voinut aiemmin kestää seuraavaan pankkipäivään asti.

Reaaliaikainen-maksukuittaus

Mitä hyötyä ominaisuudesta on?

  • Epätietoisuus maksun läpimenosta poistuu kaikkien osapuolten kohdalta - aiheettomat tuplamaksut poistuvat.
  • Verkkokaupan asiakaspalvelun kuormitus pienenee - vähemmän yhteydenottoja asiakkailta maksujen selvittelyyn liittyen.
  • Varastosaldot pysyvät jatkossa ajan tasalla maksujen osalta.
  • Tilitysten täsmäyttäminen helpottuu - epäselvät maksut poistuvat.
  • Tilitykset nopeutuvat - reaaliaikainen kuittaus vahvistaa maksun onnistumisen ja kiinnittää ne heti seuraavaan tilitykseen.

Uudesta ominaisuudesta on hyötyä erityisesti sellaisille verkkokaupoille, missä on selkeitä myyntipiikkejä (kuten lipunmyynti) tai jos yritys myy uniikkeja tuotteita. Ominaisuus kattaa kaikki muut suomalaiset pankit, paitsi Ålandsbankenin, jolla ei tällaista toiminnallisuutta ole saatavilla.

Perinteinen malli

Perinteisessä mallissa tieto onnistuneesta pankkimaksusta saattoi tulla vasta pankin aineiston mukana, pisimmillään usean päivän päästä maksusta. 

Reaaliaikainen-maksukuittaus-vanha-malli

Uusi malli

Uudessa mallissa Paytrail muodostaa yhteyden pankkiin jo asiakkaan siirtyessä maksamaan maksuaan. Kuittauksen viive voi pienentyä parhaimmillaan useasta vuorokaudesta 20 sekuntiin.

Reaaliaikainen-maksukuittaus-uusi-malli

 

8. Kirjanpito

Maksujen kohdentaminen

Järjestelmäämme tuodaan maksun yhteydessä tilausnumero, joiden avulla voidaan yksilöidä maksut. Tarjoamme Kauppiasrajapinnan, jonka avulla voidaan hakea maksujen tietoja (esimerkiksi taloushallinto tai toiminnanohjaus) ennen maksujen tilitystä (maksuaineisto) tai tilityksen jälkeen (tilitysaineisto). Maksuaineisto on haettavissa ennen tilitysten tekoa, eli sen kautta voidaan hakea onnistuneet maksut reaaliajassa. 

Kauppiasrajapinta - Merchant API 

Merchant API:n avulla pystytään hakemaan tilitystietoja.

Tilitämme kaikki maksut päiväkohtaisesti yhtenä könttäsummana järjestelmämme määrittelemällä viitenumerolla. Maksujen tilitysviiveistä voit lukea tarkemmin kohdasta 5. Maksuista ja tilityksistä on järjestelmämme kautta noudettavissa kirjanpitoraportti, jonka avulla onnistuu maksutapahtumien kohdentaminen. Raportit on noudettavissa csv- ja pdf-tiedostoina.

Kauppiasrajapinta palauttaa maksun tiedoissa tilausnumeron ja maksun tunnisteen, joita voi käyttää täsmäyttämiseen. Tilausnumero on maksun luonnin yhteydessä Paytrailin järjestelmään tuotu tieto (esimerkiksi verkkokaupasta) ja maksun tunniste on maksun paluun yhteydessä palautettu Paytrailin luoma yksilöivä tunniste. Maksun tunnisteella on mahdollista hakea maksun tietoja reaaliaikaisesti heti verkkokaupan vastaanotettua maksutunnisteen (onnistuneen tai perutun maksun paluun yhteydessä).

Kauppiasrajapinnan testidata: esimerkki ››

Esimerkki kirjanpitoraportista

Esimerkki ›› 

Esimerkki tilitysaineistosta

Esimerkki ››

 

9. Testitunnukset

Testitunnuksilla voit turvallisesti testata maksamista ilman, että rahaa liikkuu. Testikauppiaalle tulleita maksuja ei välitetä eteenpäin, mutta näet kuinka palvelu toimii kuluttajan näkökulmasta. Testaamisen avulla voit varmistaa, että maksupalvelu on asennettu verkkokauppaan oikein.

Kauppiastunnus ja -varmenne syötetään verkkokauppa-alustasta löytyviin asetuksiin, jotka usein löytyvät kohdasta Maksutavat. Jos et ole varma mihin tunnukset syötetään, ota yhteyttä tekniseen toteuttajaasi. 

Löydät testitunnukset dokumentaatiosta ››

 

10. Saatavuus

Tutkitusti tärkein ominaisuus verkkomaksupalvelussa on sen saatavuus, eli maksupalvelun tulee toimia mahdollisimman luotettavasti ja koko ajan. Tieto palvelumme saatavuudesta löytyy reaaliaikaisesti Saatavuus-sivustoltamme: https://status.paytrail.com

Voit tilata Saatavuus-sivumme ilmoitukset sähköpostiisi, jolloin saat heti tiedon mahdollisista ongelmista, sekä tulevista huoltotoimenpiteistä.

Saatavuus

 

11. Kauppiaspaneeli

Kauppiaspaneeli on monipuolinen maksuliikenteen seuranta- ja analysointityökalu. Kauppiaspaneelissa voi seurata verkkokaupan maksuja ja hakea tilitysraportin kirjanpitoa varten. Sieltä voit myös palauttaa maksuja ja olla yhteydessä Paytrailin asiakaspalveluun.

Kauppiaspaneelin etusivulla Uutiset-osiossa tiedotamme ajankohtaisista asioista ja kerromme palvelumme tulevista huoltokatkoista. Etusivulta pääsee suoraan lukemattomiin viesteihin, jos olet ollut Kauppiaspaneelin kautta yhteydessä asiakaspalveluumme. Kauppiaspaneelin etusivulta löytyy myös tilastoja verkkokaupan maksuliikenteestä sekä uusimmat maksut ja tilitykset. 

Yksittäisen maksun tietoja voi hakea esimerkiksi tilausnumerolla, tuotteen nimellä, tilaajan tiedoilla, tai maksun päivämäärällä ja summalla. Maksut-välilehdellä näkyy tieto myös keskeytyneistä maksuista, jos asiakas on tullut maksuvalintasivulle saakka. Syytä maksun keskeytymiselle/epäonnistumiselle voi tarkastella maksun historia-välilehdeltä.

Kauppiaspaneeliin voi kirjautua täältä: https://dashboard.paytrail.com 

Kauppiaspaneeli-2019

 

12. In-app maksaminen

Saat Netsin kautta ohjelmistokehityspaketin mobiilisovelluksiin, joka tekee maksamisesta niiden sisällä helpompaa kuin koskaan. Hyvän digitaalisen kuluttajakokemuksen tarjoaminen on ratkaisevaa kaikille kauppiaille.

In-app-maksaminen

Kitkatonta ja sujuvaa maksamiskokemusta tukevat muun muassa monipuoliset maksutapavaihtoehdot, biometristen tunnisteiden tuki ja maksukorttien skannausmahdollisuus mobiililaitteen kameralla.

In-app maksamisen helppo toteutus

Maksamisen toteutus mobiilisovelluksiin on nyt yksinkertaista ja helppoa. Saat hyvät ohjeet ja tukea maksamisen sujuvaan toteutukseen.

Integrointi iOS- ja Android-sovelluksiin on yksinkertaista ja nopeaa. Käyttöönotto edellyttää Netsin Netaxept-taustajärjestelmän integraatiota ja sopimusta.

Dokumentaatio ja ohjelmistokehityspaketit ovat saatavilla:
https://github.com/Nets-mobile-acceptance

Lue lisää

Voimmeko auttaa?

Soita meille, jos tarvitset apua palvelun käyttöönotossa. Autamme mielellämme!

020 718 1824
myynti@paytrail.com