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

Moduulin asetukset löytyvät kohdasta Stores > Configuration > Sales > Payment Methods > Paytrail.

EnabledNäytetäänkö maksutapa kassalla.
Merchant IDPaytraililta saatu kauppiastunnus
Merchant SecretPaytraililta saatu salainen avain.
Use Payment Page BypassKäytetäänkö maksusivun ohitusta. Vaatii sopimuksen Paytrailin kanssa.
LanguagePaytrailin maksusivun kieli.
New Order StatusTilauksen tila, joka annetaan onnistuneille (maksetuille) tilauksille.
Capture InvoicesAktivoidaanko Walleyn ja Klarnan laskut heti tilauksen yhteydessä vai jälkikäteen
Order Status for Capturable InvoicesMikä 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.

  1. Mene Sales > Orders > [tilaus] > Invoices > [invoice] > Credit Memo
  2. Syötä palautettavat tuotteet ja summat
  3. Klikkaa Refund
  4. 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: