Viva.com Smart Checkoutin avulla voit vastaanottaa verkkomaksuja isännöidyn maksusivun kautta.
Tässä oppaassa kuvataan Smart Checkoutin integroinnin tärkeimmät vaiheet verkkosivustollesi tai sovellukseesi aina Viva.com-tilisi ja maksulähteen määrittämisestä asiakkaiden uudelleenohjaukseen ja maksun lopputuloksen tarkistamiseen.
1. Valitse Viva.com-ympäristösi
Viva.com tarjoaa kaksi ympäristöä. Varmista, että käytät tarkoitukseesi sopivaa ympäristöä.
Ympäristö | Käytä tähän | Aloittaminen |
Tuotanto | Oikeiden maksujen vastaanottaminen | |
Demo | Integraation ja testimaksujen testaaminen |
Varmista integraatiota määrittäessäsi ja testatessasi, että työskentelet oikeassa ympäristössä.
2. Luo maksulähde verkkomaksuja varten
Maksulähde sisältää asetukset, joita Viva.com käyttää verkkosivustosi tai sovelluksesi kautta suoritettaviin maksuihin.
Kun määrität maksulähdettä, määritä verkkotunnuksesi ja URL-osoitteet, joihin asiakkaat palautetaan maksuprosessin suorittamisen jälkeen.
Esimerkiksi:
onnistuneen maksun sivu, kuten ”Kiitos tilauksestasi”
epäonnistuneen maksun sivu, kuten ”Maksussasi tapahtui virhe”
Voit luoda maksulähteen verkkomaksuja varten siirtymällä Viva.com-hallintapaneelissa kohtaan Myynnit > Verkkomaksut.
Kun olet luonut maksulähteen, tallenna sen 4-numeroinen lähdekoodi. Tarvitset tätä koodia integraation määrittämisessä.
Yksityiskohtaiset määritysohjeet ovat artikkelissa Lähde verkkomaksuja varten | Viva.com tuki.
3. Integroi Smart Checkout
Smart Checkoutin integrointi koostuu kolmesta päävaiheesta:
Vaihe 1: Luo maksutoimeksianto
Luo maksutoimeksianto ennen maksun pyytämistä asiakkaalta.
Jokaiselle maksutoimeksiannolle määritetään yksilöllinen 16-numeroinen tunnus nimeltä orderCode.
Luo maksutoimeksianto palvelimeltasi käyttämällä Create Payment Order API -rajapintaa ja välitä sitten orderCode verkkosivustollesi tai sovellukseesi.
API-parametrit ja toteutuksen yksityiskohdat löydät Viva.com Developer Portalista. Valitse vasemmanpuoleisesta valikosta APIs for payments, sitten Payment API. Valitse kohdasta Payments Create payment order.
Vaihe 2: Ohjaa asiakas Smart Checkoutiin
Kun olet luonut maksutoimeksiannon, ohjaa asiakas Smart Checkoutiin. Asiakas voi sitten syöttää maksutietonsa ja suorittaa maksuprosessin Smart Checkout -sivulla.
Vaihe 3: Käsittele asiakkaan paluu ja tarkista maksun lopputulos
Maksuprosessin jälkeen asiakas ohjataan kyseistä lopputulosta varten määritettyyn URL-osoitteeseen:
Success URL onnistuneille maksuille
Failure URL epäonnistuneille maksuille
Voit määrittää nämä URL-osoitteet Viva.com-hallintapaneelissa kohdassa Myynnit > Verkkomaksut > Nettisivut/Sovellukset.
Tarkista maksun lopputulos
Tarkista tapahtuman tila järjestelmässäsi Viva.comin palauttamien maksutietojen avulla. Vahvistamiseen käytettäviä tapahtumatietoja ovat:
AmounttransactionIdstatusId
Viva.com tarjoaa seuraavat menetelmät maksun lopputuloksen tarkistamiseen.
Webhooks
Webhooks mahdollistaa sen, että järjestelmäsi voi vastaanottaa ilmoituksia maksun onnistumisesta tai epäonnistumisesta, ja tukee sekä synkronisia että asynkronisia maksutapoja.
Toteutuksen yksityiskohdat, tapahtumaparametrit ja esimerkkipayloadit löydät Viva.com Developer Portalista. Valitse valikosta Webhooks For Payments.
Retrieve Transaction API
Voit myös hakea tapahtumatietoja käyttämällä Retrieve Transaction API -rajapintaa. API-parametrit ja toteutuksen yksityiskohdat löydät Viva.com Developer Portalista. Valitse vasemmanpuoleisesta valikosta APIs for payments, sitten Payment API. Valitse kohdasta Transactions Retrieve transaction.
Smart Checkoutin valinnaiset asetukset
Voit myös määrittää Smart Checkoutin lisäasetuksia integraatiosi tarpeiden mukaan.
Näytä brändisi logo
Voit lisätä brändisi logon Smart Checkoutiin maksulähteen asetuksista. Ohjeet löydät Viva.com Developer Portalista. Siirry kohtaan Tutorials, valitse Smart Checkout Configuration ja napsauta sitten Add your brand logo.
Varmista optimaalinen näkyvyys lataamalla selkeä ja sopivan kokoinen logo.
Näytä Cancel-painike
Voit määrittää Cancel-painikkeen maksulähteen lisäasetuksissa. Näin asiakkaat voivat peruuttaa tilauksensa.
Cancel-painiketta tuetaan suorissa Smart Checkout -integraatioissa sekä Shopify- ja PrestaShop-laajennuksissa.
Voit myös määrittää webhookit vastaanottamaan ilmoituksia tilausten peruutustapahtumista. Siirry Viva.com Developer Portaliin, valitse Webhooks For Payments ja sitten Order Updated saadaksesi lisätietoja.
Muut maksuvaihtoehdot
Smart Checkout tukee myös muita maksumäärityksiä, kuten:
Toistuvat maksut: Kauppias käynnistää veloitukset automaattisesti ennalta määritetyn aikataulun mukaisesti ensimmäisen maksun jälkeen.
Katevaraukset: Summa varataan ja varojen siirto käynnistetään myöhemmin.
Tekniset toteutustiedot ja muut käytettävissä olevat Smart Checkout -määritykset löydät Viva.com developer portalista.
Tarvitsetko vielä apua? Tiimimme auttaa sinua mielellään. Ota meihin yhteyttä Viva.com-tilisi Chat-vaihtoehdon kautta.