NikolicWP NestPay (kratko NWP NestPay) je dodatak za WooCommerce koji omogućava plaćanje platnim karticama preko NestPay usluge „3D Pay Hosting“. Kupac podatke kartice upisuje na sigurnoj stranici banke, nikad na vašem sajtu, a banka vraća rezultat prodavnici. Dodatak je podešen i proveren za Banca Intesa, a radi i sa drugim bankama koje koriste NestPay.

Ova dokumentacija opisuje verziju 2.2.0 (oktobar 2026). Autor dodatka je NikolicWP (https://nikolicwp.rs).

Ukratko:

• Plaćanje karticama Visa, Mastercard, Maestro, American Express i DinaCard, uz 3-D Secure proveru na stranici banke.
• SMS (naplata odmah) ili DMS (rezervacija sada, naplata kada pošaljete robu).
• Naplata, poništavanje, pun i delimičan povraćaj novca i provera statusa – direktno sa ekrana porudžbine u WooCommerce-u.
• Plaćanja kupaca koji se nisu vratili sa stranice banke potvrđuju se sama.
• Cene u evrima se naplaćuju u dinarima po srednjem kursu NBS, koji se preuzima automatski svaki dan.
• Logotipi, potvrda o plaćanju, uslovi kupovine i CAPTCHA po pravilima banke, i odeljak Sertifikacija koji vodi evidenciju test plaćanja umesto vas.
• Radi sa klasičnom i blokovskom stranicom za plaćanje, sa HPOS skladištem porudžbina i sa svakom temom.

Napomena: NikolicWP NestPay je nezavisan dodatak. Nije proizvod banke Banca Intesa a.d. Beograd ni kompanije Payten i one ga ne podržavaju zvanično. „NestPay“ i „Payten“ su žigovi svojih vlasnika, a „Banca Intesa“ je žig banke Banca Intesa a.d. Beograd; nazivi se koriste samo da opišu tehničku kompatibilnost.

1. Za koga je NikolicWP NestPay

Dodatak je namenjen WooCommerce prodavnicama u Srbiji koje sa bankom imaju (ili potpisuju) ugovor o prihvatanju platnih kartica na internetu preko NestPay platforme – pre svega sa bankom Banca Intesa.

Tipične situacije:

• Prodavnica šalje robu i želi da kupac plati karticom odmah pri porudžbini.
• Prodavnica želi da novac samo rezerviše, a da ga naplati tek kada pošalje robu (DMS).
• Usluge, kursevi, članarine i proizvodi za preuzimanje koji se plaćaju odmah.
• Prodavnica sa cenama u evrima koja kupcima u Srbiji naplaćuje dinare.
• Prodavnica koja prelazi sa drugog NestPay dodatka i želi jasna podešavanja na srpskom, pregled uživo i pomoć pri sertifikaciji kod banke.

Sva podešavanja, poruke kupcima, uputstvo u dodatku i podrška su na srpskom. Sa dodatkom NikolicWP Pismo sve radi i na ćirilici i na latinici.

↑ Sadržaj

2. Kako teče plaćanje

1. Kupac na stranici za plaćanje izabere Plaćanje platnom karticom i potvrdi porudžbinu.
2. WooCommerce pravi porudžbinu, a dodatak kupca šalje na sigurnu stranicu banke (zahtev je potpisan vašim Store Key-em).
3. Kupac na stranici banke upisuje podatke kartice i prolazi 3-D Secure proveru (Visa Secure, Mastercard ID Check) u aplikaciji ili porukom svoje banke.
4. Banka šalje rezultat nazad na adresu vaše prodavnice (okUrl ili failUrl). Dodatak proverava potpis banke, iznos, valutu i broj porudžbine, i tek tada potvrđuje plaćanje.
5. Kupac vidi stranicu „Porudžbina primljena“ sa podacima o transakciji, a isti podaci stižu i u mejlu o porudžbini.

Ako plaćanje ne uspe, kupac se vraća na stranicu za plaćanje sa opštom porukom i može odmah da pokuša ponovo. Razlog odbijanja koji banka pošalje vidite samo vi, u beleškama porudžbine – banka zabranjuje da se prikazuje kupcu.

Podaci kartice nikad ne prolaze kroz vaš sajt ni kroz dodatak.

↑ Sadržaj

3. Šta vam treba pre početka

Od banke (posle potpisivanja ugovora o internet prodaji):

• Client ID i Store Key za test okruženje. Produkcione dobijate posle uspešne sertifikacije.
• Pristup Merchant Center-u banke.

Sami pravite u Merchant Center-u: korisnika tipa „API“ sa korisničkim imenom i lozinkom. API korisnik je potreban za naplatu (DMS), poništavanje, povraćaj novca i proveru statusa iz WooCommerce-a, kao i za automatsko potvrđivanje plaćanja kupaca koji se nisu vratili sa stranice banke. Plaćanja rade i bez njega, ali te poslove tada radite ručno u Merchant Center-u.

Na sajtu:

• WooCommerce sa podešenom prodavnicom (valuta, adresa, mejlovi).
• Javno dostupan sajt preko HTTPS-a. Banka šalje rezultat plaćanja na vašu adresu, pa ona ne sme biti localhost ni zatvoren test server.
• Strane koje banka proverava: uslovi kupovine, politika privatnosti, kontakt sa podacima firme, isporuka, povraćaj i reklamacije (vidi Šta banka zahteva na sajtu).

↑ Sadržaj

4. Zahtevi i instalacija

Zahtevi: WordPress 6.0 ili noviji, PHP 7.4 ili noviji i WooCommerce 6.0 ili noviji. Svaka verzija se pre izdavanja proverava na WordPress-u 7.1.3 sa WooCommerce-om 11.1.2, na PHP 7.4 i 8.3.

Instalacija:

1. Preuzmite zip fajl dodatka iz svog naloga na nikolicwp.rs.
2. U WordPress-u otvorite Dodaci → Dodaj novi → Otpremi dodatak, izaberite zip i kliknite Instaliraj odmah, pa Aktiviraj.
3. Otvara se čarobnjak za licencu: nalepite ključ koji ste dobili posle kupovine i kliknite Nastavi.
4. Posle aktivacije licence otvaraju se podešavanja dodatka. Nastavite sa prvim podešavanjem.

Podešavanja se kasnije otvaraju iz WooCommerce → Podešavanja → Plaćanja → NikolicWP NestPay → Upravljaj. Dodatak nema sopstveni meni; sve je na jednom ekranu u WooCommerce-u.

↑ Sadržaj

5. Licenca

• Paketi: godišnja licenca za 1 sajt (Personalni), 5 sajtova (Poslovni) ili 10 sajtova (Profesionalni). Sve mogućnosti su u svakom paketu; razlika je samo u broju sajtova.
• Aktivacija: ključ se aktivira jednom po sajtu, u čarobnjaku posle aktivacije dodatka. Plaćanje karticama se nudi kupcima tek kada je licenca aktivirana na sajtu.
• Lokalni i test sajtovi ne troše mesto: localhost, *.local, *.test, staging.* i dev.*.
• Šta pokriva licenca: nove verzije i podršku.
• Kada licenca istekne: plaćanje karticama radi kao i do tada, sa svim podešavanjima. Samo ne dobijate nove verzije i podršku dok licencu ne obnovite. U zaglavlju podešavanja piše „Licenca je istekla – plaćanje radi, bez ažuriranja i podrške“.
• Odeljak Licenca u podešavanjima dodatka prikazuje stanje, ključ (skriven), datum važenja, broj sajtova, poslednju proveru i dugmad Proveri sada, Deaktiviraj na ovom sajtu, Obnovite licencu i Moje licence. Uz aktivnu licencu tu je i kartica Podrška sa dugmetom „Pošalji dijagnostiku i otvori tiket“.
• Prenos na drugi sajt: na starom sajtu kliknite Deaktiviraj na ovom sajtu. Time oslobađate mesto, a na tom sajtu se plaćanje karticama isključuje dok ključ ponovo ne aktivirate.
• Ponovna instalacija: deaktivacija i ponovna aktivacija samog dodatka (u listi Dodaci) ne troši novo mesto i ne isključuje plaćanja – sačuvani ključ se ponovo aktivira sam.
• Opozvana licenca (na primer posle povraćaja novca za kupovinu licence) isključuje plaćanje karticama.

↑ Sadržaj

6. Prvo podešavanje korak po korak

1. Banka: u odeljku Banka ostavite Banca Intesa (ili izaberite drugu banku, vidi Druge banke).
2. Test pristupni podaci: upišite test Client ID i Store Key, a ako ste ga napravili, i test API korisničko ime i lozinku.
3. Opšte: uključite Uključi NestPay i ostavite Test režim uključen.
4. Prikaz: upišite naziv, PIB i adresu trgovca (ili ostavite prazno da se koriste podaci prodavnice). Proverite traku sa logotipima u pregledu uživo.
5. Bezbednost: uključite reCAPTCHA v3 i upišite ključeve (banka traži CAPTCHA za kupce bez naloga).
6. Uslovi kupovine: u WooCommerce → Podešavanja → Napredno izaberite stranu sa uslovima, da bi se na naplati pojavio kvadratić koji kupac mora da označi.
7. Kliknite Sačuvaj izmene.
8. Povratne adrese: na dnu podešavanja (okUrl / failUrl) i u Uputstvu su adrese vaše prodavnice na koje banka šalje rezultat. Dodatak ih šalje banci uz svaki zahtev, ali proverite da su dostupne preko javnog HTTPS-a.
9. Test plaćanja: napravite probne kupovine test karticama banke. Odeljak Sertifikacija pokazuje šta još treba uraditi i sam popunjava tabelu za banku (vidi Sertifikacija).
10. Produkcija: kada banka potvrdi sertifikaciju i pošalje produkcione podatke, upišite ih i isključite Test režim (vidi Prelazak na produkciju).

Sva podešavanja već imaju preporučene vrednosti, pa za većinu prodavnica ostalo ne treba menjati.

↑ Sadržaj

7. Ekran podešavanja

Ekran ima zaglavlje i levu navigaciju sa odeljcima.

Zaglavlje pokazuje verziju, da li je aktivan test ili produkcioni režim i stanje licence (klik vodi na odeljak Licenca).

Odeljci sa podešavanjima: Opšte, Banka, Test pristupni podaci, Produkcioni pristupni podaci, Transakcija, Posle plaćanja, Stranica banke za plaćanje, Bezbednost, Prikaz i Napredno.

Ostali odeljci: Transakcije (lista svih NestPay porudžbina), Sertifikacija (samo u test režimu), Uputstvo i Licenca.

Pomoć pri radu:

• Pregled uživo – na dnu odeljaka Opšte, Banka, Transakcija, Posle plaćanja i Prikaz vidite kako će izmena izgledati: način plaćanja na naplati, iznos koji se naplaćuje, šta se dešava sa porudžbinom, potvrdu za kupca i traku sa logotipima. Pregled odmah prati formular; ništa se ne čuva dok ne kliknete Sačuvaj izmene.
• Objašnjenje uz svaku opciju stoji ispod polja i kaže čemu služi i koja je vrednost preporučena.
• Ikonica knjige uz naslov odeljka i uz svaku opciju otvara odgovarajuće poglavlje Uputstva; dugme ← Nazad na podešavanje vraća vas na istu opciju.
• Vrati preporučena podešavanja – dugme na dnu odeljka ponovo upisuje preporučene vrednosti. Pristupni podaci, ključevi i podaci trgovca se ne diraju; izmena ostaje tek posle Sačuvaj izmene.
• Odustani od izmena – pojavljuje se pored dugmeta za čuvanje čim nešto promenite i vraća formular na sačuvano stanje.
• Uputstvo – sva poglavlja na jednom mestu, sa pretragom koja radi na ćirilici i latinici, sa i bez kvačica.

↑ Sadržaj

8. Podešavanja – sve opcije

Vrednosti označene kao preporučene su ujedno i podrazumevane.

Opšte

Banka

Test i produkcioni pristupni podaci

Dodatak čuva oba skupa podataka, pa se u test režim možete vratiti u svakom trenutku.

Transakcija

Posle plaćanja

Stranica banke za plaćanje

Bezbednost

Prikaz

Napredno

↑ Sadržaj

9. SMS ili DMS

SMS (Auth) odmah naplaćuje karticu. To je najjednostavniji model, preporučen za robu koja se odmah šalje i za usluge.

DMS (PreAuth) samo rezerviše iznos na kartici kupca. Novac se skida tek kada ga naplatite:

• ručno, dugmetom Naplati u NestPay okviru na porudžbini (može i manji iznos – delimična naplata);
• automatski, kada porudžbinu označite kao Završena (uz uključenu „Naplatu pri završetku“);
• automatski posle određenog broja dana („Automatska naplata posle (dana)“).

Banka garantuje rezervaciju 7 dana i dozvoljava naplatu tek kada je roba poslata. Rezervacije starije od 6 dana prikazuju se u obaveštenju u administraciji, a „Rezervacija pred istekom“ 24 sata pre isteka šalje mejl prodavnici ili oslobađa rezervaciju. Ako otkažete porudžbinu, rezervacija se oslobađa i kupac se ne zadužuje.

↑ Sadržaj

10. Statusi porudžbine posle plaćanja

SMS – uobičajen tok: kupac plati, novac se naplaćuje odmah i porudžbina dobija status U obradi. Vi pošaljete robu i sami označite porudžbinu kao Završena. Porudžbine samo sa virtuelnim proizvodima ili proizvodima za preuzimanje WooCommerce sam završava.

DMS – rezervacija, pa naplata: kupac plati, banka rezerviše iznos i porudžbina dobija status Na čekanju. Kada pošaljete robu, označite porudžbinu kao Završena – dodatak tada naplaćuje rezervisani iznos, a porudžbina ostaje Završena. Ako naplata ne uspe, porudžbina se vraća na Na čekanju uz belešku, a kupac ne dobija mejl „porudžbina završena“.

Poništavanje oslobađa rezervaciju ili poništava plaćanje od istog dana pre nego što ga banka proknjiži (do kraja dana). Porudžbina dobija status Otkazano. Za plaćanje koje je već proknjiženo koristite povraćaj novca.

Neuspelo plaćanje: kartica je odbijena ili je kupac odustao na stranici banke. Porudžbina dobija status Neuspešno i kupac može ponovo da plati iz Mog naloga. Svaki novi pokušaj šalje se banci sa novim brojem (oid), jer banka svaki prihvata samo jednom.

Pregled uživo u odeljku Posle plaćanja crta tok statusa za vaša podešavanja – za SMS, DMS, otkazanu porudžbinu i odbijenu karticu.

↑ Sadržaj

11. Rad sa porudžbinama

Svaka porudžbina plaćena preko dodatka ima NestPay okvir na ekranu porudžbine. U njemu su:

• stanje plaćanja (naplaćeno, rezervisano, vraćen novac, delimično vraćen, poništeno), iznos naplate i povraćaja;
• podaci transakcije: TransId, AuthCode, mdStatus, kartica (maskirana), kurs i njegov izvor kada je porudžbina u drugoj valuti;
• istorija pokušaja – svaki pokušaj plaćanja sa svojim brojem za banku (oid), rezultatom i karticom;
• dugme Osveži, koje prikazuje najnovije podatke bez ponovnog učitavanja porudžbine.

Dugmad (potreban je API korisnik):

Povraćaj novca (ceo ili deo) radite standardnim WooCommerce dugmetom Povraćaj ispod stavki porudžbine – dodatak ga šalje banci. Povraćaj se odnosi na već proknjiženo plaćanje; isti dan je umesto toga dovoljno poništavanje.

Svaka operacija (naplata, povraćaj, poništavanje) upisuje se u beleške porudžbine, sa svojim TransId-om. Ako operacija ne uspe, tačna greška banke je u beleškama.

Kada je porudžbina u drugoj valuti, ispod polja za iznos naplate piše u kojoj valuti banka naplaćuje (npr. „Banka naplaćuje u RSD; iznos porudžbine je €10.00.“).

↑ Sadržaj

12. Nedovršena plaćanja i automatsko usklađivanje

Kupac koji plati, a zatim zatvori pregledač na stranici banke, nikad se ne vrati u prodavnicu. Bez usklađivanja porudžbina bi ostala „Čeka se uplata“ – ili „Neuspešno“, ako je prvi pokušaj odbijen, a ponovljeni uspeo.

Zato dodatak na svakih 15 minuta pita banku za takve porudžbine iz poslednja 24 sata i potvrđuje ih (potreban je API korisnik). Kada se plaćanje pronađe za porudžbinu koja je već bila neuspešna ili otkazana, prodavnica dobija i mejl „[NestPay] Pronađeno plaćanje…“, da ne propustite slanje.

Dugme Uskladi sada u odeljku Transakcije pokreće proveru odmah.

Bez API korisnika usklađivanje ne radi, a dodatak vas na to upozorava u administraciji. Takve porudžbine tada proveravate ručno u Merchant Center-u.

Plaćanje nije moglo da se potvrdi: kada odgovor banke stigne bez ispravnog potpisa (najčešće pogrešno prekopiran Store Key), dodatak ne potvrđuje plaćanje, a kupcu ne piše da kartica nije zadužena – jer možda jeste. Kupac dobija poruku da ne plaća ponovo i da se javi prodavnici, porudžbina dobija belešku, a provera statusa pita banku šta se desilo.

↑ Sadržaj

13. Transakcije

Odeljak Transakcije u podešavanjima je lista svih porudžbina plaćenih preko dodatka.

• Filteri: sve, naplaćeno, rezervisano, vraćen novac, poništeno, neuspešno, nedovršeno.
• Period, pretraga po broju porudžbine, OID-u, TransId-u, AuthCode-u, kartici, imenu ili mejlu kupca, sortiranje po datumu ili iznosu, 10/20/50/100 po strani.
• Samo test plaćanja – prikazuje plaćanja napravljena u test režimu.
• Preuzmi CSV (trenutni filter) – izvoz za knjigovođu ili za banku. Fajl se otvara u Excel-u sa ispravnim slovima.
• Uskladi sada – odmah pita banku za nedovršena plaćanja.
• Osveži – ponovo učitava listu sa istim filterima, pretragom i stranom.

Klik na broj porudžbine otvara porudžbinu.

↑ Sadržaj

14. Cene u evrima i kurs NBS

Banca Intesa domaćim trgovcima naplaćuje u dinarima (valuta 941). Ako prodavnica prodaje u evrima ili drugoj valuti, kupcu se naplaćuje preračunat iznos u dinarima.

• Srednji kurs NBS (preporučeno): preuzima se automatski svaki dan u 8:30 i čuva na sajtu. Ako ne može da se preuzme, koristi se poslednji poznati kurs do 7 dana, pa sopstveni kursevi. Plaćanje nikad ne čeka na preuzimanje kursa.
• Moji kursevi: jedan kurs po redu u polju „Konverzija valute“, npr. EUR=117.20.
• Korekcija kursa (%) dodaje razliku, npr. do kursa koji koristi vaša banka.
• Trenutni kurs se prikazuje u odeljku Transakcija, a pregled uživo pokazuje koliko se naplaćuje za nekoliko primera iznosa.
• Kurs i njegov izvor („NBS“ sa datumom kursne liste, ili sopstveni kurs) čuvaju se na svakoj porudžbini i vide se u NestPay okviru.

Porudžbine u valuti za koju nema kursa ne mogu da se plate ovim načinom, a dodatak vas upozorava u administraciji.

Kupci u Srbiji: Zakon o zaštiti potrošača traži cene u dinarima; cena u evrima može da stoji pored. Najjednostavnije je da prodavnica bude u dinarima, a prodavnica u evrima više odgovara kupcima iz inostranstva. Detalje proverite sa knjigovođom i bankom.

↑ Sadržaj

15. Šta banka zahteva na sajtu

Banca Intesa pre puštanja u rad proverava sajt po svom uputstvu za trgovce. Dodatak rešava deo koji se tiče plaćanja; ostalo su strane sajta.

Logotipi. Logo banke (sa linkom na sajt banke), znakovi kartica (Visa, Mastercard, Maestro, American Express, DinaCard) kao jedna grupa i znakovi Visa Secure i Mastercard ID Check kao posebna grupa, sa linkovima koje propisuje banka – na početnoj strani i svuda gde kupac bira način plaćanja. Dodatak sadrži zvanične slike banke i raspoređuje ih po njenim pravilima (iste veličine, razmak između grupa, jedna grupa programa po strani).

• Logotipi u podnožju stavljaju traku na dno svake strane.
• Kratki kod [nestpay_logos] postavlja traku bilo gde drugde, uz atribute size="small|medium|large" i dark="1" za tamnu pozadinu.
• Znakovi kartica pored načina plaćanja na naplati uključeni su podrazumevano.

Uslovi kupovine. Kupac mora izričito da ih prihvati (kvadratić) pre plaćanja. WooCommerce prikazuje kvadratić kada je strana sa uslovima izabrana u WooCommerce → Podešavanja → Napredno. Dodatak vas podseća dok strana nije podešena.

Potvrda o plaćanju. Posle uspešnog plaćanja kupac na sajtu i u mejlu vidi podatke transakcije (Order ID, AuthCode, Response, ProcReturnCode, mdStatus, datum) i naziv, PIB i adresu trgovca.

Odbijena plaćanja. Kupac nikad ne vidi bankin razlog odbijanja, samo opštu poruku: da proveri broj kartice, rok važenja i CVC, pokuša ponovo ili se javi svojoj banci.

CAPTCHA. Obavezna za kupce bez naloga – uključite reCAPTCHA v3 u odeljku Bezbednost.

Strane sajta (nisu deo dodatka): kontakt sa podacima trgovca (naziv, adresa, PIB, matični broj, telefon, mejl), uslovi kupovine, isporuka, povraćaj i reklamacije, politika privatnosti, cene u dinarima.

Druga banka može imati drugačija pravila – pratite njeno uputstvo.

↑ Sadržaj

16. Sertifikacija kod banke

Pre produkcije banka traži da na njenom test okruženju prođete spisak test plaćanja i da joj pošaljete rezultate. Odeljak Sertifikacija (levo, ispod Transakcija) vodi tu evidenciju umesto vas. Vidi se samo dok je uključen test režim.

1. Sajt – spisak onoga što banka proverava, sa oznakom „Spremno“ ili „Treba uraditi“ i linkom „Otvori podešavanje“: test pristupni podaci, API korisnik, HTTPS, uslovi kupovine, politika privatnosti, podaci trgovca, podaci o transakciji na sajtu i u mejlu, logotipi, CAPTCHA, a za Intesu i hash ver2 i rate. Stavke koje dodatak ne može da proveri („Proverite sami“): kontakt strana sa podacima firme, isporuka, povraćaj i reklamacije, cene u dinarima.

2. Test plaćanja za izabranu vrstu transakcije:

Uz to i odobreno plaćanje svakom test karticom koju je banka navela (Visa, Mastercard, Maestro, American Express, DinaCard).

Svaki red se sam popunjava iz najnovije test porudžbine: porudžbina, OID, TransId, AuthCode, iznos, datum, kartica i rezultat. Povraćaj radite dan posle plaćanja, jer isti dan dodatak umesto povraćaja radi poništavanje.

Dugmad Preuzmi CSV, Odštampaj i Osveži daju tabelu za banku. Pošaljite je banci, uz izvoz iz Merchant Center-a ako ga traži. Banka zatim pregleda sajt i izdaje produkcione parametre.

↑ Sadržaj

17. Prelazak na produkciju

1. Kada banka potvrdi sertifikaciju, upišite produkcioni Client ID, Store Key i API korisnika u Produkcioni pristupni podaci. API korisnika za produkciju pravite u produkcionom Merchant Center-u.
2. Po želji uključite Samo administratori i napravite jednu pravu kupovinu malim iznosom, pa je poništite.
3. Isključite Test režim i, ako ste ga uključili, Samo administratori. Kliknite Sačuvaj izmene.
4. Zaglavlje podešavanja sada pokazuje produkcioni režim, a odeljak Sertifikacija se više ne prikazuje.

Test podaci ostaju sačuvani, pa se za proveru možete vratiti u test režim u svakom trenutku.

↑ Sadržaj

18. Druge banke koje koriste NestPay

NestPay (platforma Payten / Asseco SEE) koristi više banaka. Sve rade na isti način, a razlikuju se adrese, naziv i logotip.

• Banca Intesa je podešena i proverena: izaberite je u odeljku Banka i ništa drugo nije potrebno.
• Druga banka: izaberite „Druga banka koja koristi NestPay“ i upišite naziv, sajt i logotip banke i adrese njene stranice za plaćanje za test i produkciju iz ugovora. Adresa API-ja se izvodi iz njih, osim ako vam banka da drugu.
• Sve ostalo – SMS i DMS, naplata, poništavanje, povraćaj, provera statusa, logotipi, pregledi – radi isto.
• Bez adrese stranice za plaćanje način plaćanja se ne prikazuje kupcima, a dodatak vas upozorava.
• Druge banke nisu proverene na njihovom test okruženju. Pre produkcije prođite bankin test, a pravila (CAPTCHA, logotipi, rate, verzija hash-a) pratite po uputstvu svoje banke.

↑ Sadržaj

19. Bezbednost i privatnost

• Podaci kartice nikad ne dolaze na vaš sajt. Kupac ih upisuje na stranici banke; dodatak vidi samo maskiran broj.
• Svaki odgovor banke se proverava: potpis (hash) Store Key-em, broj porudžbine, iznos i valuta. Odgovor bez ispravnog potpisa nikad ne potvrđuje plaćanje, a odgovor bez potpisa ne ostavlja ni belešku na porudžbini.
• Ponovljen ili zakasneo odgovor (kupac pritisne Nazad) ne menja porudžbinu koja je već plaćena.
• Zaštita od testiranja kartica: reCAPTCHA v3 i ograničenje neuspelih pokušaja po IP adresi.
• Log: potpis banke se nikad ne upisuje; broj kartice, mejl, ime, adresa i telefon su maskirani, a unosi stariji od 7 dana brišu se sami.
• Spoljni servisi: dodatak razgovara samo sa bankom, sa Google reCAPTCHA (ako je uključena) i sa javnom kursnom listom NBS (kurs.resenje.org, ako koristite kurs NBS). Provera licence šalje ključ, adresu sajta i verzije WordPress-a i dodatka serveru nikolicwp.rs.

↑ Sadržaj

20. Kompatibilnost

• WooCommerce: klasična stranica za plaćanje (kratki kod) i blokovska stranica za plaćanje; HPOS skladište porudžbina.
• Teme: dodatak nema sopstveni izgled na sajtu – poruke, dugmad, mejlovi i potvrda koriste klase WooCommerce-a i stil vaše teme (proveravano sa Blocksy i Twenty Twenty-Five). Stranica banke ima izgled banke.
• Drugi NestPay dodaci: od verzije 2.0.0 dodatak ima sopstveni ID načina plaćanja (nwp_nestpay) i radi uporedo sa drugim NestPay dodacima, bez mešanja podešavanja i porudžbina. Podešavanja i porudžbine iz ranijih verzija prenose se sami.
• NikolicWP Pismo: sve poruke i potvrde su na pismu koje je kupac izabrao, a nazivi kao NestPay i Banca Intesa ostaju latinicom.
• Valute: bilo koja valuta prodavnice uz kurs NBS ili sopstveni kurs; banka naplaćuje u valuti trgovca.

↑ Sadržaj

21. Ažuriranje, deaktivacija i brisanje

Ažuriranje: kao svaki drugi dodatak (Kontrolna tabla → Ažuriranja), dok je licenca aktivna. Podešavanja, pristupni podaci i porudžbine ostaju.

Deaktivacija: način plaćanja nestaje sa naplate, a porudžbine i podešavanja ostaju. Ponovnom aktivacijom sve radi kao pre.

Brisanje: Dodaci → NikolicWP NestPay → Deaktiviraj → Obriši. Podešavanja, pristupni podaci i zapis o licenci brišu se samo ako ste uključili Napredno → Brisanje podataka. Porudžbine i podaci o transakcijama se nikad ne brišu – to je evidencija prodavnice.

↑ Sadržaj

22. Za programere

Kratki kod: [nestpay_logos size="small|medium|large" dark="0|1"]

Povratna adresa (okUrl / failUrl): /wc-api/nwp_nestpay/?nestpay_result=ok i /wc-api/nwp_nestpay/?nestpay_result=fail. Stara adresa WC_Gateway_NestPay i dalje radi za plaćanja započeta ranije.

ID načina plaćanja: nwp_nestpay. Opcija sa podešavanjima: woocommerce_nwp_nestpay_settings.

Filteri:

Podaci na porudžbini (meta): _nestpay_oid, _nestpay_attempts, _nestpay_oid_history, _nestpay_test_mode, _nestpay_rate_source.

Log: WooCommerce → Status → Logs, izvori nwp-nestpay i nwp-nestpay-api.

↑ Sadržaj

23. Rešavanje problema

Način plaćanja se ne vidi na naplati

Proverite: da je licenca aktivirana na sajtu; da je uključeno „Uključi NestPay“; da su upisani pristupni podaci za aktivni režim (test ili produkcija); da valuta prodavnice ima kurs; da nije uključeno „Samo administratori“ dok niste prijavljeni kao administrator; za drugu banku – da je upisana adresa stranice za plaćanje. Obaveštenja na vrhu ekrana podešavanja navode tačan uzrok.

Porudžbina ostaje „Čeka se uplata“ posle plaćanja

Banka nije uspela da vrati rezultat ili ga dodatak nije mogao da proveri. Proverite da je Store Key tačno prekopiran (bez razmaka), da je verzija hash-a ver2 i da je povratna adresa dostupna preko javnog HTTPS-a (zaštitni zid, dodatak za bezbednost ili zaštita od botova ne sme da blokira POST zahteve banke na /wc-api/nwp_nestpay/). Uz API korisnika porudžbina se potvrđuje sama u roku od 15 minuta, a odmah dugmetom „Proveri status u banci“.

Kupac dobija poruku „Plaćanje nije moglo da se potvrdi“

Odgovor banke nije imao ispravan potpis – najčešće zbog pogrešnog Store Key-a ili Store Key-a iz drugog režima (test umesto produkcije). Proverite ključ, pa „Proveri status u banci“ na porudžbini. Ako se dešava sa ispravnim ključem, uključite log i pošaljite ga podršci.

Naplata, poništavanje ili povraćaj ne uspeva

Nedostaju ili su pogrešni API korisnik i lozinka za aktivni režim, ili API korisnik nema prava u Merchant Center-u. Tačna greška banke je u beleškama porudžbine.

Banka odbija zahtev sa order id already used

Banka svaki broj za banku (oid) prihvata samo jednom. Dodatak svaki pokušaj šalje sa novim brojem; ako ste ručno menjali porudžbinu ili koristite drugi dodatak za plaćanje uporedo, otvorite stranu za plaćanje ponovo da bi se napravio novi broj.

Kupac ne vidi poruku posle odbijenog plaćanja

Poruka se prikazuje na stranici za plaćanje porudžbine i ne zavisi od kolačića. Ako je ne vidi, proverite da keš stranica ne kešira stranice „Plaćanje“ i „Moj nalog“.

Traka sa logotipima se ne vidi ili se vidi dva puta

Uključite „Logotipi u podnožju“ ili stavite kratki kod [nestpay_logos]. Na strani sa kratkim kodom traka u podnožju se ne prikazuje. Ako tema ima tamno podnožje, uključite „Tamna pozadina“.

Kurs NBS se ne preuzima

Server ne može da pristupi kurs.resenje.org ili WordPress cron ne radi. Dodatak koristi poslednji poznati kurs do 7 dana, pa sopstvene kurseve. Proverite da li hosting blokira spoljne zahteve, ili privremeno izaberite „Moji kursevi“.

Debug log

Uključite Napredno → Dnevnik za otklanjanje grešaka, ponovite problem i otvorite WooCommerce → Status → Logs (izvori nwp-nestpay i nwp-nestpay-api). Lični podaci su maskirani, a potpis banke se ne upisuje. Posle rešavanja isključite log.

Kako da pošaljem podatke podršci

U odeljku Licenca kliknite Pošalji dijagnostiku i otvori tiket. Šalju se adresa sajta, verzije dodatka, WordPress-a, WooCommerce-a i PHP-a, tema i aktivni dodaci – nikad pristupni podaci banke ni podaci kupaca. „Šta se šalje“ prikazuje tačan sadržaj pre slanja.

↑ Sadržaj

24. Česta pitanja

Da li kupac upisuje podatke kartice na mom sajtu?

Ne. Kupac podatke kartice upisuje na sigurnoj stranici banke („3D Pay Hosting“). Vaš sajt i dodatak vide samo maskiran broj kartice i rezultat plaćanja.

Sa kojim bankama radi NikolicWP NestPay?

Podešen je i proveren za Banca Intesa. Radi i sa drugim bankama koje koriste NestPay platformu – upisuju se adrese iz ugovora sa bankom, uz bankin test pre produkcije.

Koje kartice kupci mogu da koriste?

Visa, Mastercard, Maestro, American Express i DinaCard, uz 3-D Secure proveru (Visa Secure, Mastercard ID Check). Koje kartice prihvatate određuje ugovor sa bankom.

Šta mi treba od banke?

Ugovor o internet prodaji, test Client ID i Store Key, pristup Merchant Center-u i, posle sertifikacije, produkcioni Client ID i Store Key. API korisnika za naplatu, poništavanje, povraćaj i proveru statusa pravite sami u Merchant Center-u.

Da li moram da imam API korisnika?

Plaćanja rade i bez njega. API korisnik je potreban za naplatu (DMS), poništavanje, povraćaj novca iz WooCommerce-a, proveru statusa i automatsko potvrđivanje plaćanja kupaca koji se nisu vratili sa stranice banke. Preporučuje se.

Koja je razlika između SMS i DMS?

SMS naplaćuje karticu odmah. DMS samo rezerviše iznos na 7 dana, a naplaćujete ga kada pošaljete robu – ručno, kada porudžbinu označite kao Završena, ili automatski posle određenog broja dana.

Kako da vratim novac kupcu?

Na porudžbini kliknite WooCommerce dugme Povraćaj ispod stavki i upišite ceo ili deo iznosa – dodatak ga šalje banci. Plaćanje od istog dana se umesto toga poništava dugmetom „Poništi plaćanje (istog dana)“ u NestPay okviru.

Šta ako kupac zatvori pregledač posle plaćanja na stranici banke?

Dodatak na svakih 15 minuta pita banku za nedovršena plaćanja i sam potvrđuje porudžbinu (potreban je API korisnik). Ako je porudžbina u međuvremenu bila neuspešna ili otkazana, dobijate i mejl.

Mogu li da prodajem u evrima?

Možete. Banka naplaćuje u dinarima, a dodatak preračunava iznos po srednjem kursu NBS, koji se preuzima automatski svaki dan, ili po vašem kursu. Kupcima u Srbiji cene treba prikazati u dinarima.

Šta banka proverava na mom sajtu?

Logotipe banke i kartica, uslove kupovine sa kvadratićem, potvrdu o plaćanju sa podacima trgovca, CAPTCHA za kupce bez naloga, kontakt sa podacima firme, isporuku, povraćaj i reklamacije i politiku privatnosti. Odeljak Sertifikacija pokazuje šta je spremno, a šta treba uraditi.

Kako se radi sertifikacija kod banke?

U test režimu napravite test plaćanja sa bankinog spiska. Odeljak Sertifikacija sam popunjava tabelu (porudžbina, OID, TransId, AuthCode, iznos, rezultat), koju preuzimate kao CSV ili štampate i šaljete banci.

Da li mogu da koristim NikolicWP NestPay uz drugi NestPay dodatak?

Možete. Od verzije 2.0.0 dodatak ima sopstveni ID načina plaćanja (nwp_nestpay), pa radi uporedo sa drugim NestPay dodacima bez mešanja podešavanja i porudžbina.

Radi li sa blokovskom stranicom za plaćanje?

Da – i sa klasičnom i sa blokovskom stranicom za plaćanje, i sa HPOS skladištem porudžbina.

Da li dodatak prati izgled moje teme?

Da. Poruke, dugmad, mejlovi i potvrda koriste stil vaše teme. Stranica banke za unos kartice ima izgled banke.

Šta se dešava kada licenca istekne?

Plaćanje karticama radi kao i do tada, sa svim podešavanjima. Samo ne dobijate nove verzije i podršku dok licencu ne obnovite.

Na koliko sajtova mogu da koristim licencu?

Zavisno od paketa: 1, 5 ili 10 sajtova. Lokalni i test sajtovi ne troše mesto. Deaktivacijom na jednom sajtu oslobađate mesto za drugi.

Da li je NikolicWP NestPay zvanični dodatak banke?

Ne. To je nezavisan dodatak brenda NikolicWP, napravljen po tehničkim uputstvima banke za trgovce. Banca Intesa i Payten ga ne podržavaju zvanično.

Šta ako obrišem dodatak?

Porudžbine i podaci o transakcijama se nikad ne brišu. Podešavanja i pristupni podaci brišu se samo ako ste uključili „Brisanje podataka“ u odeljku Napredno.

↑ Sadržaj

25. Brza referenca

NikolicWP NestPay je proizvod brenda NikolicWP – https://nikolicwp.rs. Dokumentacija važi za verziju 2.2.0, ažurirano 20. oktobra 2026.