Paytrail-liitäntä

Paytrail on maksunvälittäjä, joka mahdollistaa verkko-, kortti- ja mobiilimaksujen sekä laskun hyväksymisen verkkokaupassa maksuvälineenä. Toteuttamamme liitäntä yhdistää verkkokaupan ja Paytrail-palvelun luotettavasti ja turvallisesti toisiinsa.

Toimintaperiaate

Ensin verkkokaupan asiakas valitsee maksutavaksi Paytrailin tai minkä tahansa tähän liitäntään kytketyn maksutavan. Nimittäin verkkokauppias voi nimetä maksutavan haluamallaan tavalla, kuten esimerkiksi "Verkko- tai korttimaksu" ja kytkeä maksutapaan minkä tahansa liitännän. Valinnan jälkeen asiakas lähettää tilauksen. Sitten hän valitsee haluamansa maksutavan Paytrailin verkkopalvelussa ja suorittaa maksun.

Jos maksu epäonnistuu, niin asiakas voi yrittää maksua heti uudelleen tai myöhemmin kirjautumalla sisään omiin tietoihin. Jos asiakas ei onnistu maksussa sitten millään, niin verkkokauppias voi vaihtaa maksutapaa (esim. Paytrail → Ennakkomaksu, tilisiirto).

Jos maksu onnistuu ja asiakas palaa maksusta suoraan verkkokauppaan, niin maksutila vaihdetaan automaattisesti "Odottaa maksua" -tilasta "Alustavasti maksettu" -tilaan. Verkkokauppiaan on tarkistettava maksutila kaiken varmuudeksi klikkaamalla verkkokaupan hallintaliittymässä olevaa maksutilakyselypainiketta. Maksutila on mahdollista tarkistaa myös Paytrailin kauppiaspaneelista.

Paytrail tilittää maksun verkkokauppiaan pankkitilille. Tilityksessä on viive, joka riippuu verkkokauppiaan ja Paytrailin välisestä sopimuksesta tai Paytrailin kauppiaspaneelissa olevista asetuksista.

Tekniikka & turvallisuus

Liitäntä on suora liitäntä verkkokaupan ja Paytrailin välillä. Ensin ohjelmisto ilmoittaa Paytrailille muun muassa viitenumeron ja summan. Paytrail välittää ne maksupalvelun tarjoajalle, kuten esimerkiksi S-Pankin verkkomaksussa S-Pankille. Varsinainen maksu tapahtuukin maksupalvelun tarjoajan ja verkkokaupan asiakkaan välillä. Paluutietona Paytrail saa tiedon maksun onnistumisesta ja välittää sen ohjelmistolle.

Tämä liitäntä ei vastaanota, käsittele, välitä tai tallenna asiakkaiden rahoja, pankkitunnuksia, korttitietoja eikä muitakaan vastaavia tietoja.

Maksuun siirtyminen ja maksutilakysely on salattu Paytrailin toimesta. Lisäksi tietoliikenne verkkokaupan ja Paytrailin välillä on sinetöity turvatarkistelaskennalla.

Käyttöönotto

• Varmista, että käytössäsi on ohjelmistoversio 1812 tai uudempi.
  - Näet ohjelmistoversion verkkokaupan hallintaliittymän alaosasta.
• Tee Paytrailin kanssa sopimus ↗ Paytrailin käytöstä.
• Tilaa verkkokaupastamme Paytrailia koskeva maksuton Plus-lisenssi.
  - Saat sähköpostitse Plus-lisenssikoodin.
• Kirjaudu verkkokaupan hallintaliittymään (demo).
• Klikkaa ylhäältä asetukset / lisenssit.
• Klikkaa Lisää uusi -painiketta.
• Syötä meiltä saatu Plus-lisenssikoodi Lisenssikoodi-kohtaan.
• Klikkaa Tallenna-painiketta.
• Klikkaa ylhäältä asetukset / maksutavat.
• Klikkaa Lisää uusi -painiketta.
• Valitse Liitäntä-kohdasta Paytrailia koskeva liitäntä (uusin niistä).
• Syötä maksutavan nimeksi Paytrail tai mitä tahansa.
• Syötä Kauppiastunnus-kohtaan Paytrailin kauppiaspaneelin Kauppiastili-kohdassa näkyvä Kauppias ID.
• Syötä Salainen avain -kohtaan Paytrailin kauppiaspaneelin Kauppiastili-kohdassa näkyvä Kauppiasvarmenne.
• Klikkaa Tallenna-painiketta.
• Suorita yksi testitilaus ja etene Paytrailin sivuille asti
  - Käyttöönotto onnistui, jos pääsit maksutavan valintasivulle asti ilman virheilmoituksia.

Maksutapalogon lisääminen (vapaaehtoinen)

• Siirry Paytrailin aineistopankkiin ↗.
• Lataa logo omalle tietokoneellesi klikkaamalla "Paytrail_logo (.png)".
• Kirjaudu verkkokaupan hallintaliittymään (demo).
• Klikkaa ylhäältä asetukset / maksutavat.
• Valitse Paytrailia koskeva maksutapakortti.
• Klikkaa Logo-kohdassa olevaa sinistä kuvaketta.
• Valitse logon kuvatiedosto (jpg tai png) omalta tietokoneeltasi.
  
• Klikkaa Tallenna-painiketta.

Maksutapabannerin lisääminen (vapaaehtoinen)

• Siirry Paytrailin aineistopankkiin ↗
• Lataa kaikki logot ja bannerit omalle tietokoneellesi klikkaamalla "Logot ja bannerit (.zip)".
• Pura zip-tiedosto omalle tietokoneellesi.
• Kirjaudu verkkokaupan hallintaliittymään (demo).
• Klikkaa ylhäältä asetukset / koodit ja ulkoasu.
• Klikkaa Lisää uusi -painiketta.
• Valitse tyypiksi "Kuva".
• Syötä nimeksi Paytrail-banneri tai mitä tahansa.
• Klikkaa Kuva-kohdassa olevaa sinistä kuvaketta.
• Valitse bannerin kuvatiedosto (jpg, png tai svg) omalta tietokoneeltasi.
• Klikkaa Tallenna-painiketta.
• Klikkaa Lisää uusi -painiketta.
• Valitse tyypiksi "HTML5".
• Syötä nimeksi Paytrail-banneri tai mitä tahansa.
• Valitse Sivu-kohdasta "ei merkitystä".
• Valitse Sijainti-kohdasta "Verkkokaupassa end of #bottom jälkeen".
• Lisää Koodi-kohtaan bannerin html-koodi, esimerkki:
  

  <a href="shopping_cart.php" class="oma_paytrail_banneri">
  <img src="graphics/codes/paytrail_banneri_pankit_visa_mastercard_mobilepay_walley_c9d15e0a.png" alt="Paytrail" />
  </a>
  

• Klikkaa Tallenna-painiketta.
• Klikkaa Lisää uusi -painiketta.
• Valitse tyypiksi "CSS3".
• Syötä nimeksi Paytrail-banneri tai mitä tahansa.
• Lisää Koodi-kohtaan bannerin css-koodi, esimerkki:
  

  a.oma_paytrail_banneri img {
    display: block;
    margin: 25px auto 25px auto;
    max-width: 90%;
  }
  
  @media (min-width: 1100px) {
    a.oma_paytrail_banneri img {
      width: 600px;
    }
  }
  

• Klikkaa Tallenna-painiketta.

Maksun tarkistaminen

• Kirjaudu verkkokaupan hallintaliittymään (demo).
• Klikkaa ylhäältä tilaukset.
• Valitse luettelosta jokin tilaus.
• Klikkaa sinistä tarkistuspainiketta.

Hyvä tietää

Paytrailin maksupalveluehtoihin viittaava teksti ja linkki (PSD2) ovat valmiiksi maksutapavalintojen läheisyydessä. Niitä ei tarvitse erikseen lisätä.

Paytrailin laatiman API-kuvauksen ↗ mukaan jokaisella tuotteella on oltava toimituspäivämäärä. Liitäntä ilmoittaa Paytrailille jokaisen tuotteen toimituspäivämääräksi koko tilauksen toimituspäivämäärän, joka puolestaan riippuu koko tilauksen toimitusajasta, joka puolestaan riippuu ostoskorissa olevien tuotteiden käsittelyajoista ja asiakkaan valitseman toimitustavan jakeluajoista. Mikäli toimitusaikaa ei ole, niin liitäntä ilmoittaa Paytrailille, että toimituspäivämäärä on kahden päivän kuluttua.

Tunnetut rajoitukset

Ohjelmistoon toteuttamassamme liitännässä ei ole laskun jälkikäteistä manuaalista hyväksymistä, joka olisi mahdollista Walley ja Collector -maksutavoilla. Liitännässä ei myöskään ole maksumaksuraporttia. Liitännässä ei myöskään ole Paytrailin sisäisten maksutapojen (esim. Nordea, OP...) näyttämistä verkkokaupan maksutapoina (eli maksutapojen valintasivun ohitusta), eikä Paytrailin sisäisten maksumaksutaparyhmien (esim. pankki, mobiili, kortti...) näyttämistä verkkokaupan maksutapoina. Saatamme toteuttaa näitä ominaisuuksia liitäntään vielä myöhemmin, joskin maksuraportteja emme toteuta, koska ne ovat saatavilla Paytrailin kauppiaspaneelissa.