HolestPay

1. Uvod u HolestPay

HolestPay je napredni sistem koji omogućava integrisano upravljanje plaćanjima, dostavom, fiskalizacijom i poslovnim procesima preko jedne centralne platforme. Sistem pruža Holest e-Commerce doo, PSP (Payment Service Provider).

Slika 1: HolestPay komandna tabla (Dashboard)

Ključne karakteristike sistema:

• Višekanalno plaćanje - Podrška za kartična plaćanja, IPS mobilna plaćanja, uplatnice, rate i ostale metode
• Fiskalizacija - Automatska integracija sa e-Fiscal sistemom (Republika Srbija)
• Upravljanje dostavom - Podrška za više kurirskih službi i upravljanje paketima
• PCI DSS usklađenost - Panel razvijen u skladu sa PCI DSS ver 4.0.1 standardima bezbednosti
• MFA obavezan - Višefaktorska autentifikacija (PIN, SMS, EMAIL, BIOMETRIC)
• Fleksibilna integracija - Može se integrisati sa različitim e-commerce platformama, mobilnim aplikacijama (Android/iOS) i POS sistemima
• Izvještavanje - Detaljan prikaz transakcija, fiskalizacije i dostave u realnom vremenu

2. Osnovni koncepti i terminologija

Pre nego što počnete sa korišćenjem HolestPay sistema, važno je da razumete osnovne koncepte i terminologiju koja se koristi u platformi. Ova sekcija objašnjava ključne operacije i statuse koji čine temelj rada sa sistemom.

2.1. Platne operacije

HolestPay podržava različite tipove platnih operacija, zavisno od poslovnog modela i potreba:

Authorization (Autorizacija)

Standardni model plaćanja gde se novac odmah prebacuje sa kartice kupca na račun trgovca.

Tok:

1. Kupac unosi podatke kartice
2. Sistem šalje zahtev banci za autorizaciju
3. Banka odobrava ili odbija transakciju
4. Ako je odobreno, novac se prebacuje na račun trgovca (clearing 1-3 dana)

Pre-Authorization (Pre-autorizacija)

Prvi korak u dvostepenom modelu plaćanja koji omogućava rezervaciju sredstava.

Karakteristike:

• Novac se rezerviše (blokira) na kartici kupca
• Ne dolazi do prenosa novca
• Kupac ne može koristiti rezervisana sredstva
• Rezervacija ima rok trajanja (obično 7 dana)

Kada koristiti:

• Kada roba nije odmah dostupna (rezervacija)
• Kada se konačna cena može promeniti (npr. po težini, dodatne usluge)
• Kod usluga gde se naknadno određuje tačan iznos
• Hoteli, rent-a-car agencije, depoziti itd.

Post-Authorization / Capture (Post-autorizacija)

Drugi korak u dvostepenom modelu - izvršavanje stvarnog prenosa novca nakon rezervacije.

Karakteristike:

• Izvrši se stvarni prenos novca sa rezervisanih sredstava
• Može biti za pun iznos ili manji (parcijalno naplaćivanje)
• Mora se izvršiti pre isteka roka rezervacije
• Neki gateway-i podržavaju više uzastopnih capture-a dok god je suma ≤ rezervisanog iznosa

VOID (Poništenje)

Operacija koja poništava transakciju pre nego što banka izvrši clearance.

Upotreba:

• Poništenje pre-autorizacije - oslobađa rezervisana sredstva na kartici kupca
• Poništenje autorizacije - moguće samo u roku od nekoliko sati nakon transakcije

Prednosti:

• Obično nema provizije (za razliku od refund-a)
• Brže oslobađanje sredstava za kupca
• Čistija transakciona istorija

REFUND (Povraćaj novca)

Operacija koja vraća novac kupcu nakon što je transakcija već izvršena i clearing završen.

Karakteristike:

• Može biti potpuni ili parcijalni povraćaj
• Obično ima proviziju
• Novac se vraća na istu karticu/način plaćanja sa koje je plaćeno
• Proces može trajati 3-10 dana
• Neke metode ne podržavaju parcijalnu refundaciju

Status Query (Upit statusa)

Operacija provere statusa transakcije direktno kod payment gateway-a.

Kada koristiti:

• Ako sumnjate da status nije sinhronizovan
• Nakon tehničkih problema u komunikaciji
• Ako kupac tvrdi da je platio a sistem ne pokazuje plaćanje
• Za verifikaciju nejasnih stanja

2.2. HolestPay status format

HolestPay koristi kompleksan format statusa koji objedinjuje statuse svih modula (plaćanje, fiskalizacija, dostava). Ovo je najmerodavniji status koji treba koristiti u radu.

Format HolestPay statusa:

Važna pravila:

• REDOSLED SEKCIJA JE VAŽAN: PAYMENT → FISCAL & INTEGRATION → SHIPPING
• Redosled metoda unutar iste sekcije NIJE važan
• JEDAN JEDINI PRAZAN KARAKTER kao separator između sekcija
• PAYMENT sekcija može ne postojati ako ne koristite HolestPay payment module ili ako ga ne postavljate eksplicitno
• FISCAL & INTEGRATION sekcije: Moduli mogu dodati status kao <module-uid>_FISCAL:<status> ili <module-uid>_INTEGR:<status>. Važno: Neki moduli ne dodaju nikakav status u HolestPay format
• SHIPPING sekcije postoje samo ako postoje paketi koje HPay shipping moduli upravljaju

Mogući payment statusi:

Primeri HolestPay statusa:

Objašnjenje: Plaćanje završeno, fiskalni modul dodao status "sale", paket dostavljen

Objašnjenje: Pre-autorizacija, čeka se capture

Objašnjenje: Plaćeno, fiskalni modul (_FISCAL) dodao status "sale", integracioni modul (_INTEGR) dodao status "uploaded", paket u pripremi

Objašnjenje: Plaćeno i isporučeno. Fiskalni modul je konfigurisan ali ne dodaje status u HolestPay format

Objašnjenje: Samo integracioni modul sa statusom 97, bez payment i shipping modula

3. Preduslovi i početna podešavanja

3.1. Kreiranje korisničkog naloga

Pre korišćenja HolestPay sistema, potrebno je kreirati korisnički nalog na odgovarajućem okruženju:

Slika 2: Ekran za prijavljivanje na HolestPay sistem

1. Posetite web stranicu: https://sandbox.pay.holest.com/ (za testiranje) ili https://pay.holest.com/ (za produkciju)
2. Kliknite na opciju "Registruj se"
3. Popunite podatke:
   • Ime i prezime
   • Email adresa (koristi se za prijavljivanje)
   • Lozinka (mora zadovoljiti sigurnosne zahteve)
   • Potvrda lozinke
4. Označite opciju za postavljanje biometrijske/WebAuthn zaštite identiteta (preporučeno)
5. Kliknite "Registruj se"

Slika 3: Forma za registraciju novog korisnika

3.2. Višefaktorska autentifikacija (MFA)

HolestPay zahteva višefaktorsku autentifikaciju (Multi-Factor Authentication) za sve korisnike. Ovo je obavezna sigurnosna mera koja štiti vaš nalog.

Slika 4: Ekran za unos sigurnosnog koda (MFA)

Podržani MFA metodi:

• PIN - Lični identifikacioni broj
• SMS - Kod poslat putem SMS poruke (pod uslovom da ste uneli telefon u profilu)
• EMAIL - Kod poslat na email adresu
• BIOMETRIC - Otisak prsta ili prepoznavanje lica (WebAuthn)

Proces MFA verifikacije:

1. Unesite email i lozinku
2. Sistem će poslati sigurnosni kod na email ili telefon
3. Unesite primljeni kod u polje "SIGURNOSNI KOD"
4. Sistem će vas prijaviti nakon uspešne verifikacije

3.3. Kreiranje kompanije

Proces kreiranja kompanije (za prvog korisnika - osnivača):

1. Prijavite se na HolestPay panel
2. U levom meniju odaberite opciju "FIRMA" (Company)
3. Kliknite na dugme "Dodaj novu firmu" (Create a company)
4. Unesite podatke o kompaniji:
   • Naziv kompanije
   • PIB (Poreski identifikacioni broj)
   • Matični broj
   • Adresa
   • Kontakt telefon
   • Logotip kompanije (opciono)
5. Sačuvajte podatke
6. Automatski dobijate ulogu "Owner" za ovu kompaniju

Slika 5: Lista kompanija kojim korisnik upravlja

3.4. Upravljanje korisnicima

Ako više osoba treba da ima pristup HolestPay panelu, možete im dodeliti odgovarajuće uloge:

Uloge korisnika:

• Owner (Vlasnik) - Potpuna kontrola nad kompanijom i mogućnost prenosa vlasništva. Kreira se automatski za korisnika koji je kreirao kompaniju. Samo jedan nalog može imati Owner ulogu za kompaniju.
• Administrator - Pristup svim funkcijama osim upravljanja vlasnikom. Može postati Owner ako mu trenutni Owner prenese vlasništvo.
• Operator (Staff/Osoblje) - Ograničen pristup samo operativnim funkcijama

Dodavanje novog korisnika:

1. Novi korisnik prvo mora kreirati svoj nalog na HolestPay platformi
2. U Company podešavanjima, idite na sekciju "Users"
3. Kliknite "Add user"
4. Unesite email adresu korisnika
5. Dodelite odgovarajuću ulogu (Administrator ili Operator)
6. Sačuvajte

3.5. Kreiranje POS-a (Sajt ili Aplikacija)

Svaka kompanija može imati više POS-ova (sajtova, Android/iOS aplikacija):

1. U levom meniju odaberite "SAJTOVI/APLIKACIJE/SplitPay"
2. Kliknite "Dodaj novi POS"
3. Izaberite tip POS-a:
   • Website / E-commerce
   • Android App
   • iOS App
   • Desktop aplikacija
4. Unesite podatke:
   • Naziv POS-a
   • URL ili identifikator aplikacije
   • Opis (opciono)
5. Sačuvajte

Slika 6: Lista POS-ova (Sajtovi/Aplikacije) za kompaniju

4. Metode plaćanja

HolestPay podržava različite metode plaćanja koje se mogu konfigurisati prema potrebama vašeg poslovanja. Dostupnost pojedinih metoda zavisi od tipa pretplate koju imate.

Slika 7: Primer liste metoda plaćanja za POS

4.1. Tipovi metoda plaćanja

Kartična plaćanja

Karakteristike:

• 3D Secure autentifikacija za povećanu bezbednost
• Podrška za pre-autorizaciju i odloženo naplaćivanje
• Mogućnost plaćanja na rate kroz banku
• PCI DSS ver 4.0.1 usklađenost
• Različiti payment gateway-i podržavaju različite opcije (npr. neke ne podržavaju parcijalnu refundaciju)

IPS Mobilna plaćanja

Instant Payment System - Plaćanje putem:

• Skeniranja QR koda
• Unosa broja telefona povezanog sa bankovnim računom

Prednosti:

• Trenutne transakcije
• Nema troškova za kupca
• Niže provizije za trgovca

Uplatnica sa NBS QR kodom

Automatsko generisanje uplatnice koja sadrži:

• NBS QR kod za mobilno plaćanje
• Sve potrebne podatke za plaćanje preko banke
• Jedinstvenu identifikaciju plaćanja

Karakteristike:

• Mogućnost uvoza jutarnjeg izvoda banke za automatsko uparivanje plaćanja
• Pogodno za kupce bez platnih kartica

Plaćanje na rate

Omogućava kupcima plaćanje u mesečnim ratama kroz banku:

• Različit broj rata (npr. 3, 6, 12, 24 meseci)
• Kamatne stope definiše banka
• Trenutna provera podobnosti kupca

5. Metode dostave

HolestPay omogućava integraciju sa različitim kurirskim službama i kompletno upravljanje procesom dostave.

Slika 8: Primer liste metoda dostave

Funkcionalnosti shipping modula:

• Automatsko kreiranje pošiljki
• Generisanje etiketa za pakete
• Praćenje statusa dostave
• Upravljanje sa više magacina/skladišta
• Podrška za više paketa po narudžbini
• Automatsko obaveštavanje kupaca

Uređivanje podataka za dostavu

Prilikom kreiranja ili uređivanja pošiljke, možete prilagoditi sve podatke koji se šalju kuriru:

Slika 8a: Forma za uređivanje podataka koji se šalju kurirskoj službi - omogućava potpunu kontrolu nad informacijama o pošiljci

Forma omogućava uređivanje:

• Podaci primaoca: Ime, prezime, kontakt telefon, email
• Adresa dostave: Ulica, broj, sprat, grad, poštanski broj, država
• Detalji pošiljke: Težina, dimenzije, opis sadržaja
• Tip usluge: Standardna dostava, ekspresna, otkup (cash on delivery), itd.
• Posebne instrukcije: Napomene za kurira ili primaoca
• Vrednost pošiljke: Za potrebe osiguranja i carinske deklaracije

5.1. Statusi dostave

Svaki paket ima oznaku u formatu:

Primer:

Lista statusa:

6. Fiskalizacija i integracije

HolestPay pruža napredne mogućnosti fiskalizacije i integracije sa poslovnim sistemima.

Slika 9: Primer liste fiskalnih i integracionih metoda

6.1. E-Fiscal RS (Elektronska fiskalizacija - Srbija)

Automatska integracija sa sistemom Poreske uprave Republike Srbije za izdavanje elektronskih fiskalnih računa.

Slika 10: Primer elektronskog fiskalnog računa sa QR kodom

Mogućnosti:

• Automatsko ili ručno izdavanje fiskalnih računa
• Slanje fiskalnih računa kupcima putem email-a
• Čuvanje svih fiskalnih dokumenata
• QR kod za verifikaciju na svakom računu
• Kompatibilnost sa Zakonom o fiskalnim kasama
• Dodaje status u HolestPay format kao efiscalrs_FISCAL:<status>

6.2. Tipovi fiskalnih dokumenata

Fiskalni račun za prodaju (Fiscal Sale)

Kada se izdaje:

• Nakon što je plaćanje završeno
• Kada je roba predata kupcu (optimalno)
• U roku od 24h od momenta prodaje (zakonski minimum)

Sadrži:

• Detalje o robi/uslugama
• Cene sa i bez PDV-a
• Podatke o prodavcu
• Datum i vreme
• Jedinstveni ESIR broj
• QR kod za proveru

Fiskalni račun za povraćaj (Fiscal Refund)

Kada se izdaje:

• Kada kupac vraća robu i traži povraćaj novca
• Mora biti referenca na originalni račun prodaje

Obavezno:

• Identifikacija kupca (TIN - Tax Identification Number)
• PIB, JMBG ili drugi validni identifikacioni broj

Storno računa (Fiscal Recall)

Kada se koristi:

• Kada je napravljena greška pri izdavanju računa
• Kada kupac zahteva povraćaj novca ali odbija da pruži lične podatke (čest slučaj)
• Poništava originalni račun

Karakteristike:

• Ne zahteva TIN identifikaciju kupca
• Ustavno pravo na privatnost je jače od fiskalnog zakona, pa je dozvoljen umesto refund-a
• Praktično se koristi najčešće za povraćaje novca

Avansni račun (Fiscal Advance)

Kada se koristi:

• Kupac plaća deo cene unapred (npr. 30% rezervacija)
• Za naručivanje robe ili započinjanje proizvodnje
• Da bi se izbegli veći porezi pre prijema punog iznosa

Proces:

1. Izdaje se avansni račun za primljeni iznos
2. Mogu se izdati dodatni avansni računi (svaki referencira prethodni)
3. Konačni račun prodaje referencira sve avanse

Obavezno: TIN identifikacija kupca

Predračun / Profaktura (Fiscal Proforma)

Kada se koristi:

• Za davanje ponude kupcu
• Za jasniju evidenciju transakcija
• Opciono - ne utiče direktno na poreze

Proces:

• Izdaje se proforma
• Kupac kasnije plaća
• Izdaje se finalni račun prodaje koji referencira proformu (Tax Invoice Id)

Obavezno: TIN identifikacija kupca

6.3. PIB i TIN identifikacija

Za fiskalne povraćaje, avanse i profakture obavezno je identifikovanje kupca preko TIN-a (Tax Identification Number).

Format TIN-a:

Podržani prefiksi:

6.4. Druge fiscal & integration integracije

Tipovi fiscal & integration modula:

1. Elektronsko fakturisanje i fiskalizacija

Moduli za integraciju sa poreskim sistemima različitih zemalja. Automatsko kreiranje i slanje fiskalnih računa, faktura, i drugih dokumenata prema lokalnim propisima.

2. Izvoz narudžbina (FTP/SFTP/API)

Moduli za automatski eksport narudžbina ka eksternim sistemima:

• Eksport u različitim formatima (XML, JSON, CSV, custom)
• Konfigurabilni trigeri (status plaćanja, dostave, itd.)
• Korisno za integraciju sa skladišnim, ERP i book-keeping sistemima

3. Book-keeping software integracije

Moduli za dvosmeru integraciju sa računovodstvenim softverima:

• Automatska sinhronizacija narudžbina
• Sinhronizacija proizvoda, zaliha i cena
• Generisanje izvještaja

4. Data feed moduli

Omogućavaju dostupnost podataka o narudžbinama putem različitih feed formata.

5. Notifikacioni moduli

Specijalizovani moduli za slanje notifikacija (push, SMS, email) u specifičnim scenarijima.

6. Custom integracije

HolestPay podržava razvoj custom fiscal & integration modula za specifične potrebe vašeg poslovanja putem API-ja.

7. Backend operacije sa narudžbinama

HolestPay omogućava upravljanje svim aspektima narudžbina na dva načina:

1. Direktno na vašem sajtu - preko gotovih modula (WooCommerce, Magento, OpenCart, VirtueMart, Shopify...)
2. U HolestPay panelu - centralno upravljanje svim POS-ovima

HolestPay integracija na vašem sajtu

Slika 11: HolestPay sekcija u detaljima narudžbine na sajtu (WooCommerce primer) - sve operacije dostupne direktno u vašem admin panelu

Kada koristite gotov modul (WooCommerce, Magento, OpenCart, VirtueMart, Shopify...), u detaljima svake narudžbine vidite HolestPay box koji prikazuje:

• HolestPay status - pun status u HolestPay formatu (PAYMENT, FISCAL, SHIPPING)
• Platne operacije - dugmići za Status Query, Sync on POS, VOID, Refund, Capture, itd.
• Fiskalne operacije - izdavanje fiskalnog računa, storno, refund, itd.
• Shipping operacije - kreiranje pošiljke, štampanje etikete, praćenje statusa za svakog kurira
• "Manage on HolestPay..." dugme - brz prelazak na HolestPay panel

Upravljanje preko HolestPay panela

Slika 12: Lista narudžbina u HolestPay panelu sa statusima i dostupnim opcijama

Slika 13: Detalji narudžbine u HolestPay panelu sa dostupnim operacijama

HolestPay panel omogućava centralno upravljanje narudžbinama sa svih vaših POS-ova (sajtova/aplikacija). Koristan je za:

• Pregled svih narudžbina sa više POS-ova na jednom mestu
• Napredne opcije koje nisu dostupne u osnovnim modulima
• Administraciju sistema, podešavanje metoda plaćanja, dostave, fiskalizacije
• Detaljne izvještaje i analitiku

7.1. Operacije vezane za plaćanje

Status Query (Upit statusa)

Funkcija: Ponovo proverava status transakcije direktno kod payment gateway-a.

Kada koristiti:

• Ako sumnjate da status nije sinhronizovan
• Nakon tehničkih problema u komunikaciji
• Ako kupac tvrdi da je platio a sistem ne pokazuje plaćanje

Capture (Post-autorizacija)

Funkcija: Izvršava naplaćivanje nakon pre-autorizacije.

Napomena:

• Iznos može biti manji ili jednak rezervisanom iznosu
• Mora se izvršiti pre isteka rezervacije (obično 7 dana)
• Neki payment gateway-i podržavaju više capture operacija

VOID (Poništenje)

Funkcija: Poništava transakciju pre nego što banka izvrši clearance.

Kada je dostupno:

• Za pre-autorizaciju - bilo kada pre isteka rezervacije
• Za autorizaciju - samo u prvih nekoliko sati

Prednost: Obično ne postoji provizija (za razliku od refund-a)

REFUND (Povraćaj novca)

Funkcija: Vraća novac kupcu nakon što je transakcija izvršena i clearance završen.

Karakteristike:

• Može biti potpun ili parcijalan povraćaj (ako metoda podržava)
• Obično ima proviziju
• Proces traje 3-10 dana
• Neke kartične metode ne podržavaju parcijalnu refundaciju

Napomena: Nakon izvršenja refund-a, potrebno je kreirati odgovarajući fiskalni dokument (refund ili storno).

Send Payment Link (Slanje linka za plaćanje) - PAY-BY-LINK

Funkcija: Kreira i šalje link kupcu za završavanje plaćanja van vašeg sajta (offsite opcija).

Korisno za:

• Neuspela plaćanja koja kupac želi da ponovi
• Manualno kreiranje narudžbina (telefonom, emailom)
• Slanje plaćanja putem druge komunikacije (Email, SMS, WhatsApp, Viber, itd.)
• Narudžbine kreirane van sajta koje zahtevaju online plaćanje
• Dopune/doplata za postojeće narudžbine

Kako funkcioniše:

1. U HolestPay panelu (ili preko API-ja) kreirate link za plaćanje
2. Unesete iznos, opis, podatke kupca
3. Sistem generiše jedinstveni link
4. Pošaljete link kupcu bilo kojim kanalom
5. Kupac klikom otvara stranicu za plaćanje (hosted by HolestPay)
6. Kupac završava plaćanje
7. Vi dobijate notifikaciju o rezultatu

7.2. Operacije vezane za dostavu

Create Shipment (Kreiranje pošiljke)

Funkcija: Kreira pošiljku i dobija tracking broj od kurirske službe.

Potrebni podaci:

• Broj paketa
• Težina
• Dimenzije (opciono)
• Sadržaj (opciono)
• Vrednost pošiljke
• Napomene za kurira

Print Label (Štampanje etikete)

Funkcija: Generiše i štampa etiketu za paket.

Etiketa sadrži:

• Barcode / QR kod za praćenje
• Adresu primaoca
• Adresu pošiljaoca
• Tracking broj
• Instrukcije za dostavu

Submit to Courier (Slanje kurirskoj službi)

Funkcija: Šalje zahtev kurirskoj službi da preuzme paket.

Status menja iz: READY → SUBMITTED

Cancel Shipment (Otkazivanje pošiljke)

Funkcija: Otkazuje pošiljku pre ili nakon slanja kuriru.

Napomena: Moguće otkazivanje zavisi od politike kurirske službe i trenutnog statusa pošiljke.

7.3. Operacije fiskalizacije

Issue Fiscal Receipt (Izdavanje fiskalnog računa)

Funkcija: Izdaje fiskalni račun za prodaju.

Kada: Nakon što je plaćanje uspešno završeno.

Parametri: Nema dodatnih parametara

Fiscal Refund (Fiskalni povraćaj)

Funkcija: Izdaje fiskalni račun za povraćaj robe.

Obavezni parametri:

• TIN kupca (prefiks:vrednost, npr. 10:105677555)
• Iznos povraćaja (može biti parcijalan)

Napomena: Automatski povezuje sa originalnim računom prodaje.

Fiscal Recall (Storno računa)

Funkcija: Stornira prethodno izdat račun.

Kada koristiti:

• Greška pri izdavanju računa
• Povraćaj novca kada kupac odbija da da lične podatke

Parametri: Nema dodatnih parametara - TIN nije potreban

Fiscal Advance (Avansni račun)

Funkcija: Izdaje avansni račun za delimično plaćanje.

Obavezni parametri:

• TIN kupca
• Iznos avansa

Fiscal Proforma (Predračun)

Funkcija: Izdaje predračun koji ne utiče na poreze.

Obavezni parametri:

• TIN kupca

Send Fiscal by Email (Slanje fiskalnog računa)

Funkcija: Ponovo šalje fiskalni račun kupcu na email.

Korisno kada:

• Kupac nije primio email
• Kupac je izgubio račun
• Treba poslati na drugu email adresu

Sync on POS

Funkcija: Re-send rezultata na vaš sajt/aplikaciju

Kada koristiti: Kada želite da ručno osvežite podatke na vašem POS-u

8. Proces kupovine (korisnički tok)

Standardni tok plaćanja (isti za sve metode):

1. Iniciranje plaćanja - Kupac bira proizvode na vašem sajtu i izabere metodu plaćanja na checkout stranici
2. Prezentovanje input forme - Sistem prikazuje formu za unos podataka specifičnih za izabranu metodu (detalji kartice, QR kod, uplatnica, itd.)
3. Obrada rezultata - Payment gateway obrađuje transakciju i vraća rezultat
4. Pozivanje fiskalnih i shipping metoda - Nakon uspešnog plaćanja, automatski se pozivaju konfigurisane fiskalne i shipping metode
5. Prikaz rezultata - Kupac vidi rezultat transakcije (uspešno/neuspešno), detalje plaćanja, fiskalni račun i informacije o dostavi

Manualno pozivanje metoda

9. Pay-by-Link - Plaćanje putem linka

Pay-by-Link je funkcionalnost koja omogućava kreiranje jedinstvenog linka za plaćanje koji možete poslati kupcu. Postoje dve verzije:

9.1. Offsite Pay-by-Link (HolestPay Panel)

Kreiranje linka direktno u HolestPay panelu - kupac plaća na HolestPay hosted stranici.

Slika 12: Forma za kreiranje Pay-by-Link linka u HolestPay panelu

Kako kreirati:

1. U HolestPay panelu, otvorite Order ili Transaction sekciju
2. Kliknite na opciju "Create Pay-by-Link" ili sličnu opciju
3. Unesite detalje narudžbine:
   • Iznos plaćanja
   • Opis narudžbine / proizvoda
   • Podaci kupca (ime, email, telefon, adresa)
   • Stavke narudžbine (opciono)
4. Izaberite dostupne platne metode koje kupac može koristiti
5. Ako postoji isporuka, izaberite dostupne metode isporuke koje kupac može odabrati
6. Podesite rok važenja ponude (link će biti aktivan do određenog datuma/vremena)
7. Izaberite opciju slanja notifikacije (opciono):
   • Email notifikacija - uključena u sistem
   • SMS notifikacija - tarifira se po važećem cenovniku
8. Kliknite na jedno od dva dugmeta:
   • "Sačuvaj" - samo kreira link, bez slanja notifikacija
   • "Sačuvaj i obavesti" - kreira link i automatski šalje Email (i SMS ako je izabran) kupcu
9. Sistem kreira jedinstveni link koji možete kopirati i poslati kupcu (ako niste koristili "Sačuvaj i obavesti")

Kada kupac otvori link:

• Vidi HolestPay hosted stranicu sa detaljima narudžbine
• Bira željenu platnu metodu iz ponuđenih opcija
• Ako postoji isporuka, bira metodu isporuke
• Unosi potrebne podatke za plaćanje
• Završava plaćanje

Kada koristiti offsite Pay-by-Link:

• Narudžbine primljene telefonom, emailom ili društvenim mrežama
• Kupac nema pristup vašem sajtu u tom trenutku
• Slanje ponude koja ima rok važenja
• Dopuna/doplata postojeće narudžbine
• Slanje računa za usluge
• Bilo koja situacija gde želite brzo kreirati link za plaćanje bez da kupac ide na vaš sajt

9.2. On-site Pay-by-Link (WooCommerce i drugi moduli)

Neki platformski moduli (kao WooCommerce) imaju on-site Pay-by-Link opciju koja funkcioniše slično, ali sa važnom razlikom:

Razlika:

• Offsite (HolestPay panel): Kupac plaća na HolestPay hosted stranici - treba uneti sve detalje ručno u panelu
• On-site (WooCommerce): Link vodi kupca na standardni checkout vaše platforme (vaš sajt) - koristi postojeću WooCommerce narudžbinu

Kako funkcioniše on-site Pay-by-Link:

1. Narudžbina već postoji u vašem WooCommerce sistemu
2. U HolestPay box-u u order details kliknete "Send Payment Link"
3. Link vodi kupca direktno na checkout stranicu vašeg sajta za tu narudžbinu
4. Kupac završava plaćanje kroz vaš standardni checkout proces

Prednosti on-site verzije:

• Kupac ostaje na vašem brendiranom sajtu
• Ne morate ručno unositi detalje narudžbine - narudžbina već postoji u sistemu
• Koristi sve vaše postojeće WooCommerce postavke i dizajn
• Bolji brending i korisničko iskustvo

Prednosti offsite verzije:

• Brže kreiranje - direktno iz HolestPay panela bez potrebe za kreiranjem narudžbine na sajtu
• Radi i kada nemate platformski modul instaliran
• Može se koristiti i za usluge koje nisu vezane za e-commerce platformu
• Idealno za telefonske narudžbine i brze ponude

Praćenje narudžbine

Način praćenja narudžbine zavisi od implementacije na vašem sajtu/aplikaciji. Obično uključuje:

• Email notifikacije
• Stranicu za praćenje statusa
• Korisničku podršku

10. Pomoć i dokumentacija

HolestPay sistem sadrži ugrađenu sekciju za pomoć sa korisnim priručnicima i primerima.

Slika 14: Sekcija Pomoć sa dokumentima i priručnicima

Tipovi dostupne dokumentacije:

• Payment method priručnici - Za konfigurisane platne metode i gateway-e
• Shipping method priručnici - Za konfigurisane metode dostave
• Fiscal & Integration priručnici - Za fiskalne i integracione module
• Platformski moduli - Priručnici za instalaciju i korišćenje modula za različite platforme
• API dokumentacija - Za custom integracije i razvoj
• Terms of Service uzorci - Primeri ugovora i pravnih dokumenata
• Praktični primeri - Kod primeri i best practice implementacije

Kako pristupiti dokumentaciji:

1. U levom meniju HolestPay panela kliknite na "POMOĆ" (ili ikonu sa upitnikom)
2. Izaberite kategoriju dokumentacije koja vas interesuje
3. Kliknite na link dokumenta koji želite da pregledate
4. Dokument će se otvoriti u novom tabu ili preuzeti

11. Platformski moduli i integracija

HolestPay se može integrisati sa vašom platformom na više načina:

Slika 15: Primer liste dostupnih platformskih modula

Tipovi integracije:

1. Gotovi platformski moduli (plugin/ekstenzija)

HolestPay nudi gotove module za popularne e-commerce i CMS platforme. Lista dostupnih modula se konstantno proširuje.

Karakteristike gotovih modula:

• Full-featured moduli - Kompletna integracija koja dodaje HolestPay operacije direktno u admin panel vaše platforme. Komande izvršavaju identične procedure kao na HolestPay panelu.
• Mini varijante - Lakša verzija koja dodaje osnovnu funkcionalnost i linkove ka HolestPay panelu.
• Status kolone - Neki moduli dodaju kolonu sa HolestPay statusom u listi narudžbina.

2. JavaScript/HTML integracija

Za custom platforme ili direktnu web integraciju:

• HTML sa embedded credentials - Stranica sa ugrađenim POS kredencijalima, početna tačka za integraciju
• HPay-FrontCore - JavaScript biblioteka sa automatskim potpisivanjem
• Custom JavaScript implementacija - Koristeći HolestPay JavaScript SDK

3. API integracija

Za potpunu kontrolu i prilagođenu integraciju:

• RESTful API - Kompletna funkcionalnost dostupna preko API-ja
• Webhook podrška - Real-time notifikacije o promenama statusa
• Detaljana dokumentacija - API referenca sa primerima
• Biblioteke za različite jezike - PHP, Python, Node.js, itd.

Primer - HolestPayPHP biblioteka:

Kako odabrati način integracije:

12. Uređivanje email templejta

HolestPay omogućava potpunu personalizaciju email poruka koje sistem šalje kupcima. Ova podešavanja se nalaze u sekciji podešavanja POS-a.

Slika X: Lista dostupnih email templejta za prilagođavanje

12.1. Dostupni templejti

U sekciji email templejta možete videti sve dostupne templejte koje možete prilagoditi. Svaki templejt služi za specifičnu svrhu u toku procesa plaćanja i narudžbine.

12.2. Proces uređivanja templejta

Uređivanje email templejta se odvija u tri koraka:

Korak 1: Izbor templejta

1. U HolestPay panelu, idite na podešavanja POS-a
2. Pronađite sekciju "Mail Templates"
3. Iz liste izaberite templejt koji želite da izmenite

Korak 2: Izbor testnih podataka

Pre nego što počnete sa uređivanjem, potrebno je izabrati testne podatke:

Slika X+1: Izbor postojeće narudžbine ili liste narudžbina za testne podatke

• Ako templejt važi za jednu narudžbinu - izaberite postojeću narudžbinu iz liste
• Ako templejt važi za više narudžbina - izaberite listu narudžbina
• Testni podaci omogućavaju da vidite kako će email izgledati sa pravim podacima dok ga uređujete

Korak 3: Uređivanje u editoru

Slika X+2: Editor za uređivanje email templejta sa live preview funkcijom

Editor je podeljen u tri panela sa live preview funkcijom:

Leva strana editora:

• Gore-levo: Liquid kod - Ovde pišete i uređujete Liquid templejt kod sa HTML i CSS stilovima
• Dole-levo: Testni podaci - JSON podaci iz izabrane narudžbine ili liste narudžbina koje možete pregledati i koristiti u templejtu

Desna strana editora - Preview panel:

• Tab "HTML prikaz" - Prikazuje kako će email stvarno izgledati kupcu (renderovan HTML sa stilovima)
• Tab "Raw output" - Prikazuje čist HTML kod koji će biti generisan (korisno za debugging)

Live preview funkcionalnost:

• Svaka izmena u Liquid kodu (gore-levo) automatski ažurira preview (desno) u realnom vremenu
• Svaka izmena u testnim podacima (dole-levo) takođe odmah ažurira preview
• Ne morate da klikćete "refresh" ili "preview" - sve se dešava automatski dok kucate
• Možete trenutno videti kako će izgledati email sa pravim podacima

Dodatne mogućnosti:

• Liquid templejt jezik - Siguran za upotrebu (one-way rendering bez izvršavanja koda)
• Dostupne promenljive - Lista svih promenljivih koje možete koristiti u templejtu (npr. ime kupca, iznos narudžbine, broj narudžbine, itd.)
• HTML i CSS - Potpuno prilagođavanje dizajna, boja, fontova i stilizovanja
• Brending - Dodavanje logotipa, boja kompanije i kompletna personalizacija

12.3. Liquid templejt jezik

Liquid je templejt jezik koji se koristi za sigurno prilagođavanje email poruka:

• Siguran - One-way rendering bez mogućnosti izvršavanja proizvoljnog koda
• Jednostavan - Intuitivna sintaksa za prikazivanje promenljivih i uslova
• Moćan - Podržava filtre, petlje, uslove i druge programske konstrukcije

Primeri Liquid sintakse:

12.4. Sačuvavanje izmena

Nakon što završite sa izmenom templejta:

1. Pregledajte kako izgleda u preview-u sa testnim podacima
2. Testirajte sa različitim testnim podacima ako je potrebno
3. Proverite da li je prva linija pravilno formatirana za Subject email-a
4. Kliknite "Sačuvaj" da primenite izmene
5. Novi templejt će se odmah koristiti za sve buduće email poruke tog tipa

13. Podrška i kontakt

Tehnička podrška

Za sva pitanja, probleme ili pomoć vezanu za HolestPay sistem:

• Email: support@holest.com
• Web: https://pay.holest.com/ ili https://sandbox.pay.holest.com/
• Product info: https://ecommerce.holest.com/proizvod/holestpay/

Dostupnost podrške

Tehnička podrška je dostupna u radnim danima:

• Ponedeljak - Petak: 09:00 - 17:00 (CET)

Kako zatražiti pomoć

Kada kontaktirate podršku, pripremite sledeće informacije:

1. Opis problema - što detaljnije
2. Kada se problem dogodio - datum i vreme
3. Narudžbina ID ili transakcija ID - ako je vezano za konkretnu transakciju
4. Screenshot-ovi - ako je moguće
5. Koraci za reprodukovanje - kako da ponovimo problem
6. Ime kompanije i POS-a - da možemo brže locirati vaš nalog

Dokumentacija i resursi

Dodatna dokumentacija, API referenca i video tutorijali dostupni su:

• Na HolestPay panelu - sekcija "POMOĆ"
• Kontaktiranjem podrške za pristup developer dokumentaciji
• Na web sajtu: https://ecommerce.holest.com/proizvod/holestpay/

Sandbox okruženje za testiranje

Pre implementacije u produkciju, preporučujemo testiranje u sandbox okruženju:

• Sandbox URL: https://sandbox.pay.holest.com/
• Potpuno besplatan
• Sve funkcionalnosti su otključane
• Koristi testne payment gateway-e
• Testne kartice dostupne u "Komandna tabla" sekciji

Pretplate i cene

Za informacije o pretplatama, cenama i dostupnim paketima:

• Kontaktirajte sales@holest.com
• Ili proverite na https://ecommerce.holest.com/proizvod/holestpay/

Status sistema

Za proveru statusa HolestPay servisa u realnom vremenu:

• Proverite status stranicu (URL će vam biti dostavljen od podrške)
• Ili se prijavite za notifikacije o incidentima

Sigurnosni incidenti

Ako sumnjate na sigurnosni incident ili otkrijete ranjivost:

• Odmah kontaktirajte: support@holest.com
• Nemojte deliti detalje javno pre nego što problem bude rešen

Feature zahtevi i feedback

Vaš feedback je važan! Ako imate sugestije za nove funkcionalnosti:

• Pošaljite email na office@holest.com
• Ili koristite feedback opciju u panelu