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
Moduulin asetukset löytyvät kohdasta Stores > Configuration > Sales > Payment Methods > Paytrail.
| 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. |
| Language | Paytrailin maksusivun kieli. |
| New Order Status | Tilauksen tila, joka annetaan onnistuneille (maksetuille) tilauksille. |
| Capture Invoices | Aktivoidaanko Walleyn ja Klarnan laskut heti tilauksen yhteydessä vai jälkikäteen |
| Order Status for Capturable Invoices | Mikä tila tulee tilauksille, joilla on aktivoitava lasku |
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. Laskujen manuaalinen aktivointi
Oletuksena laskut (Klarna ja Walley) aktivoidaan heti tilauksen yhteydessä. Mikäli tuotteita ei kuitenkaan toimiteta heti, laskut on hyvä aktivoida vasta toimituksen yhteydessä, jolloin vältät asiakkaiden sekaannukset ja liian aikaisen laskutuksen.
Laskut voi aktivoida jälkikäteen kahdella eri tavalla:
- Manuaalisesti ylläpidosta
- Automaattisesti kun tilaus toimitetaan ylläpidosta Ship-toiminnolla
Asetuksista Stores > Configuration > Sales > Payment Methods > Paytrail valitaan, kumpaa tapaa käytetään:
Laskun aktivointi ylläpidosta
Mikäli käytössä on manuaalinen aktivointi (Aktivoi laskut > Ylläpidosta tilauksen jälkeen), lasku aktivoidaan tilaukselle ylläpidon tilausnäkymästä:
Laskun aktivointi toimituksen yhteydessä
Mikäli lasku halutaan aktivoida automaattisesti toimituksen yhteydessä, valitaan asetuksista Kun tilaus toimitetaan. Lasku aktivoidaan silloin automaattisesti, kun tilaukselle tehdään toimitus Ship-toiminnon kautta:
Virhetilanteet aktivoinnissa
Mikäli aktivoinnissa tapahtuu esimerkiksi yhteysvirhe, näkyy epäonnistumisesta maininta tilauksen kommenteissa ja tilaksi jää Odottaa aktivointia. Aktivointia voi yrittää uudelleen Aktivoi nyt painikkeesta.
Walleyn kuluttajalaskut ovat voimassa 90 päivää ja Klarnan 28 päivää. Suosittelemme tarkistamaan esimerkiksi kerran kuukaudessa Paytrailin kauppiaspaneelista, että kaikki laskut on aktivoitu:



