Izvori se upotrebljavaju za identifikaciju i upravljanje online plaćanjima izvršenima putem usluge Smart Checkout, plugins i drugih payment tools. Više informacija o svakoj opciji možete pronaći na Viva.com Developer Portal, u odjeljcima Smart Checkout, Plugins i Payment tools.
➡️ Dodaj izvor
Da biste dodali izvor za online plaćanja, slijedite ove korake:
Prijavite se na Viva.com i odaberite odgovarajući račun (demo ili aktivni).
Idite na Prodaja → Online plaćanja → Web stranice/Aplikacije.
Odaberite Dodaj web stranicu/Aplikaciju.
Ispunite potrebne podatke u skočnom prozoru na sljedeći način:
Kod – Četveroznamenkasti broj u gornjem lijevom kutu polja je „Izvorni kod“ – jedinstveni identifikator za ovaj izvor plaćanja. Ovaj kod se generira automatski, ali možete odabrati drugu vrijednost ako želite (na primjer, u organizacijske svrhe). Ako koristite naš Payment API, ovaj kod se prosljeđuje kroz parametar sourceCode prilikom kreiranja naloga za plaćanje. Za više informacija pogledajte stranicu dokumentacije Payment API na Viva.com Developer Portal.
Naziv izvora – Osim Izvornog koda, možete dodijeliti i naziv svom izvoru plaćanja. To vam omogućuje lakšu identifikaciju izvora unutar vašeg računa i izvještaja (na primjer, Izvještaja o namiri).
Povezani račun – Odaberite račun (novčanik) koji želite povezati s ovim izvorom plaćanja. Kada se ovaj izvor plaćanja koristi, sredstva će biti uplaćena na odabrani račun. Možete povezati više različitih izvora na jedan račun ako to želite.
Protokol – Ako vaša e-commerce platforma koristi SSL pri naplati, odaberite https. Ako vaša platforma ne koristi SSL (kao što je slučaj u nekim razvojnim okruženjima, na primjer), odaberite http.
Naziv domene – Unesite domenu koja će biti povezana s ovim izvorom plaćanja. Ne trebate uključivati kosu crtu (\) na kraju niti protokol (http:// ili https://). Na primjer:
Ako vaša web stranica koristi www: www.vašadomena.com
Ako vaša web stranica ne koristi www: vašadomena.com
Metoda integracije – Ostavite postavljeno na Redirection/Native Checkout v2.
Logo tvrtke – Učitajte logo svoje tvrtke koji će biti povezan s ovim izvorom plaćanja, u PNG formatu s prozirnom pozadinom, do 100KB (preporučena veličina: 128 x 128 piksela). Ovo je važan korak jer će se logo prikazivati na vašoj stranici za plaćanje i pomoći kupcima da prepoznaju i potvrde vašu tvrtku.
URL za uspjeh (Success URL) – Ovo je URL stranice na koju će kupac biti preusmjeren nakon uspješnog plaćanja. Na primjer, možete ga koristiti za prikaz stranice s potvrdom plaćanja ili stranice koja zahvaljuje kupcu na uplati.
URL za neuspjeh (Failure URL) – Ovo je URL stranice na koju će kupac biti preusmjeren nakon neuspješnog plaćanja. Na primjer, možete ga koristiti za vraćanje kupca na posljednji korak procesa naplate kako bi mogao ponovno pokušati transakciju.
Napredne postavke – U ovoj fazi možete omogućiti prikaz gumba Otkaži u Smart Checkout, kao i izmijeniti nazive URL parametara koji se dodaju u Success/Failure URL-ove nakon transakcije. Za više informacija o parametrima koji se dodaju u Success i Failure URLs posjetite stranicu Viva.com Developer Portal – Response information u odjeljku Integration reference i pogledajte parametre niza upita odgovora.
Da biste omogućili gumb Otkaži u Smart Checkout, aktivirajte opciju Cancel Button. Kada se klikne na gumb Otkaži, Smart Checkout će preusmjeriti na vaš Failure URL s parametrom cancel u upitu.
Napomena:
Trenutačno je gumb Otkaži podržan za izravne integracije s Smart Checkout, kao i za određene funkcionalnosti u našim pluginovima za Shopify i PrestaShop.
Moguće je primati i webhooks za događaje otkazivanja narudžbi. Posjetite stranicu Viva.com Developer Portal – Order Updated u odjeljku Webhooks for payments za informacije o webhooku Order Updated i događajima otkazivanja narudžbi.
Zadani parametri su:
Parameter | Default Name |
Cancellation status | cancel |
Order Code | s |
Transaction ID | t |
Language | lang |
Preporučuje se zadržati ove zadane postavke osim ako nisu potrebne određene promjene kako bi se uskladile s internim sustavima.
Na kraju pregledajte informacije pored svakog potvrdnog okvira na dnu zaslona. Morate se složiti s tim uvjetima kako biste mogli kreirati izvor plaćanja. Nakon što odaberete sve opcije, kliknite gumb Kreiraj kako biste dovršili proces.


