Magento 2 Paytrail – Ohje

1. Asentaminen

Moduuli asennetaan kuten muutkin Magento 2 -moduulit. Asennukseen käytetään Composeria, jonka kautta moduuli on helppo asentaa ja päivittää.

Markupin Composer-pakettivarasto (repository) on osoitteessa https://repo.markup.fi. Pakettivarasto on julkinen, mutta moduulien lataus vaatii lisenssiavaimen. Lisenssiavain kysytään moduulia ladattaessa.

1) Mene Magenton juurikansioon komentorivillä

2) Lisää Markupin Composer-pakettivarasto Magenton composer.json tiedostoon kohtaan repositories:

{
    "type": "composer",
    "url": "https://repo.markup.fi"
}

Katso tästä kuva, miltä composer.json tiedoston pitäisi näyttää lisäyksen jälkeen. Huomaa pilkku Magenton oman repositoryn jälkeen, mutta ei Markupin repositoryn jälkeen (jos viimeinen repository). Tiedoston on oltava oikein muotoiltua jsonia.

3) Lataa Markup_Paytrail moduuli pakettivarastosta

composer require markup/module-paytrail

Moduuleja ladattaessa pyydetään kirjautumaan sisään Markupin pakettivarastoon. Käyttäjätunnus on tilausvahvistuksen sähköpostiosoite ja salasana tilausvahvistuksessa toimitettu lisenssiavain.

4) Kytke moduulit päälle ja aja Magenton asennuskomennot.

php bin/magento module:enable --clear-static-content Markup_Paytrail
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

5) Moduuli on asennettu onnistuneesti, jos edelliset käskyt eivät aiheuttaneet virheilmoituksia. Seuraavaksi tulee syöttää asetukset.

2. Asetukset

Moduuli sisältää integraatiot Paytrailin vanhaan (E2) sekä uuteen (Paytrail Payment API) rajapintaan. Maksutapojen asetukset löytyvät seuraavista kohdista:

Vanha rajapinta: Stores > Configuration > Sales > Payment Methods > Paytrail (legacy E2)
Uusi rajapinta: Stores > Configuration > Sales > Payment Methods > Paytrail

Asetukset ovat samankaltaiset molemmille rajapinnoille. Alla olevassa taulukossa on kuvattu asetukset.

Enabled	Näytetäänkö maksutapa kassalla.
Merchant ID	Paytraililta saatu kauppiastunnus
Merchant Secret	Paytraililta saatu salainen avain.
Use Payment Page Bypass	Käytetäänkö maksusivun ohitusta. Vaatii sopimuksen Paytrailin kanssa.
Payment Methods	Maksusivun ohituksessa näytettävät maksutavat (vain vanha rajapinta, uudessa maksutavat haetaan automaattisesti)
Language	Paytrailin maksusivun kieli.
New Order Status	Tilauksen tila, joka annetaan onnistuneille (maksetuille) tilauksille.

Kun asetukset on tehty, pitäisi Paytrailin maksutavan näkyä kassalla. Asiakkaan klikatessa ”Place order” tai ”Vahvista tilaus” asiakas ohjataan Paytrailin maksusivulle, jossa asiakas valitsee maksutavan ja maksaa tilauksen. Maksamisen jälkeen asiakas ohjataan takaisin verkkokauppaan.

3. Maksunpalautukset

Moduulin avulla on myös mahdollista palauttaa maksuja suoraan Magenton hallintapaneelista.

Mene Sales > Orders > [tilaus] > Invoices > [invoice] > Credit Memo
Syötä palautettavat tuotteet ja summat
Klikkaa Refund
Jos maksu onnistui, niin siitä tulee maininta tilauksen kommentteihin

4. Päivittäminen uuteen rajapintaan

Paytrailin uuteen rajapintaan siirtyminen on hyvin helppoa. Siirtymisessä on kolme vaihetta:

Moduulin päivittäminen 2.4.x versioon
Uuden rajapinnan asetusten syöttäminen
Vanhan rajapinnan käytöstä poisto

Erittäin tärkeää! Varmista ettei kaupassa ole samaan aikaan päällä useita eri Paytrail tai Checkout moduuleita. Eri integraatiot samaan maksutapaan käyttävät samoja teknisiä ID:tä, joka aiheuttaa ongelmia maksujen kirjaamisessa verkkokauppaan.

1. Moduulin päivittäminen 2.4.x versioon

Moduulin voi päivittää suoraan Composerilla tai korvaamalla moduulin tiedostot app/code/Markup/Paytrail kansiossa uusimmalla versiolla, jonka saa tilausvahvistuksen latauslinkistä.

2. Uuden rajapinnan asetusten syöttäminen

Uuden rajapinnan asetukset löytyvät Stores > Configuration > Sales > Payment Methods > Paytrail. Asetuksiin tarvitaan uuden rajapinnan kauppias ID (Merchant ID) ja kauppiasvarmenne (Merchant Secret), jotka saadaan Paytraililta. Uuteen rajapintaan ei käy vanhan rajapinnan tunnukset.

3. Vanhan rajapinnan käytöstä poisto

Vanha rajapinnan asetukset löytyvät Stores > Configuration > Sales > Payment Methods > Paytrail (legacy E2). Rajapinta poistetaan käytöstä valitsemalla Enabled asetukseen No.

« Näytä lisäosa