Miten asennat Viva Payments AI Commerceen?

Asenna Viva Payments AI Commerceen ja määritä API Access, webhook sekä Websites/Apps-koodit, jotta tilaukset syntyvät oikein.

Written by Petro Mäntylä

Updated at March 19th, 2026

+ Lisää

Sisällysluettelo

Mistä editoidaan 1) Asenna Viva Payments -moduuli AI Commercessa 2) Yhteiset tunnukset kaikille Viva-maksutavoille 3) Hae Merchant ID, API Key, Client ID ja Client Secret vivasta Huomio maksutavan muista asetuksista 4) Määritä Webhook Viva.comissa Miksi webhook tarvitaan? 5) Lisää Websites/Apps-rivit jokaiselle domainille 6) Täytä “Edit Payment Source: Website/Mobile App” -kentät Tärkeä huomio muokkaamisesta 7) Miksi Vivan tilaus ei muodostu kauppaan? Yhteenveto Avainsanat

VivaWallet-maksutapa asennetaan AI Commerce Cloudissa sivulla Modules > Payment. Asenna ensin haluamasi VivaWallet-maksutapa, syötä sen jälkeen yhteiset Viva-tunnukset ja lisää domain-kohtainen VivaWallet Code.

Mistä asetukset löytyvät

AI Commerce Cloud: Modules > Payment
Viva: Settings > API Access
Viva: Sales > Online Payments > Websites/Apps

1. Asenna haluamasi VivaWallet-maksutapa

Avaa Modules > Payment.
Valitse Install Module.
Asenna tarvitsemasi VivaWallet-maksutapa, esimerkiksi VivaWallet Maksukortit, VivaWallet Apple Pay, VivaWallet Google Pay, VivaWallet PayPal tai VivaWallet Klarna.
Avaa asennetun maksutavan asetukset.

2. Syötä yhteiset Viva-tunnukset

Kaikki VivaWallet-maksutavat käyttävät samoja tunnuksia. Täytä nämä kentät:

VivaWallet Merchant ID
VivaWallet API Key
VivaWallet Client ID
VivaWallet Client Secret

Löydät arvot Vivasta kohdasta Settings > API Access.

3. Lisää domain-kohtainen VivaWallet Code

VivaWallet Code on domain-kohtainen kenttä. Jokaiselle verkkotunnukselle lisätään oma arvo.

Avaa Vivassa Sales > Online Payments > Websites/Apps.
Luo jokaiselle verkkotunnukselle oma Website/App-rivi.
Kopioi kunkin domainin Code.
Syötä koodi AI Commerce Cloudin VivaWallet Code -kenttään oikealle domainille.

4. Määritä webhook

Aseta Vivaan webhook-osoitteeksi:

https://OMA-DOMAINISI/api/webhook/vivawallet

Webhook tarvitaan, jotta maksun vahvistus päivittyy oikein AI Commerce Cloudiin maksun jälkeen.

5. Palautusosoitteet

Failure URL kannattaa ohjata takaisin kaupan checkout-sivulle. Suomenkielisessä kaupassa checkout-sivun polku on yleensä /kassa.

Älä käytä yleistä /api/checkout/callback/vivawallet-osoitetta. VivaWalletin onnistuneen maksun palautus pitää ohjata käytössä olevan maksutavan omaan checkout-callbackiin.

6. Viimeistele maksutavan omat asetukset

Kun yhteiset Viva-asetukset on syötetty, viimeistele tarvittaessa maksutavan omat kentät:

Payment region
Default order status
Payment Name
Payment Description
Payment Conditions

Huomioitavaa

Samat VivaWallet-tunnukset ovat käytössä kaikissa VivaWallet-maksutavoissa.
VivaWallet Code on yhteinen asetus, mutta sen sisältö täytetään domain-kohtaisesti.
Jos käytössä on useita domaineja, varmista että jokaisella domainilla on oma Website/App-rivi Vivassa ja sitä vastaava koodi AI Commerce Cloudissa.

viva payments viva wallet maksupalvelu maksuintegraatio maksumoduuli maksuportti maksunvälittäjä verkkomaksut korttimaksut checkout-maksut maksutavan asetukset maksupalvelun käyttöönotto viva payments asennus maksutavan aktivointi maksupalvelun asetukset