Kysymyksiä maksupalvelun tekniseen toteutukseen liittyen

Mistä näen Paytrailin alustayhteensopivuudet ja saan niihin tarvittavat lisäosat?

Paytrail on saatavilla useimpiin verkkokauppa-alustoihin, joista yleisimmät ovat listattuna verkkosivuillamme: https://www.paytrail.com/yhteensopivat-alustat.

Voinko testata Paytrailin maksupalvelua etukäteen?

Maksupalvelua on mahdollista testata tuotantoympäristössä jo ennen sopimuksen tekoa. Tarkemmat ohjeet maksupalvelun testaamiseen löydät artikkelista Maksujärjestelmän testaaminen.

Alustassamme ei tällä hetkellä ole Paytrailin integraatiota, miten teemme integraation?

Tässä ohjeet, jotka voit toimittaa verkkokauppasi tekniselle toteuttajalle Paytrailin maksupalvelutoteutuksen tekemiseksi.

  • Paytrailin maksurajapinnan integrointi verkkokauppaan on yleisesti katsoen helppoa ja nopeaa. Tavallisesti integraatio saadaan valmiiksi muutamassa työpäivässä. Asennuksessa sinua auttaa parhaiten tekninen asiakaspalvelumme:
    Arkisin klo 8-16 UTC +2/3
    020 718 1831  
    tekniikka@paytrail.com
  • Kattavan teknisen dokumentaatiomme löydät osoitteesta https://docs.paytrail.com/
  • Suosittelemme, että tarkastatte Best Practices-osion, jossa käydään läpi muutamia hyödyllisiä malleja toteutukseen liittyen: https://docs.paytrail.com/best-practices/
  • Kun olette saaneet rajapinnan toimintavalmiiksi, niin pääsette testaamaan maksamista julkisilla testitunnuksilla ilman, että raha oikeasti liikkuu: https://docs.paytrail.com/credentials/. Teknisesti tunnukset toimivat täysin samaan tapaan, kuin lopulliset tuotantotunnuksetkin.

Mitä ominaisuuksia Paytrailin palvelusta tulisi olla toteutettuna?

Tästä on varmasti hyvä keskustella verkkokauppanne teknisen toteuttajan kanssa ja pohtia mitkä ominaisuudet ovat juuri teidän verkkokauppanne kannalta tärkeimpiä. Alla kuitenkin muutamia seikkoja, joita on hyvä ottaa huomioon.

  • Uusimmassa rajapintaversiossamme E2:ssa on mahdollista päättää esim. mitä tilaajan ja tuotteiden tietoja tuodaan Paytrailille verkkokaupasta. Tuodut tiedot vaikuttavat yleensä käytettävissä oleviin ominaisuuksiin, joten suosittelemme vahvasti, että tietoja tuodaan kattavasti. Täältä löydät kaikki rajapintaan tuotavat tilauskentät: https://docs.paytrail.com/payments/e2-interface/fields/
  • Jos kaupassanne käsitellään paljon palautuksia tai haluatte muista syistä helpottaa niiden tekemistä, suosittelemme integroimaan palautukset suoraan verkkokauppa-alustaan. Näin ollen teidän ei tarvitse kirjautua erikseen Paytrailin järjestelmään käynnistämään palautuksia, vaan voitte käynnistää ne suoraan oman ohjelmistonne puolelta. Täältä löydät ohjeet palautusten luonnille Merchant API-rajapinnan kautta: https://docs.paytrail.com/refunds/
  • Merchant API-rajapinnan kautta Paytrailin järjestelmästä on mahdollista noutaa tilitys- ja maksuaineistoa ilman manuaalista kirjautumista Kauppiaspaneeliin. Tämän avulla esim. kirjanpitoa on mahdollista automatisoida, sillä maksujen tilitystiedot voidaan siirtää suoraan kirjanpitoon. https://docs.paytrail.com/settlements/

Saan testimaksussa ilmoituksen "Invalid AUTHCODE" tai "virheellinen sormenjälki", mistä tämä johtuu?

Mikäli palvelumme toimii testitunnuksilla, mutta saat otsikon virheen tuotantotunnuksilla, tarkista, että Kauppiasvarmenne on varmasti oikea. Varmenteen pituus on 30 merkkiä, joten jos pituus poikkeaa tästä, on varmenteessa virhe.

Kauppiasvarmenteen saatte haettua uudelleen kirjautumalla Paytrailin Kauppiaspaneeliin kauppiastunnuksillanne. Valitse ylälaidasta "Asetukset" ja sen alta "Kauppiasvarmenne". Tunnistaudu omilla henkilökohtaisilla verkkopankkitunnuksillasi valitsemalla oman pankkisi painike (nimenkirjoitusoikeus vaaditaan). Tunnistautumisen jälkeen saatte näytöllenne Kauppiasvarmenteen, joka tulee kopioida talteen.

Saan testimaksussa ilmoituksen "rajapintavirhe" mitä se tarkoittaa ?

Rajapintavirhe tarkoittaa, että maksun luomiseen käytettävä data ei vastaa Paytrailin järjestelmän vaatimuksia. Tyypillisesti virheilmoitus sisältää tarkenteen, esimerkiksi kenttänimen, joka ohjaa oikeille jäljille virheen löytämiseksi. Kentissä sallitut merkit löydätte dokumentaatiostamme (https://docs.paytrail.com/payments/e2-interface/validation/). Tekninen asiakaspalvelumme auttaa mielellään tarvittaessa: tekniikka@paytrail.com

Saan testimaksussa ilmoituksen ”järjestelmävirhe, tuntematon virhe” mistä tämä johtuu?

Järjestelmävirhe, tuntematon virhe -ilmoitus aiheutuu tyypillisesti jommasta kummasta alla olevasta syystä:

  1. Maksua on yritetty tehdä liian pienellä summalla. Testitunnuksilla ja oletusarvoisesti myös tuotantotunnuksilla maksun minimisumma on 0,65€ ja pienemmästä summasta tulee tuo virhe. Jos teillä on tarvetta ottaa vastaan tuota pienempiä maksuja, olettehan aiheesta yhteydessä asiakaspalveluumme. Huomaattehan kuitenkin, että myös pienistä maksuista veloitetaan transaktiokulu hinnaston mukaisesti.
  2. Maksua yritetään luoda maksutavalla, joka ei ole aktiivinen. Näet kauppiastunnuksella aktiiviset maksutavat Kauppiaspaneelista kohdasta Asetukset -> maksutavat ja maksutapojen oikeat ID:t dokumentaatiostamme (https://docs.paytrail.com/payment-methods/values/)

Onko Paytrailin palvelussa mahdollista jakaa yhden maksun tilitys useammalle eri yritykselle tai tilille?

Yhden maksun voi jakaa tilittymään useammalle tilille, jos maksun luomiseen käytetään kanavarajapintaamme. Tarkempi kuvaus kanavan toiminnasta löytyy täältä: https://www.paytrail.com/kehittajille

Ja tekninen kuvaus rajapinnasta täältä (https://docs.paytrail.com/sales-channels/)

Miten voin luoda/lähettää maksulinkin asiakkaalle?

Paytrailin palvelussa maksulinkin lähettämiseksi on kaksi eri vaihtoehtoa:

1) Maksulinkin lähettäminen asiakkaalle on mahdollista toteuttaa REST-rajapinnalla. Tällöin asiakas kerää haluamansa tuotteet ostoskoriin ja täyttää yhteystiedot normaalisti. Tämän jälkeen maksutiedot lähetetään Paytrailin palvelimelle verkkokaupan palvelimelta, eli asiakas ei näe tätä tiedonsiirtoa. Paytrailin palvelin lähettää vastauksena maksulinkin. Asiakas voidaan sitten ohjata suoraan tähän linkkiin. Linkki voidaan myös samalla lähettää hänen sähköpostiinsa tai tallentaa se asiakkaan tietoihin myöhemmin käytettäväksi. Linkistä siirrytään Paytrailin normaalille maksusivulle, josta asiakas voi siirtyä maksamaan haluamallaan maksutavalla. Kun maksu on maksettu, lähetetään siitä Notify-kutsu verkkokaupan palvelimelle, vaikka maksu vahvistettaisiinkin viiveellä.

Maksulinkin voi luoda myös esimerkiksi verkkokaupan hallinnasta. Tällöin täytetään tuote- ja tilaustiedot tai pelkkä summan, lähetetään tiedot Paytrailin palvelimelle ja tämän jälkeen saadaan maksulinkki. Linkki voidaan sitten lähettää asiakkaalle eteenpäin sähköpostitse.Maksulinkki voimassa 14 päivää ja sen kautta voi maksun maksaa vain kerran.

Rest-rajapinnan tekninen kuvaus löytyy täältä: https://docs.paytrail.com/legacy/rest-interface/

2) Maksulinkin lähettäminen onnistuu myös Paylink -maksulinkin lähetys -palvelun avulla, jonka avulla voi lähettää kuluttajalle maksulinkkejä, joiden kautta voi maksaa Paytrailin kautta aktiivisina olevilla maksutavoilla (esim. verkkopankkipainikkeilla tai korteilla). Kun asiakas on maksanut Paylink-linkin maksunsa, voi tuotteet toimittaa asiakkaalle. Paylink on toteuttanut portaalin maksulinkkien lähettämistä varten, ja Paylinkiin voidaan aktivoida Paytrailin maksutavat.

Paylinkin palveluun voi tutustua tarkemmin täältä: https://paylink.fi. Palvelun testaaminen onnistuu osoitteesta https://paylink.fi/kokeile-demoa/ Voit esimerkiksi lähettää itsellesi viestin ja testata palvelua.

Tarvitsetko apua teknisen toteutuksen kanssa?

Maksupalvelumme teknisessä toteutuksessa auttaa tekninen asiakaspalvelumme:

Arkisin klo 8-16 UTC +2/3
020 718 1831  
tekniikka@paytrail.com

 

Oliko tämä artikkeli hyödyllinen?
0/0 koki tästä olevan apua