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ä.
  - Verkkokauppa-alustan nimi on Clover Shop.
• 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ä Paytraililta saatu myyjän tunniste Kauppiastunnus-kohtaan.
• Syötä Paytraililta saatu turva-avain Salainen avain -kohtaan.
• Klikkaa Tallenna-painiketta.
• Suorita yksi testitilaus ja etene Paytrailin sivuille asti
  - Käyttöönotto onnistui, jos pääsit maksutavan valintasivulle asti ilman virheilmoituksia.

Maksutapabannerin lisääminen

Voit kopioida maksutapabannerin html-koodin Paytrailin kauppiaspaneelista ja liittää sen verkkokaupan hallintaliittymän asetukset / koodit ja ulkoasu -kohtaan. Tarkempi ohje on tulossa myöhemmin.

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

Paytrail ei tue lahjakortteja ja alennuskuponkeja, jotka vähentävät tilauksen maksettavaa loppusummaa. Siksi verkkokaupan asiakas ei voi maksaa tilauksesta alkuosaa lahjakortilla ja loppuosaa Paytraililla. Tämä tieto perustuu kesän 2020 tilanteeseen.

Paytrail tukee vain kokonaisluvullisia ALV-kantoja. Se ei tue esimerkiksi 21,5 %:n ALV-kantoja.

Paytrailin kauppiaspaneelissa ei ole (ainakaan vielä) laskun manuaalista hyväksyntää. Tämä tieto perustuu syksyn 2021 tilanteeseen.

Ohjelmistoon toteuttamassamme liitännässä ei ole jälkipäätä, eli maksun hyvitystä, maksuraporttia eikä tilitysraporttia. Nämä ominaisuudet löytyvät Paytrailin kauppiaspaneelista.