Vodič za integraciju Smart Checkouta

Viva.com Smart Checkout omogućuje vam prihvaćanje online plaćanja putem hostirane stranice za plaćanje.

Ovaj vodič objašnjava glavne korake za integraciju Smart Checkout s vašom web stranicom ili aplikacijom, od postavljanja vašeg Viva.com računa i izvora plaćanja do preusmjeravanja korisnika i provjere ishoda plaćanja.

1. Odaberite svoje Viva.com okruženje

Viva.com nudi dva okruženja. Provjerite upotrebljavate li okruženje koje odgovara onome što želite učiniti.

Okruženje	Upotrijebite za	Početak rada
Produkcija	Prihvaćanje stvarnih plaćanja	Proces registracije Viva.com računa \| Viva.com podrška
Demo	Testiranje vaše integracije i testnih plaćanja	Pokretanje sa sandbox/ demo računom \| Viva.com podrška

Provjerite radite li u ispravnom okruženju prilikom postavljanja i testiranja integracije.

2. Izradite izvor plaćanja za online plaćanja

Izvor plaćanja sadrži postavke koje Viva.com upotrebljava za plaćanja izvršena putem vaše web stranice ili aplikacije.

Prilikom postavljanja izvora plaćanja konfigurirajte svoju domenu i URL-ove na koje se korisnici trebaju vratiti nakon dovršetka postupka plaćanja.

Na primjer:

stranicu za uspješno plaćanje, kao što je „Hvala vam na narudžbi”
stranicu za neuspješno plaćanje, kao što je „Došlo je do problema s vašim plaćanjem”

Da biste izradili izvor plaćanja za online plaćanja, na Viva.com upravljačkoj ploči idite na Prodaja > Online plaćanja.

Nakon izrade izvora plaćanja spremite njegov 4-znamenkasti kod izvora. Taj će vam kod biti potreban prilikom konfiguriranja integracije.

Detaljne upute za postavljanje potražite u članku Izvor za online plaćanja | Viva.com podrška.

3. Integrirajte Smart Checkout

Tri su glavna koraka za integraciju Smart Checkout:

1. korak: Izradite nalog za plaćanje

Prije nego što od korisnika zatražite plaćanje, izradite nalog za plaćanje.

Svakom nalogu za plaćanje dodjeljuje se jedinstveni 16-znamenkasti ID pod nazivom orderCode.

Izradite nalog za plaćanje sa svog poslužitelja koristeći Create Payment Order API, a zatim proslijedite orderCode svojoj web stranici ili aplikaciji.

Za parametre API-ja i pojedinosti o implementaciji posjetite Viva.com Developer Portal. U izborniku s lijeve strane odaberite APIs for payments, a zatim Payment API. U odjeljku Payments odaberite Create payment order.

2. korak: Preusmjerite korisnika na Smart Checkout

Nakon izrade naloga za plaćanje preusmjerite korisnika na Smart Checkout. Korisnik zatim može unijeti svoje podatke za plaćanje i dovršiti postupak plaćanja na stranici Smart Checkout.

3. korak: Obradite povratak korisnika i provjerite ishod plaćanja

Nakon postupka plaćanja korisnik se preusmjerava na URL konfiguriran za odgovarajući ishod:

Success URL za uspješna plaćanja
Failure URL za neuspješna plaćanja

Te URL-ove možete konfigurirati na Viva.com upravljačkoj ploči u odjeljku Prodaja > Online plaćanja > Web stranice/Aplikacije.

Provjerite ishod plaćanja

Provjerite status transakcije u svojem sustavu pomoću podataka o plaćanju koje vraća Viva.com. Podaci o transakciji koji se upotrebljavaju za provjeru uključuju:

Amount
transactionId
statusId

Viva.com nudi sljedeće metode za provjeru ishoda plaćanja.

Webhooks

Webhooks omogućuju vašem sustavu primanje obavijesti o uspješnom ili neuspješnom plaćanju i podržavaju sinkrone i asinkrone načine plaćanja.

Za pojedinosti o implementaciji, parametre događaja i primjere payloadova posjetite Viva.com Developer Portal i u izborniku odaberite Webhooks For Payments.

Retrieve Transaction API

Podatke o transakciji možete dohvatiti i koristeći Retrieve Transaction API. Za parametre API-ja i pojedinosti o implementaciji posjetite Viva.com Developer Portal. U izborniku s lijeve strane odaberite APIs for payments, a zatim Payment API. U odjeljku Transactions odaberite Retrieve transaction.

Neobavezne postavke za Smart Checkout

Možete konfigurirati i dodatne postavke za Smart Checkout u skladu s potrebama svoje integracije.

Prikažite logotip svoje robne marke

Logotip svoje robne marke možete dodati u Smart Checkout putem postavki izvora plaćanja. Za upute posjetite Viva.com Developer Portal, idite na Tutorials, odaberite Smart Checkout Configuration, a zatim kliknite Add your brand logo.

Za optimalan prikaz prenesite jasan logotip odgovarajuće veličine.

Prikažite gumb Cancel

U naprednim konfiguracijskim postavkama izvora plaćanja možete konfigurirati gumb Cancel. Time korisnicima omogućujete otkazivanje narudžbe.

Gumb Cancel podržan je za izravne integracije Smart Checkout i dodatke za Shopify i PrestaShop.

Možete konfigurirati i webhookove za primanje obavijesti o događajima otkazivanja narudžbi. Posjetite Viva.com Developer Portal, odaberite Webhooks For Payments, a zatim Order Updated za više informacija.

Dodatne mogućnosti plaćanja

Smart Checkout podržava i dodatne konfiguracije plaćanja, uključujući:

Ponavljajuća plaćanja: Trgovac automatski pokreće naplate prema unaprijed definiranom rasporedu nakon prvog plaćanja.
Predautorizacije: Iznos se rezervira, a prijenos sredstava pokreće se naknadno.

Za tehničke pojedinosti o implementaciji i druge dostupne konfiguracije Smart Checkout posjetite Viva.com developer portal.

Još uvijek trebate pomoć? Naš vam je tim na raspolaganju. Obratite nam se putem opcije Razgovarajte s nama na svojem Viva.com računu.