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 Paytrailin luotettavasti ja turvallisesti toisiinsa.

Paytrail hyväksyy tilausriveillä olevan ALV-prosentin ainoastaan kokonaislukuna, esim. 24. Tästä johtuen nykyisillä toteuttamillamme Paytrail-liitännöillä (10/2023 ja 11/2023) uusi ALV-prosentti 25,5 muuntuu muotoon 25. Muuntuminen ei vaikuta hintoihin; ainoastaan ALV-prosentti tallentuu väärin Paytrailin järjestelmään. Tilaus tallentuu verkkokaupan tietokantaan oikein, esim. ALV-prosentilla 25,5. Odotamme Paytraililta uusia ohjeita ja toteutamme ohjelmistoomme sen jälkeen uudet Paytrail-liitännät. Tämä on tilanne 17.4.2024.

Toimintaperiaate käytännössä

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 uudelleen joko epäonnistuneesta maksusta palattaessa, klikkaamalla tilausvahvistuksessa olevaa maksulinkkiä tai 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.

Toimintaperiaate teknisesti

Toimintakaavio

Ohjelmistoomme sisäänrakennettu ns. tehdasvalmisteinen liitäntä näkyy kuvassa punaisella. Clover Shop Oy:tä ei ole piirretty kuvaan, koska se ei ole osallisena maksutapahtumissa.

Liitäntä on osa Clover Shop -verkkokauppaohjelmistoa ja toimii ikään kuin lähettimenä ja vastaanottajana. Ensin liitäntä ilmoittaa Paytrailille muun muassa maksunumeron ja summan (lähetin). Paytrail ilmoittaa nämä tiedot "lopulliselle" maksutavalle, kuten esimerkiksi S-pankin verkkomaksulle. Varsinainen maksu tapahtuu suoraan verkkokaupan asiakkaan ja "lopullisen" maksutavan välillä. "Lopullinen" maksutapa ilmoittaa Paytrailille tiedon maksun onnistumisesta, jonka jälkeen Paytrail ilmoittaa saman tiedon toteuttamallemme liitännälle (vastaanotin).

Turvallisuus

Liitäntä ei vastaanota, käsittele, välitä tai tallenna asiakkaiden rahoja, pankkitunnuksia, korttitietoja eikä muitakaan vastaavia tietoja. Tämä koskee myös verkkokauppiaita, Clover Shop -verkkokauppaohjelmistoa ja Clover Shop Oy:tä, jotka eivät siis myöskään vastaanota, käsittele...

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ä.
  • Kirjaudu verkkokaupan hallintaliittymään (demo).
  • Klikkaa ylhäältä asetukset / maksutavat.
  • Klikkaa Lisää uusi -painiketta.
  • Valitse Tyyppi-kohdasta "Verkko/kortti/mobiilimaksu (maksunvälittäjän kautta)".
  • Syötä Nimi-kohtaan "Paytrail" tai mitä tahansa.
  • Valitse Liitäntä-kohdasta Paytrailia koskeva liitäntä.
  • 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 Tyyppi-kohdasta "Kuva".
  • Syötä Nimi-kohtaan "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 Tyyppi-kohdasta "HTML5".
  • Syötä Nimi-kohtaan "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 Tyyppi-kohdasta "CSS3".
  • Syötä Nimi-kohtaan "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

Liitännän ominaisuuksiin kuuluu kaikista mahdollisista Paytrailin ominaisuuksista vain maksuun siirtyminen, maksusta paluu, maksutilan vastaanotto ja maksutilakysely. Muut ominaisuudet, kuten esimerkiksi maksun hyvitys, ovat käytettävissä Paytrailin kauppiaspaneelissa.

Näin rakennat yrityksellesi verkkokaupan

1. Ota ohjelmisto käyttöön

Asenna ohjelmisto tai tilaa meiltä maksuton asennustyö. Maksuton asiakaspalvelumme ja tekninen tukemme neuvoo tarvittaessa kummassakin tapauksessa.

2. Perusta verkkokauppa

Kirjaudu selaimella verkkokaupan hallintaliittymään ja perusta verkkokauppa. Tarjoamme maksuttomat Maxi-ominaisuudet verkkokaupan perustamisen ajaksi.

3. Tilaa lisenssi

Tilaa lisenssi vasta, kun olet perustanut verkkokaupan, eli verkkokauppa on ns. laitettu tulille. Voit myös olla tilaamatta lisenssiä ja luopua hankkeesta.

Scroll to Top