Mitä VivaWallet-asennuksessa määritetään

VivaWallet-maksamisen käyttöönotto AI Commerce Cloudissa koostuu maksumoduulin asentamisesta, yhteisten VivaWallet-tunnusten lisäämisestä, verkkotunnuskohtaisen VivaWallet Code -arvon määrittämisestä sekä webhook- ja palautusosoitteiden asettamisesta. Tee määritykset ensin testattavalle verkkotunnukselle ja ota maksutapa laajempaan käyttöön vasta onnistuneen maksun ja keskeytetyn maksun kokeiden jälkeen.

Samat VivaWallet-tunnukset palvelevat kaikkia kauppaan asennettuja VivaWallet-maksutapoja. VivaWallet Code on puolestaan yhteinen asetusavain, jonka sisältö valitaan verkkotunnuskohtaisesti. Jos kaupassa on useita verkkotunnuksia, jokainen niistä tarvitsee Viva-palvelussa oman Website/App-rivin ja sitä vastaavan koodin AI Commercessa.

1. Asenna tarvittavat VivaWallet-maksumoduulit

VivaWallet-maksumoduulit asennetaan adminissa kohdassa Konfiguraatiot > Maksut. Valitse Asenna maksumoduuli, valitse tunnetusta moduuliluettelosta tarvitsemasi VivaWallet-maksutapa ja vahvista asennus Asenna moduuli -painikkeella. Avaa asennetun moduulin asetukset ennen kuin otat sen käyttöön kassalla.

Asennettavia vaihtoehtoja voivat olla VivaWallet Maksukortit, VivaWallet Apple Pay, VivaWallet Google Pay, VivaWallet PayPal ja VivaWallet Klarna. Asenna vain sopimukseesi ja käyttötarkoitukseesi kuuluvat vaihtoehdot. Moduulin asetuksiin tehdyt muutokset tallentuvat automaattisesti asetuseditorin kautta, mutta maksutavan toiminta on silti testattava erikseen jokaisella asennetulla vaihtoehdolla.

2. Lisää yhteiset VivaWallet-tunnukset

VivaWallet-maksutavat käyttävät yhteisiä tunnuksia: "VivaWallet Merchant ID", "VivaWallet API Key", "VivaWallet Client ID" ja "VivaWallet Client Secret". Hae niiden nykyiset arvot Viva-palvelun kohdasta "Viva Settings > API Access" ja syötä ne AI Commercen vastaaviin VivaWallet-asetuksiin. Asiakassalaisuus ja API-avain ovat salaisuuksia, joten niitä ei pidä kirjoittaa ohjeisiin tai tukiviesteihin.

AI Commercen nykyinen Integraatiot-näkymä tunnistaa VivaWallet-integraation MODULE_PAYMENT_VIVAWALLET_CLIENT_ID- ja MODULE_PAYMENT_VIVAWALLET_CLIENT_SECRET-avaimista. Kauppiastunnistetta ja API-avainta käytetään maksuvahvistuksen tarkistuksessa, joten myös niiden on oltava oikein maksumoduulin asetuksissa. Tarkista merkit ilman ylimääräisiä välilyöntejä ja käytä saman Viva-tilin arvoja kaikille kaupan VivaWallet-maksumoduuleille.

3. Lisää jokaiselle verkkotunnukselle VivaWallet-koodi

"VivaWallet Code" eli MODULE_PAYMENT_VIVAWALLET_SOURCECODE määritetään verkkotunnuskohtaisesti. Avaa Viva-palvelussa "Viva Sales > Online Payments > Websites/Apps", luo jokaiselle verkkotunnukselle oma Website/App-rivi ja kopioi sen koodiarvo. Lisää jokainen koodi AI Commercen "VivaWallet Code" -asetuksessa oikean verkkotunnuksen kohdalle.

AI Commerce lukee asetuksesta verkkotunnusten tunnisteilla indeksoidun kartan ja keskeyttää maksupyynnön, jos nykyiselle verkkotunnukselle ei löydy koodia. Älä siis kopioi yhden verkkotunnuksen koodia kaikille riveille. Tarkista jokaisella verkkotunnuksella erikseen, että maksupyyntö käyttää juuri sitä Viva Website/App -kohdetta, joka on tarkoitettu kyseiselle kaupalle.

4. Määritä VivaWallet-webhook

VivaWallet-maksuvahvistusten webhook-osoitteeksi asetetaan kaupan oman verkkotunnuksen osoite https://OMA-DOMAINISI/api/webhook/vivawallet. Korvaa OMA-DOMAINISI kaupan todellisella HTTPS-verkkotunnuksella. Webhook vastaanottaa VivaWalletin varmennus- ja maksutapahtumat, jotta maksun vahvistus voidaan kohdistaa AI Commercen tilaukseen.

Määritä webhook Viva-palvelun kyseiselle Website/App-kohteelle ja varmista, että osoite on ulkoa saavutettavissa HTTPS-yhteydellä. Käytä jokaisessa ympäristössä sen omaa verkkotunnusta; testiympäristön tapahtumat eivät saa osua tuotantokaupan webhookiin. Tee onnistunut testimaksu ja varmista, että tilauksen maksuvahvistus päivittyy ennen maksutavan avaamista asiakkaille.

5. Määritä epäonnistumisen ja onnistumisen palautusosoitteet

VivaWallet-maksun epäonnistumisen palautusosoite ohjataan takaisin kaupan kassalle. Suomenkielisen kaupan kassapolku on yleensä /kassa, mutta käytä aina kyseisen verkkotunnuksen todellista kassapolkua. Älä käytä onnistuneen maksun osoitteena yleistä /api/checkout/callback/vivawallet-osoitetta.

Onnistunut maksu pitää palauttaa asennetun VivaWallet-maksutavan omaan checkout-callbackiin, jotta AI Commerce tarkistaa paluuparametrit, viimeistelee tilauksen ja ohjaa asiakkaan kiitossivulle. Palautusosoitteen tarkka maksutapakohtainen pääte riippuu asennetusta moduulista. Varmista jokaisen maksutavan nykyinen callback paikallisesta toteutuksesta ja Viva-palvelun asetuksista ennen tuotantokäyttöä.

6. Viimeistele maksutavan asetukset

VivaWallet-maksumoduulin omat asetukset viimeistellään yhteisten tunnusten, lähdekoodin ja osoitteiden jälkeen. Tarkista vähintään Payment region, Default order status, Payment Name, Payment Description ja Payment Conditions. Valitse arvot kaupan alueen, tilaustenkäsittelyn ja asiakkaille näytettävän tekstin mukaisesti.

Varmista myös moduulin käyttötila, järjestys ja mahdolliset asiakastyyppi-, toimitustapa- tai aluerajaukset ennen testausta. Näkyvä maksutavan nimi, kuvaus ja ehdot pitää tarkistaa jokaisella kaupan kielellä. Muutokset tallentuvat nykyisessä maksumoduulin asetuseditorissa automaattisesti, joten tee muutokset hallitusti ja tarkista tallennettu arvo ennen seuraavaan kenttään siirtymistä.

Testaa VivaWallet ennen käyttöönottoa

VivaWallet-asennus testataan jokaisella asennetulla maksutavalla ja verkkotunnuksella. Tee onnistunut maksu, keskeytä yksi maksu ja kokeile virheellistä tai puuttuvaa verkkotunnuskohtaista koodia testiympäristössä. Tarkista, että asiakas palaa oikealle kassalle tai kiitossivulle, webhook vahvistaa maksun ja tilaus saa määritetyn oletustilan.

Testaa lisäksi maksutavan näkyvä nimi, kuvaus, ehdot, alue- ja muut rajaukset sekä eri verkkotunnusten Website/App-kohdistus. Jos maksu jää avoimeksi tai palautuu väärään osoitteeseen, pidä maksutapa pois käytöstä ja tarkista tunnukset, VivaWallet Code, webhook ja maksutapakohtainen callback ennen uutta testiä.