WebPay korisnička dokumentacija
Upute za korištenje servisa - upravljanje transakcijama, korisnicima, izvještajima
Testni period rada na WebPay servisu
Koraci kojima se testiranjem dolazi do produkcijske instance tvrtke:
- ispuniti i zaključiti Ugovor o procesiranju transakcija nastalih plaćanjem karticama putem interneta
- korisnik dobiva podatke o testnim karticama, testnu instancu tvrtke i prodajnog mjesta, te korisničko ime i zaporku za administratorski pristup istima na adresi https://test.webpay.cc/login
- korisnik napravi integraciju svog prodajnog mjesta na testni sustav
- korištenjem testnih kartica, provjerava se je li integracija uspješno učinjena (autorizacija transakcija, predautorizacija transakcija, 3-D secure integracija, potvrda transakcija, poništenje transakcija,...)
- provjera zadovoljava li korisnička aplikacija (web dućan) standarde koje su propisale kartične kuće navedene u ovom dokumentu
- nakon uspješnog postavljanja prodajnog mjesta, korisnik dobiva instancu tvrtke i prodajnog mjesta s produkcijskim parametrima, te korisničko ime i zaporku za administratorski pristup istima na adresi https://secure.webteh.hr/login
NAPOMENA: Testne kartice služe isključivo za izvršavanja plaćanja unutar prodajnih mjesta koja se nalaze na testnom Webtehovom serveru, a pristupa im se putem https://test.webpay.cc/login. Testne kartice nije moguće koristiti u produkcijskom načinu rada, tj. ako se prodajno mjesto nalazi na https://secure.webteh.hr/login.
Prijava u sustav
Nakon unosa vaše tvrtke i pripadajućeg prodajnog mjesta u naš sustav šaljemo odgovornoj osobi korisnički račun sa svim ovlastima (administracijski account). Takav administracijski račun ima ovlasti mjenjati osnovne podatke o tvrtci i prodajnim mjestima kao i stvaranje novih prodajnih mjesta. Mogu se stvarati i novi korisnici te im se pridruživati određene ovlasti u okviru određenog prodajnog mjesta.
Adresa za prijavu u sustav je https://secure.webteh.hr/login.
Upravljanje korisnicima
Postoje dvije grupe korisnika i odgovarajuće uloge (uloge određuju privilegije) unutar tih grupa:
Upravljanje transakcijama
Nakon što kupac unese ispravne podatke u formu za plaćanje i potvrdi unos tih podataka, oni se šalju u banku na autorizaciju ili predautorizaciju.
Autorizirane transakcije su transakcije kod kojih se sredstva isti dan prebacuju na račun trgovca. Kod predautoriziranih transakcija sredstva se rezerviraju i tada trgovac može ta sredstva prebaciti na svoj račun ili ih osloboditi unutar 28 dana. Nakon 28 dana sredstva se automatski oslobađaju.
Autorizacije ili predautorizacije mogu biti uspješne ili neuspješne ovisno o tome ima li na kartici dovoljno sredstava, je li kartica ispravna, itd.
Autorizirane transakcije
Autorizirane transakcije vidljive su na listi zaključenih transakcija. Za ove transakcije moguće je vraćanje sredstava ili djelomično vraćanje sredstava.
Vraćanje sredstava je povrat ukupnih sredstava kupcu, a djelomično vraćanje sredstava je povrat djelomičnih sredstava kupcu.
U slučaju da se odabere bilo vraćanje sredstava ili djelomično vraćanje sredstava, transakcija se i dalje nalazi na listi zaključenih transakcija, ali nakon toga više nije moguće niti djelomično niti ukupno vraćanje sredstava.
Predautorizirane transakcije
Predautorizirane transakcije vidljive su na listi transakcija na čekanju. Ove transakcije moguće je potvrditi, poništiti ili potvrditi na manji iznos.
Ukoliko se predautorizirana transakcija potvrdi, rezervirana sredstva se prebacuju na račun trgovca i transakcija se automatski prebacuje na listu zaključenih transakcija. Ako se predautorizirana transakcija poništi, rezervirana sredstva na kartici kupca se oslobađaju i transakcija se automatski prebacuje na listu poništenih transakcija. U slučaju da se predautorizirana transakcija potvrdi na manji iznos, djelomičan iznos rezerviranih sredstava prebacuje se na račun trgovca i transakcija postaje zaključena.
Odbijene transakcije
U slučaju neuspješne autorizacije ili predautorizacije, podaci o transakciji se nalaze na jednoj od lista ovisno o razlogu neuspješne autorizacije: Odbijeno, Istekla kartica, Prekoračen limit, Mreža u kvaru, Greška u sustavu.
NAPOMENA: Sustav ne dozvoljava unos podataka za autorizaciju transakcije nakon što je ta transakcija odbijena 10 puta.
Postavke prodajnog mjesta
Postavke prodajnog mjesta određuju način rada i dodatne mogućnosti servisa. Postavke koje omogućuju ispravan rad servisa su nužne, ostale postavke su opcionalne.
Prilikom stvaranja novog prodajnog mjesta validatori se brinu da ove nužne postavke budu spremljene u sustav i svako novo dodano prodajno mjesto spremno je za prihvat transakcija. Ovo je naravno moguće samo ako unesene vrijednosti postavki odgovaraju stvarnosti; iako su formati postavki ispravni, njihove pogrešne vrijednosti mogu dovesti do neispravnog rada sustava u cjelini.
Neke postavke nisu odmah dostupne nakon što se stvori novo prodajno mjesto i potrebno ih je aktivirati da se pojave u formi za uređivanje prodajnog mjesta:
Nužne postavke
Ove postavke vidljive su nakon što kliknete na link za stvaranje novog prodajnog mjesta:
Podaci o prodajnom mjestu
Osnovne informacije prodajnog mjesta; uključuju naziv prodajnog mjesta, adresu, telefon, odgovornu osobu i dr.
API postavke
API postavke potrebno je uskladiti s vašom aplikacijom da bi integracija uopće bila moguća:
- domena - URL vaše aplikacije
- ključ - tajni ključ koji se koristi za provjeru identiteta
- postback - opcija za uključivanje povratne veze (samo za WebPay Form)
- debug način rada - ispisuju se poruka s greškama za krivo poslane zahtjeve, također su vidljive vrijednosti poslanih varijabli kao i detaljan opis validatora za polja WebPay forme (samo za WebPay Form, kod Direct varijante greške se ispisuju u XML odzivu)
Kartice
- ako je opcija Transakcije se moraju potvrditi uključena, sredstva na kartici kupca se samo rezerviraju te je za prebacivanje sredstava na račun trgovca potrebna dodatna potvrda administratora prodajnog mjesta; ako je opcija isključena, sredstva se odmah prebacuju na račun trgovca
- gateway postavke i 3-D secure postavke ispunjavamo mi nakon što dobijemo parametre od banke po sklapanju ugovora
Opcionalne postavke
Ove postavke potrebno je uključiti ako ih želite koristiti i nisu nužne za rad servisa u njegovom osnovnom načinu rada. Mogu se uključiti tek nakon što je stvoreno prodajno mjesto koristeći link Moduli.
Povratna veza
Postavke za preusmjeravanje kupca ako odustane od kupovine i kada uspješno obavi kupovinu.
- postback url: adresa na koju servis šalje HTTP POST zahtjev kada se dogodi autorizacija, služi za ažuriranje narudžbe na vašoj strani
- success url: adresa na koju se preusmjerava kupac nakon uspješne kupovine
- cancel url: adresa na koju se preusmjerava kupac ako odustane od kupovine
NAPOMENA: Ove postavke koriste se samo za WebPay Form varijantu servisa.
Obavijesti trgovcu
Moguće je odrediti do tri e-mail adrese na koju se šalje obavijest o uspješnoj autorizaciji. E-mail adresa pošiljatelja obavijesti o uspješnoj autorizaciji definirana je u postavkama prodajnog mjesta WebPay sustava pod Podaci o prodajnom mjestu -> E-mail.
Ukoliko želite ovu funkcionalnost morate upisati sadržaj zaglavlja i tijela e-mail poruke koja se šalje. Moguće je koristiti određeni skup rezerviranih riječi koje će biti zamjenjene odgovarajućim vrijednostima iz transakcije koja se procesira:
- FIRST_NAME - ime kupca
- LAST_NAME - prezime kupca
- ADDRESS - adresa kupca
- CITY - grad kupca
- ZIP - poštanski broj kupca
- COUNTRY - država kupca
- PHONE - telefon kupca
- EMAIL - email adresa kupca
- ORDER_NUMBER - broj narudžbe
- APPROVAL_CODE - broj odobrenja
- CART - sadržaj narudžbe
- CC_TYPE - vrsta kreditne kartice
- DATE - datum kupnje
- AMOUNT - iznos narudžbe
- DOMAIN - domena prodajnog mjesta
Primjer tako definirane poruke iz koje trgovac može saznati sve bitne podatke o transakciji možete preuzeti ovdje.
Obavijesti vlasniku kartice
Ukoliko je ova postavka uključena potrebno je odrediti zaglavlje i tijelo e-mail poruke koju će servis poslati kupcu nakon uspješne autorizacije. Mogu se koristiti rezervirane riječi koje su opisane u prethodnom poglavlju. E-mail adresa pošiljatelja obavijesti o uspješnoj autorizaciji definirana je u postavkama prodajnog mjesta WebPay sustava pod Podaci o prodajnom mjestu -> E-mail.
Vizualna prilagodba servisa
Ova opcija korisna je ako želite prilagoditi izgled WebPay forme svojim stranicama. Možete odrediti proizvoljno zaglavlje i podnožje u HTML-u i definirati svoje stilove u CSS-u. Svi form elementi i script tagovi se filtriraju.
Primjeri stranica s prilagođenom formom:
NAPOMENA: Slike moramo staviti na naš server jer svi elementi stranice s formom moraju biti zaštićene SSL protokolom. Adresa do vaših slika je https://secure.webteh.hr/images/ime_prodajnog_mjesta/ime_slike.
Košarica
Postavke za WebPay Cart. Potrebno je odrediti jezik za prikaz sučelja i valutu u kojoj se prodaju proizvodi i/ili usluge. Također je potrebno upisati ove informacije koje će biti dostupne kupcima putem linkova:
- uvjeti kupnje
- zaštita osobnih podataka
- pretvorba valute
