Avaa maksutapojen hallinta

Maksutapojen hallinta avataan kohdasta **Configuration > Payment methods**. Näkymä näyttää sekä asennetut että asennettavissa olevat maksumoduulit kortteina.

Voit etsiä moduulia sen nimellä tai luokalla. Rajaa luettelo tarvittaessa valinnoilla **Kaikki**, **Käytössä** ja **Ei käytössä**. Kortin tila kertoo, onko moduuli asennettu ja käytössä.

Maksutavan näkyminen kassalla ei riipu vain moduulin asennuksesta. Moduulin käyttötila, maksuvyöhyke, asiakastyyppi, toimitustaparajaukset ja muut moduulikohtaiset asetukset voivat kaikki vaikuttaa siihen, milloin maksutapa on tarjolla.

Asenna maksumoduuli

Asenna vain sellainen moduuli, jonka maksupalvelu- ja sopimustiedot ovat käytettävissä.

1. Avaa Configuration > Payment methods.
2. Valitse Asenna moduuli.
3. Valitse luettelosta asennettava moduuli. Luettelossa näkyvät vain tunnetut moduulit, joita ei ole vielä asennettu.
4. Vahvista valitsemalla Asenna moduuli.
5. Odota, että moduulin asetussivu avautuu.
6. Tarkista kaikki luodut asetusavaimet ennen kuin otat moduulin käyttöön.

Asennus luo moduulin oletusasetukset ja lisää moduulin asennettujen maksutapojen luetteloon. Asennus ei tarkoita, että maksutapa olisi valmis tuotantokäyttöön. Tarkista erityisesti käyttötila ja tunnistetiedot.

Jos asennus epäonnistuu, tarkista virheilmoitus. Tavallisia syitä ovat puuttuva kirjoitusoikeus, vanhentunut istunto, jo asennettu moduuli tai moduuli, jota nykyinen moduulikatalogi ei tunne.

Muokkaa moduulin asetuksia

Valitse maksutavan kortista **Avaa asetukset**. Sivulla näkyvät kyseisen moduulin omat **Asetusavaimet**. Kentät eivät ole samat kaikissa moduuleissa.

Tyypillisiä asetuksia ovat:

- **Tila**: määrittää, onko maksutapa käytössä. - **Maksuvyöhyke**: rajaa maksutavan määritettyyn maantieteelliseen tai verovyöhykkeeseen. - **Merchant ID**, API-käyttäjä, API-avain, Client ID tai salaisuus: maksupalveluntarjoajan myöntämät tunnisteet ja salaisuudet. - **Järjestys**: vaikuttaa maksutavan paikkaan maksutapaluettelossa. - **Tilauksen tila**: tila, joka asetetaan maksutapaa käyttävälle tilaukselle. - **Asiakastyyppi**: rajaa maksutavan soveltuvaan asiakasryhmään tai tilityyppiin. - **Estetyt toimitustavat**: toimitustavat, joiden yhteydessä maksutapaa ei tarjota. - ERP-tunnisteet, palveluntarjoaja, enimmäisarvo, kuva, nimi, kuvaus tai ehdot, jos kyseinen moduuli sisältää ne.

Lue aina kentän oma kuvaus ja tekninen asetusavain. Käytä maksupalveluntarjoajan juuri tälle kaupalle ja oikeaan ympäristöön myöntämiä tunnuksia. Älä kopioi tunnuksia toisesta maksutavasta vain siksi, että palveluntarjoaja on sama.

Salainen arvo näkyy peitettynä. Valitse **Näytä arvo** vain, kun arvo pitää tarkistaa tai vaihtaa. Varmista ennen paljastamista, etteivät näytönjako, tallennus tai sivulliset voi nähdä tunnusta.

Varmista automaattinen tallennus

Maksutavan asetussivulla ei ole erillistä Tallenna-painiketta. Muutos tallentuu automaattisesti lyhyen viiveen jälkeen.

1. Muuta vain yhtä asetusta kerrallaan.
2. Odota kentän alla näkyvää Tallennettu-tilaa.
3. Jos kentässä näkyy Virhe, älä jatka seuraavaan muutokseen. Tarkista yhteys ja käyttöoikeudet ja yritä muutos uudelleen.
4. Ota maksutapa käyttöön vasta, kun muut pakolliset asetukset on tallennettu.

Koska jokainen muutos tallentuu erikseen, keskeneräistä asetuskokonaisuutta ei voi perua yhdellä Peruuta-toiminnolla. Säilytä moduuli **Ei käytössä** -tilassa määrityksen ajan.

Testaa maksutapa ennen tuotantokäyttöä

Maksutavan tuotantokäyttöä edeltävä testi tehdään maksupalveluntarjoajan testi- tai sandbox-tunnuksilla, jos moduuli ja sopimus tukevat niitä. Älä tee oikeaa maksua tuotantotunnuksilla ilman organisaatiosi hyväksyttyä maksutestiä.

Tarkista vähintään seuraavat asiat:

1. Maksutapa näkyy kassalla sallitulla maksuvyöhykkeellä, asiakastyypillä ja toimitustavalla.
2. Maksutapa ei näy yhdistelmillä, jotka on rajattu pois.
3. Maksupalveluun siirtyminen tai maksulomakkeen avaaminen onnistuu.
4. Onnistunut maksu palauttaa asiakkaan kauppaan ja tilaus saa odotetun tilan.
5. Keskeytetty ja epäonnistunut maksu käsitellään odotetusti.
6. ERP-tunnisteet ja muut integraatioarvot välittyvät oikein, jos moduuli käyttää niitä.

Jos maksutapa ei näy kassalla, tarkista ensin moduulin **Tila**, maksuvyöhyke, asiakastyyppi, estetyt toimitustavat ja mahdolliset arvorajat. Jos yhteys maksupalveluun epäonnistuu, tarkista ympäristö, Merchant ID sekä API- ja asiakastunnukset palveluntarjoajan hallinnasta.

Poista maksumoduuli

Maksutavan maksumoduulin poistaminen on eri asia kuin sen asettaminen **Ei käytössä** -tilaan. Käytä **Ei käytössä** -tilaa, kun haluat keskeyttää maksutavan käytön mutta säilyttää asetukset.

Poista moduuli vain, kun sen asetuksia ei enää tarvita:

1. Avaa moduulin Configuration.
2. Tallenna tarvittavat tunnisteet ja asetukset organisaatiosi hyväksyttyyn salaisuuksienhallintaan. Älä kopioi salaisuuksia tavalliseen muistiinpanoon.
3. Valitse Poista moduuli.
4. Lue vahvistus ja valitse uudelleen Poista moduuli.

Poisto poistaa moduulin asennettujen maksutapojen luettelosta ja hävittää sen asetusavaimet. Jos asennat moduulin myöhemmin uudelleen, tarkista ja määritä arvot uudelleen.