WSB eTomitreba je dodatak za Woocommerce koji omogućava online plaćanje kreditnim karticama putem sigurnog sučelja RBA banke. Nakon što potpišete ugovor s bankom, dobit ćete od njih testne i produkcijske podatke, certifikate i sve ostale detalje i informacije. Morat ćete kreirati privatni ključ u OpenSSL-u i certifikat koji šaljete u banku. Nakon razmjene ključeva i certifikata s bankom, podesite plugin i možete krenuti s testiranjem.
Preduvjeti
- PHP verzija 5.6 ili novija
- OpenSSL instaliran na poslužitelju
- WordPress verzija 5.0 ili više
- Woocommerce dodatak instaliran i uključen(v 3.8 ili više)
- HRK kao zadana valuta plaćanja
Značajke
- Obavijesni URL (nije potrebno u sučelju trgovca upisivati URL-ove za uspješnu i neuspješnu transakciju)
- Testni / produkcijski način rada
- Podržan način rada predautorizacije
- Jezici: HR, EN
- Prikaži/Sakrij eTomitreba logo prilikom naplate
Kako radi dodatak
Dodatak prikuplja podatke o narudžbi te ih koristi za kreiranje digitalnog potpisa uz pomoć Vašeg ključa kojeg ste sami kreirali i instalirali na svoj poslužitelj. Nakon toga preusmjerava kupca na sigurno sučelje banke, gdje nakon provjere digitalnog potpisa kupac unosi podatke o kartici i vrši plaćanje. Podatke o transakciji gateway šalje natrag u trgovinu, također uz digitalni potpis, ali ovaj put generiran ključem banke. Dodatak provjerava digitalni potpis, i ako je ispravan upisuje podatke o transakciji i mijenja status narudžbe ovisno o rezultatu (uspješno / neuspješno). Na kraju preusmjerava kupca na stranicu zahvale i ispisuje poruku o tome da li je narudžba odnosno transakcija bila uspješna ili ne.
Obavijesni URL
Prema dokumentaciji banke podaci o transakciji mogu biti poslani u trgovinu na dva načina:
- Uspješni / neuspješni URL (SUCCESS URL i FAILURE URL)
- Obavijesni URL (NOTIFY URL)
Dodatak koristi isključivo NOTIFY URL metodu jer je znatno pouzdanija. Podaci se trgovini dostavljaju direktno, a ne internetskim preglednikom kao u slučaju SUCCESS / FAILURE URL. To znači da će podaci biti dostavljeni trgovini čak i ako se korisnikov preglednik iznenada zatvori ili mu “pukne” veza na internet nakon izvršene transakcije. Banka preporuča korištenje NOTIFY metode jer značajno smanjuje mogućnost greške.
NOTIFY URL je potrebno upisati u sučelju trgovca u postavkama terminala u sljedećem obliku:
https://vasa-domena.hr/?wc-api=WC_Gateway_Rbawsb/
Ako želite koristiti vlastite stranice za uspješnu i neuspješnu transakciju, upišite ih u polja SUCCESS URL i FAILURE URL i uključite opciju “Stranice za preusmjeravanje” u postavkama dodatka. Ako navedenu opciju isključite, onda ta dva polja mogu ostati prazna jer je NOTIFY URL dovoljan (i obavezan) i kupac se nakon transakcije automatski preusmjerava na zadanu stranicu zahvale WooCommerce sustava (preporučeno!).
Ključevi i certifikati
Od banke najprije dobivate testni certifikat koji morate uploadati na svoj poslužitelj. Uploadajte ga u direktorij unutar dodatka: /wp-content/plugins/woocommerce-gateway-rbawsb/keys/ . Također morate u OpenSSL-u kreirati svoj vlastiti testni ključ i uploadati ga na istu lokaciju kao i certifikat banke. Iz svog ključa generirate i svoj certifikat koji morate poslati u banku da ga postave na gateway. Ovo je potrebno napraviti zbog kreiranja i čitanja digitalnog potpisa u komunikaciji Vaše trgovine sa gatewayom za plaćanje. Javni ključ kreira potpis, a certifikat na drugoj strani ga čita i provjerava autentičnost.
Kad je testiranje gotovo, banka Vam šalje produkcijski certifikat koji također morate uploadati na svoj poslužitelj. Isto tako morate ponoviti proceduru kreiranja svog ključa i certifikata, ali ovaj put s produkcijskim podacima. Svu dokumentaciju o tome kako se kreiraju ključ i certifikat dobit ćete od banke.
Važno: certifikati koje dobijete od banke obično imaju nastavak .cert . Da bi dodatak radio ispravno, obavezno je nastavak promijeniti u .crt (test-server.cert u test-server.crt).
Postavke
Sučelju za konfiguraciju dodatka pristupa se na istom mjestu kao i svim ostalim načinima plaćanja u WooCommerce trgovini: Woocommerce -> Postavke -> Plaćanje
Dostupne opcije:
Uključeno/isključeno
Ovdje možemo uključiti ili isključiti metodu plaćanja bez deaktivacije dodatka.
Naziv
Naziv metode plaćanja koji će biti vidljiv kupcu na listi svih ponuđenih metoda plaćanja. Primjer: “Plaćanje karticama” ili “Visa / Mastercard”
Opis
Opis koji je vidljiv kupcu kad bira metodu plaćanja. Ne prikazuju ga sve teme, ali obično se prikaže kad kupac klikne na metodu kako bi ju odabrao. Primjer opisa: “Plaćanje karticama preko sustava eToMiTreba”
Merchant ID
Jedinstveni broj trgovca koji ste dobili od banke.
Terminal ID
Identifikator Vašeg terminala za plaćanje. Parametar Vam dodjeljuje banka.
Testiranje
Označiti ako radite testiranje sustava i obavezno ODznačiti kad prelazite na produkcijsko sučelje. Na osnovu ovog parametra dodatak preusmjerava kupca na ispravan URL gatewaya.
Autorizacija
Banka nudi mogućnost predautorizacije transakcija, a ovaj parametar uključite SAMO ako ste posebno ugovorili predautorizaciju. Kontaktirajte banku za više informacija o predautorizaciji. Ovaj se parametar može i naknadno uključiti u dogovoru s tehničkom podrškom banke.
Prikaži logo
Prikazati ili sakriti logotip eToMiTreba na listi ponuđenih metoda plaćanja.
Stranice za preusmjeravanje
Ako želite da kupac nakon transakcije bude preusmjeren na Vaše prilagođene stranice, uključite ovu opciju. Potrebno je kreirati stranice za uspješnu i neuspješnu transakciju, te njihove adrese (URL-ove) upisati u sučelju trgovca na stranici banke (SUCCESS URL i FAILURE URL).
Status za uspješnu transakciju
Koji status dodijeliti narudžbi nakon uspješne transakcije. Dostupne opcije su “U obradi” i “Završeno”
