NikolicWP NestPay (кратко NWP NestPay) је додатак за WooCommerce који омогућава плаћање платним картицама преко NestPay услуге „3D Pay Hosting“. Купац податке картице уписује на сигурној страници банке, никад на вашем сајту, а банка враћа резултат продавници. Додатак је подешен и проверен за Banca Intesa, а ради и са другим банкама које користе NestPay.

Ова документација описује верзију 2.2.0 (октобар 2026). Аутор додатка је NikolicWP (https://nikolicwp.rs).

Укратко:

• Плаћање картицама Visa, Mastercard, Maestro, American Express и DinaCard, уз 3-Д Secure проверу на страници банке.
• СМС (наплата одмах) или DMS (резервација сада, наплата када пошаљете робу).
• Наплата, поништавање, пун и делимичан повраћај новца и провера статуса – директно са екрана поруџбине у WooCommerce-у.
• Плаћања купаца који се нису вратили са странице банке потврђују се сама.
• Цене у еврима се наплаћују у динарима по средњем курсу НБС, који се преузима аутоматски сваки дан.
• Логотипи, потврда о плаћању, услови куповине и CAPTCHA по правилима банке, и одељак Сертификација који води евиденцију тест плаћања уместо вас.
• Ради са класичном и блоковском страницом за плаћање, са HPOS складиштем поруџбина и са сваком темом.

Напомена: NikolicWP NestPay је независан додатак. Није производ банке Banca Intesa a.d. Београд ни компаније Payten и оне га не подржавају званично. „NestPay“ и „Payten“ су жигови својих власника, а „Banca Intesa“ је жиг банке Banca Intesa a.d. Београд; називи се користе само да опишу техничку компатибилност.

1. За кога је NikolicWP NestPay

Додатак је намењен WooCommerce продавницама у Србији које са банком имају (или потписују) уговор о прихватању платних картица на интернету преко NestPay платформе – пре свега са банком Banca Intesa.

Типичне ситуације:

• Продавница шаље робу и жели да купац плати картицом одмах при поруџбини.
• Продавница жели да новац само резервише, а да га наплати тек када пошаље робу (DMS).
• Услуге, курсеви, чланарине и производи за преузимање који се плаћају одмах.
• Продавница са ценама у еврима која купцима у Србији наплаћује динаре.
• Продавница која прелази са другог NestPay додатка и жели јасна подешавања на српском, преглед уживо и помоћ при сертификацији код банке.

Сва подешавања, поруке купцима, упутство у додатку и подршка су на српском. Са додатком NikolicWP Pismo све ради и на ћирилици и на латиници.

↑ Садржај

2. Како тече плаћање

1. Купац на страници за плаћање изабере Плаћање платном картицом и потврди поруџбину.
2. WooCommerce прави поруџбину, а додатак купца шаље на сигурну страницу банке (захтев је потписан вашим Store Key-ем).
3. Купац на страници банке уписује податке картице и пролази 3-D Secure проверу (Visa Secure, Mastercard ID Check) у апликацији или поруком своје банке.
4. Банка шаље резултат назад на адресу ваше продавнице (okUrl или failUrl). Додатак проверава потпис банке, износ, валуту и број поруџбине, и тек тада потврђује плаћање.
5. Купац види страницу „Поруџбина примљена“ са подацима о трансакцији, а исти подаци стижу и у мејлу о поруџбини.

Ако плаћање не успе, купац се враћа на страницу за плаћање са општом поруком и може одмах да покуша поново. Разлог одбијања који банка пошаље видите само ви, у белешкама поруџбине – банка забрањује да се приказује купцу.

Подаци картице никад не пролазе кроз ваш сајт ни кроз додатак.

↑ Садржај

3. Шта вам треба пре почетка

Од банке (после потписивања уговора о интернет продаји):

• Client ID и Store Key за тест окружење. Продукционе добијате после успешне сертификације.
• Приступ Merchant Center-у банке.

Сами правите у Merchant Center-у: корисника типа „API“ са корисничким именом и лозинком. API корисник је потребан за наплату (DMS), поништавање, повраћај новца и проверу статуса из WooCommerce-а, као и за аутоматско потврђивање плаћања купаца који се нису вратили са странице банке. Плаћања раде и без њега, али те послове тада радите ручно у Merchant Center-у.

На сајту:

• WooCommerce са подешеном продавницом (валута, адреса, мејлови).
• Јавно доступан сајт преко HTTPS-а. Банка шаље резултат плаћања на вашу адресу, па она не сме бити localhost ни затворен тест сервер.
• Стране које банка проверава: услови куповине, политика приватности, контакт са подацима фирме, испорука, повраћај и рекламације (види Шта банка захтева на сајту).

↑ Садржај

4. Захтеви и инсталација

Захтеви: WordPress 6.0 или новији, PHP 7.4 или новији и WooCommerce 6.0 или новији. Свака верзија се пре издавања проверава на WordPress-у 7.1.3 са WooCommerce-ом 11.1.2, на PHP 7.4 и 8.3.

Инсталација:

1. Преузмите зип фајл додатка из свог налога на nikolicwp.rs.
2. У WordPress-у отворите Додаци → Додај нови → Отпреми додатак, изаберите зип и кликните Инсталирај одмах, па Активирај.
3. Отвара се чаробњак за лиценцу: налепите кључ који сте добили после куповине и кликните Настави.
4. После активације лиценце отварају се подешавања додатка. Наставите са првим подешавањем.

Подешавања се касније отварају из WooCommerce → Подешавања → Плаћања → NikolicWP NestPay → Управљај. Додатак нема сопствени мени; све је на једном екрану у WooCommerce-у.

↑ Садржај

5. Лиценца

• Пакети: годишња лиценца за 1 сајт (Персонални), 5 сајтова (Пословни) или 10 сајтова (Професионални). Све могућности су у сваком пакету; разлика је само у броју сајтова.
• Активација: кључ се активира једном по сајту, у чаробњаку после активације додатка. Плаћање картицама се нуди купцима тек када је лиценца активирана на сајту.
• Локални и тест сајтови не троше место: localhost, *.local, *.test, staging.* и dev.*.
• Шта покрива лиценца: нове верзије и подршку.
• Када лиценца истекне: плаћање картицама ради као и до тада, са свим подешавањима. Само не добијате нове верзије и подршку док лиценцу не обновите. У заглављу подешавања пише „Лиценца је истекла – плаћање ради, без ажурирања и подршке“.
• Одељак Лиценца у подешавањима додатка приказује стање, кључ (скривен), датум важења, број сајтова, последњу проверу и дугмад Провери сада, Деактивирај на овом сајту, Обновите лиценцу и Моје лиценце. Уз активну лиценцу ту је и картица Подршка са дугметом „Пошаљи дијагностику и отвори тикет“.
• Пренос на други сајт: на старом сајту кликните Деактивирај на овом сајту. Тиме ослобађате место, а на том сајту се плаћање картицама искључује док кључ поново не активирате.
• Поновна инсталација: деактивација и поновна активација самог додатка (у листи Додаци) не троши ново место и не искључује плаћања – сачувани кључ се поново активира сам.
• Опозвана лиценца (на пример после повраћаја новца за куповину лиценце) искључује плаћање картицама.

↑ Садржај

6. Прво подешавање корак по корак

1. Банка: у одељку Банка оставите Banca Intesa (или изаберите другу банку, види Друге банке).
2. Тест приступни подаци: упишите тест Client ID и Store Key, а ако сте га направили, и тест API корисничко име и лозинку.
3. Опште: укључите Укључи NestPay и оставите Тест режим укључен.
4. Приказ: упишите назив, ПИБ и адресу трговца (или оставите празно да се користе подаци продавнице). Проверите траку са логотипима у прегледу уживо.
5. Безбедност: укључите reCAPTCHA v3 и упишите кључеве (банка тражи CAPTCHA за купце без налога).
6. Услови куповине: у WooCommerce → Подешавања → Напредно изаберите страну са условима, да би се на наплати појавио квадратић који купац мора да означи.
7. Кликните Сачувај измене.
8. Повратне адресе: на дну подешавања (okUrl / failUrl) и у Упутству су адресе ваше продавнице на које банка шаље резултат. Додатак их шаље банци уз сваки захтев, али проверите да су доступне преко јавног HTTPS-а.
9. Тест плаћања: направите пробне куповине тест картицама банке. Одељак Сертификација показује шта још треба урадити и сам попуњава табелу за банку (види Сертификација).
10. Продукција: када банка потврди сертификацију и пошаље продукционе податке, упишите их и искључите Тест режим (види Прелазак на продукцију).

Сва подешавања већ имају препоручене вредности, па за већину продавница остало не треба мењати.

↑ Садржај

7. Екран подешавања

Екран има заглавље и леву навигацију са одељцима.

Заглавље показује верзију, да ли је активан тест или продукциони режим и стање лиценце (клик води на одељак Лиценца).

Одељци са подешавањима: Опште, Банка, Тест приступни подаци, Продукциони приступни подаци, Трансакција, После плаћања, Страница банке за плаћање, Безбедност, Приказ и Напредно.

Остали одељци: Трансакције (листа свих NestPay поруџбина), Сертификација (само у тест режиму), Упутство и Лиценца.

Помоћ при раду:

• Преглед уживо – на дну одељака Опште, Банка, Трансакција, После плаћања и Приказ видите како ће измена изгледати: начин плаћања на наплати, износ који се наплаћује, шта се дешава са поруџбином, потврду за купца и траку са логотипима. Преглед одмах прати формулар; ништа се не чува док не кликнете Сачувај измене.
• Објашњење уз сваку опцију стоји испод поља и каже чему служи и која је вредност препоручена.
• Иконица књиге уз наслов одељка и уз сваку опцију отвара одговарајуће поглавље Упутства; дугме ← Назад на подешавање враћа вас на исту опцију.
• Врати препоручена подешавања – дугме на дну одељка поново уписује препоручене вредности. Приступни подаци, кључеви и подаци трговца се не дирају; измена остаје тек после Сачувај измене.
• Одустани од измена – појављује се поред дугмета за чување чим нешто промените и враћа формулар на сачувано стање.
• Упутство – сва поглавља на једном месту, са претрагом која ради на ћирилици и латиници, са и без квачица.

↑ Садржај

8. Подешавања – све опције

Вредности означене као препоручене су уједно и подразумеване.

Опште

Банка

Тест и продукциони приступни подаци

Додатак чува оба скупа података, па се у тест режим можете вратити у сваком тренутку.

Трансакција

После плаћања

Страница банке за плаћање

Безбедност

Приказ

Напредно

↑ Садржај

9. СМС или DMS

SMS (Auth) одмах наплаћује картицу. То је најједноставнији модел, препоручен за робу која се одмах шаље и за услуге.

DMS (PreAuth) само резервише износ на картици купца. Новац се скида тек када га наплатите:

• ручно, дугметом Наплати у NestPay оквиру на поруџбини (може и мањи износ – делимична наплата);
• аутоматски, када поруџбину означите као Завршена (уз укључену „Наплату при завршетку“);
• аутоматски после одређеног броја дана („Аутоматска наплата после (дана)“).

Банка гарантује резервацију 7 дана и дозвољава наплату тек када је роба послата. Резервације старије од 6 дана приказују се у обавештењу у администрацији, а „Резервација пред истеком“ 24 сата пре истека шаље мејл продавници или ослобађа резервацију. Ако откажете поруџбину, резервација се ослобађа и купац се не задужује.

↑ Садржај

10. Статуси поруџбине после плаћања

СМС – уобичајен ток: купац плати, новац се наплаћује одмах и поруџбина добија статус У обради. Ви пошаљете робу и сами означите поруџбину као Завршена. Поруџбине само са виртуелним производима или производима за преузимање WooCommerce сам завршава.

DMS – резервација, па наплата: купац плати, банка резервише износ и поруџбина добија статус На чекању. Када пошаљете робу, означите поруџбину као Завршена – додатак тада наплаћује резервисани износ, а поруџбина остаје Завршена. Ако наплата не успе, поруџбина се враћа на На чекању уз белешку, а купац не добија мејл „поруџбина завршена“.

Поништавање ослобађа резервацију или поништава плаћање од истог дана пре него што га банка прокњижи (до краја дана). Поруџбина добија статус Отказано. За плаћање које је већ прокњижено користите повраћај новца.

Неуспело плаћање: картица је одбијена или је купац одустао на страници банке. Поруџбина добија статус Неуспешно и купац може поново да плати из Мог налога. Сваки нови покушај шаље се банци са новим бројем (oid), јер банка сваки прихвата само једном.

Преглед уживо у одељку После плаћања црта ток статуса за ваша подешавања – за СМС, DMS, отказану поруџбину и одбијену картицу.

↑ Садржај

11. Рад са поруџбинама

Свака поруџбина плаћена преко додатка има NestPay оквир на екрану поруџбине. У њему су:

• стање плаћања (наплаћено, резервисано, враћен новац, делимично враћен, поништено), износ наплате и повраћаја;
• подаци трансакције: TransId, AuthCode, mdStatus, картица (маскирана), курс и његов извор када је поруџбина у другој валути;
• историја покушаја – сваки покушај плаћања са својим бројем за банку (oid), резултатом и картицом;
• дугме Освежи, које приказује најновије податке без поновног учитавања поруџбине.

Дугмад (потребан је API корисник):

Повраћај новца (цео или део) радите стандардним WooCommerce дугметом Повраћај испод ставки поруџбине – додатак га шаље банци. Повраћај се односи на већ прокњижено плаћање; исти дан је уместо тога довољно поништавање.

Свака операција (наплата, повраћај, поништавање) уписује се у белешке поруџбине, са својим TransId-ом. Ако операција не успе, тачна грешка банке је у белешкама.

Када је поруџбина у другој валути, испод поља за износ наплате пише у којој валути банка наплаћује (нпр. „Банка наплаћује у RSD; износ поруџбине је €10.00.“).

↑ Садржај

12. Недовршена плаћања и аутоматско усклађивање

Купац који плати, а затим затвори прегледач на страници банке, никад се не врати у продавницу. Без усклађивања поруџбина би остала „Чека се уплата“ – или „Неуспешно“, ако је први покушај одбијен, а поновљени успео.

Зато додатак на сваких 15 минута пита банку за такве поруџбине из последња 24 сата и потврђује их (потребан је API корисник). Када се плаћање пронађе за поруџбину која је већ била неуспешна или отказана, продавница добија и мејл „[NestPay] Пронађено плаћање…“, да не пропустите слање.

Дугме Усклади сада у одељку Трансакције покреће проверу одмах.

Без API корисника усклађивање не ради, а додатак вас на то упозорава у администрацији. Такве поруџбине тада проверавате ручно у Merchant Center-у.

Плаћање није могло да се потврди: када одговор банке стигне без исправног потписа (најчешће погрешно прекопиран Store Key), додатак не потврђује плаћање, а купцу не пише да картица није задужена – јер можда јесте. Купац добија поруку да не плаћа поново и да се јави продавници, поруџбина добија белешку, а провера статуса пита банку шта се десило.

↑ Садржај

13. Трансакције

Одељак Трансакције у подешавањима је листа свих поруџбина плаћених преко додатка.

• Филтери: све, наплаћено, резервисано, враћен новац, поништено, неуспешно, недовршено.
• Период, претрага по броју поруџбине, OID-у, TransId-у, AuthCode-у, картици, имену или мејлу купца, сортирање по датуму или износу, 10/20/50/100 по страни.
• Само тест плаћања – приказује плаћања направљена у тест режиму.
• Преузми CSV (тренутни филтер) – извоз за књиговођу или за банку. Фајл се отвара у Excel-у са исправним словима.
• Усклади сада – одмах пита банку за недовршена плаћања.
• Освежи – поново учитава листу са истим филтерима, претрагом и страном.

Клик на број поруџбине отвара поруџбину.

↑ Садржај

14. Цене у еврима и курс НБС

Banca Intesa домаћим трговцима наплаћује у динарима (валута 941). Ако продавница продаје у еврима или другој валути, купцу се наплаћује прерачунат износ у динарима.

• Средњи курс НБС (препоручено): преузима се аутоматски сваки дан у 8:30 и чува на сајту. Ако не може да се преузме, користи се последњи познати курс до 7 дана, па сопствени курсеви. Плаћање никад не чека на преузимање курса.
• Моји курсеви: један курс по реду у пољу „Конверзија валуте“, нпр. EUR=117.20.
• Корекција курса (%) додаје разлику, нпр. до курса који користи ваша банка.
• Тренутни курс се приказује у одељку Трансакција, а преглед уживо показује колико се наплаћује за неколико примера износа.
• Курс и његов извор („НБС“ са датумом курсне листе, или сопствени курс) чувају се на свакој поруџбини и виде се у NestPay оквиру.

Поруџбине у валути за коју нема курса не могу да се плате овим начином, а додатак вас упозорава у администрацији.

Купци у Србији: Закон о заштити потрошача тражи цене у динарима; цена у еврима може да стоји поред. Најједноставније је да продавница буде у динарима, а продавница у еврима више одговара купцима из иностранства. Детаље проверите са књиговођом и банком.

↑ Садржај

15. Шта банка захтева на сајту

Banca Intesa пре пуштања у рад проверава сајт по свом упутству за трговце. Додатак решава део који се тиче плаћања; остало су стране сајта.

Логотипи. Лого банке (са линком на сајт банке), знакови картица (Visa, Mastercard, Maestro, American Express, DinaCard) као једна група и знакови Visa Secure и Mastercard ID Check као посебна група, са линковима које прописује банка – на почетној страни и свуда где купац бира начин плаћања. Додатак садржи званичне слике банке и распоређује их по њеним правилима (исте величине, размак између група, једна група програма по страни).

• Логотипи у подножју стављају траку на дно сваке стране.
• Кратки код [nestpay_logos] поставља траку било где другде, уз атрибуте size="small|medium|large" и dark="1" за тамну позадину.
• Знакови картица поред начина плаћања на наплати укључени су подразумевано.

Услови куповине. Купац мора изричито да их прихвати (квадратић) пре плаћања. WooCommerce приказује квадратић када је страна са условима изабрана у WooCommerce → Подешавања → Напредно. Додатак вас подсећа док страна није подешена.

Потврда о плаћању. После успешног плаћања купац на сајту и у мејлу види податке трансакције (Order ID, AuthCode, Response, ProcReturnCode, mdStatus, датум) и назив, ПИБ и адресу трговца.

Одбијена плаћања. Купац никад не види банкин разлог одбијања, само општу поруку: да провери број картице, рок важења и CVC, покуша поново или се јави својој банци.

CAPTCHA. Обавезна за купце без налога – укључите reCAPTCHA в3 у одељку Безбедност.

Стране сајта (нису део додатка): контакт са подацима трговца (назив, адреса, ПИБ, матични број, телефон, мејл), услови куповине, испорука, повраћај и рекламације, политика приватности, цене у динарима.

Друга банка може имати другачија правила – пратите њено упутство.

↑ Садржај

16. Сертификација код банке

Пре продукције банка тражи да на њеном тест окружењу прођете списак тест плаћања и да јој пошаљете резултате. Одељак Сертификација (лево, испод Трансакција) води ту евиденцију уместо вас. Види се само док је укључен тест режим.

1. Сајт – списак онога што банка проверава, са ознаком „Спремно“ или „Треба урадити“ и линком „Отвори подешавање“: тест приступни подаци, API корисник, HTTPS, услови куповине, политика приватности, подаци трговца, подаци о трансакцији на сајту и у мејлу, логотипи, CAPTCHA, а за Intesu и hash ver2 и рате. Ставке које додатак не може да провери („Проверите сами“): контакт страна са подацима фирме, испорука, повраћај и рекламације, цене у динарима.

2. Тест плаћања за изабрану врсту трансакције:

Уз то и одобрено плаћање сваком тест картицом коју је банка навела (Visa, Mastercard, Maestro, American Express, DinaCard).

Сваки ред се сам попуњава из најновије тест поруџбине: поруџбина, OID, TransId, AuthCode, износ, датум, картица и резултат. Повраћај радите дан после плаћања, јер исти дан додатак уместо повраћаја ради поништавање.

Дугмад Преузми CSV, Одштампај и Освежи дају табелу за банку. Пошаљите је банци, уз извоз из Merchant Center-а ако га тражи. Банка затим прегледа сајт и издаје продукционе параметре.

↑ Садржај

17. Прелазак на продукцију

1. Када банка потврди сертификацију, упишите продукциони Client ID, Store Key и API корисника у Продукциони приступни подаци. API корисника за продукцију правите у продукционом Merchant Center-у.
2. По жељи укључите Само администратори и направите једну праву куповину малим износом, па је поништите.
3. Искључите Тест режим и, ако сте га укључили, Само администратори. Кликните Сачувај измене.
4. Заглавље подешавања сада показује продукциони режим, а одељак Сертификација се више не приказује.

Тест подаци остају сачувани, па се за проверу можете вратити у тест режим у сваком тренутку.

↑ Садржај

18. Друге банке које користе NestPay

NestPay (платформа Payten / Asseco SEE) користи више банака. Све раде на исти начин, а разликују се адресе, назив и логотип.

• Banca Intesa је подешена и проверена: изаберите је у одељку Банка и ништа друго није потребно.
• Друга банка: изаберите „Друга банка која користи NestPay“ и упишите назив, сајт и логотип банке и адресе њене странице за плаћање за тест и продукцију из уговора. Адреса API-ја се изводи из њих, осим ако вам банка да другу.
• Све остало – СМС и DMS, наплата, поништавање, повраћај, провера статуса, логотипи, прегледи – ради исто.
• Без адресе странице за плаћање начин плаћања се не приказује купцима, а додатак вас упозорава.
• Друге банке нису проверене на њиховом тест окружењу. Пре продукције прођите банкин тест, а правила (CAPTCHA, логотипи, рате, верзија hash-а) пратите по упутству своје банке.

↑ Садржај

19. Безбедност и приватност

• Подаци картице никад не долазе на ваш сајт. Купац их уписује на страници банке; додатак види само маскиран број.
• Сваки одговор банке се проверава: потпис (hash) Store Key-ем, број поруџбине, износ и валута. Одговор без исправног потписа никад не потврђује плаћање, а одговор без потписа не оставља ни белешку на поруџбини.
• Поновљен или закаснео одговор (купац притисне Назад) не мења поруџбину која је већ плаћена.
• Заштита од тестирања картица: reCAPTCHA в3 и ограничење неуспелих покушаја по IP адреси.
• Лог: потпис банке се никад не уписује; број картице, мејл, име, адреса и телефон су маскирани, а уноси старији од 7 дана бришу се сами.
• Спољни сервиси: додатак разговара само са банком, са Google reCAPTCHA (ако је укључена) и са јавном курсном листом НБС (kurs.resenje.org, ако користите курс НБС). Провера лиценце шаље кључ, адресу сајта и верзије WordPress-а и додатка серверу nikolicwp.rs.

↑ Садржај

20. Компатибилност

• WooCommerce: класична страница за плаћање (кратки код) и блоковска страница за плаћање; HPOS складиште поруџбина.
• Теме: додатак нема сопствени изглед на сајту – поруке, дугмад, мејлови и потврда користе класе WooCommerce-а и стил ваше теме (проверавано са Blocksy и Twenty Twenty-Five). Страница банке има изглед банке.
• Други NestPay додаци: од верзије 2.0.0 додатак има сопствени ИД начина плаћања (nwp_nestpay) и ради упоредо са другим NestPay додацима, без мешања подешавања и поруџбина. Подешавања и поруџбине из ранијих верзија преносе се сами.
• NikolicWP Pismo: све поруке и потврде су на писму које је купац изабрао, а називи као NestPay и Banca Intesa остају латиницом.
• Валуте: било која валута продавнице уз курс НБС или сопствени курс; банка наплаћује у валути трговца.

↑ Садржај

21. Ажурирање, деактивација и брисање

Ажурирање: као сваки други додатак (Контролна табла → Ажурирања), док је лиценца активна. Подешавања, приступни подаци и поруџбине остају.

Деактивација: начин плаћања нестаје са наплате, а поруџбине и подешавања остају. Поновном активацијом све ради као пре.

Брисање: Додаци → NikolicWP NestPay → Деактивирај → Обриши. Подешавања, приступни подаци и запис о лиценци бришу се само ако сте укључили Напредно → Брисање података. Поруџбине и подаци о трансакцијама се никад не бришу – то је евиденција продавнице.

↑ Садржај

22. За програмере

Кратки код: [nestpay_logos size="small|medium|large" dark="0|1"]

Повратна адреса (okUrl / failUrl): /wc-api/nwp_nestpay/?nestpay_result=ok и /wc-api/nwp_nestpay/?nestpay_result=fail. Стара адреса WC_Gateway_NestPay и даље ради за плаћања започета раније.

ИД начина плаћања: nwp_nestpay. Опција са подешавањима: woocommerce_nwp_nestpay_settings.

Филтери:

Подаци на поруџбини (мета): _nestpay_oid, _nestpay_attempts, _nestpay_oid_history, _nestpay_test_mode, _nestpay_rate_source.

Лог: WooCommerce → Status → Logs, извори nwp-nestpay и nwp-nestpay-api.

↑ Садржај

23. Решавање проблема

Начин плаћања се не види на наплати

Проверите: да је лиценца активирана на сајту; да је укључено „Укључи NestPay“; да су уписани приступни подаци за активни режим (тест или продукција); да валута продавнице има курс; да није укључено „Само администратори“ док нисте пријављени као администратор; за другу банку – да је уписана адреса странице за плаћање. Обавештења на врху екрана подешавања наводе тачан узрок.

Поруџбина остаје „Чека се уплата“ после плаћања

Банка није успела да врати резултат или га додатак није могао да провери. Проверите да је Store Key тачно прекопиран (без размака), да је верзија hash-а ver2 и да је повратна адреса доступна преко јавног HTTPS-а (заштитни зид, додатак за безбедност или заштита од ботова не сме да блокира POST захтеве банке на /wc-api/nwp_nestpay/). Уз API корисника поруџбина се потврђује сама у року од 15 минута, а одмах дугметом „Провери статус у банци“.

Купац добија поруку „Плаћање није могло да се потврди“

Одговор банке није имао исправан потпис – најчешће због погрешног Store Key-а или Store Key-а из другог режима (тест уместо продукције). Проверите кључ, па „Провери статус у банци“ на поруџбини. Ако се дешава са исправним кључем, укључите лог и пошаљите га подршци.

Наплата, поништавање или повраћај не успева

Недостају или су погрешни API корисник и лозинка за активни режим, или API корисник нема права у Merchant Center-у. Тачна грешка банке је у белешкама поруџбине.

Банка одбија захтев са order id already used

Банка сваки број за банку (oid) прихвата само једном. Додатак сваки покушај шаље са новим бројем; ако сте ручно мењали поруџбину или користите други додатак за плаћање упоредо, отворите страну за плаћање поново да би се направио нови број.

Купац не види поруку после одбијеног плаћања

Порука се приказује на страници за плаћање поруџбине и не зависи од колачића. Ако је не види, проверите да кеш страница не кешира странице „Плаћање“ и „Мој налог“.

Трака са логотипима се не види или се види два пута

Укључите „Логотипи у подножју“ или ставите кратки код [nestpay_logos]. На страни са кратким кодом трака у подножју се не приказује. Ако тема има тамно подножје, укључите „Тамна позадина“.

Курс НБС се не преузима

Сервер не може да приступи kurs.resenje.org или WordPress cron не ради. Додатак користи последњи познати курс до 7 дана, па сопствене курсеве. Проверите да ли хостинг блокира спољне захтеве, или привремено изаберите „Моји курсеви“.

Debug лог

Укључите Напредно → Дневник за отклањање грешака, поновите проблем и отворите WooCommerce → Status → Logs (извори nwp-nestpay и nwp-nestpay-api). Лични подаци су маскирани, а потпис банке се не уписује. После решавања искључите лог.

Како да пошаљем податке подршци

У одељку Лиценца кликните Пошаљи дијагностику и отвори тикет. Шаљу се адреса сајта, верзије додатка, WordPress-а, WooCommerce-а и PHP-а, тема и активни додаци – никад приступни подаци банке ни подаци купаца. „Шта се шаље“ приказује тачан садржај пре слања.

↑ Садржај

24. Честа питања

Да ли купац уписује податке картице на мом сајту?

Не. Купац податке картице уписује на сигурној страници банке („3D Pay Hosting“). Ваш сајт и додатак виде само маскиран број картице и резултат плаћања.

Са којим банкама ради NikolicWP NestPay?

Подешен је и проверен за Banca Intesa. Ради и са другим банкама које користе NestPay платформу – уписују се адресе из уговора са банком, уз банкин тест пре продукције.

Које картице купци могу да користе?

Visa, Mastercard, Maestro, American Express и DinaCard, уз 3-D Secure проверу (Visa Secure, Mastercard ID Check). Које картице прихватате одређује уговор са банком.

Шта ми треба од банке?

Уговор о интернет продаји, тест Client ID и Store Key, приступ Merchant Center-у и, после сертификације, продукциони Client ID и Store Key. API корисника за наплату, поништавање, повраћај и проверу статуса правите сами у Merchant Center-у.

Да ли морам да имам API корисника?

Плаћања раде и без њега. API корисник је потребан за наплату (DMS), поништавање, повраћај новца из WooCommerce-а, проверу статуса и аутоматско потврђивање плаћања купаца који се нису вратили са странице банке. Препоручује се.

Која је разлика између СМС и DMS?

СМС наплаћује картицу одмах. DMS само резервише износ на 7 дана, а наплаћујете га када пошаљете робу – ручно, када поруџбину означите као Завршена, или аутоматски после одређеног броја дана.

Како да вратим новац купцу?

На поруџбини кликните WooCommerce дугме Повраћај испод ставки и упишите цео или део износа – додатак га шаље банци. Плаћање од истог дана се уместо тога поништава дугметом „Поништи плаћање (истог дана)“ у NestPay оквиру.

Шта ако купац затвори прегледач после плаћања на страници банке?

Додатак на сваких 15 минута пита банку за недовршена плаћања и сам потврђује поруџбину (потребан је API корисник). Ако је поруџбина у међувремену била неуспешна или отказана, добијате и мејл.

Могу ли да продајем у еврима?

Можете. Банка наплаћује у динарима, а додатак прерачунава износ по средњем курсу НБС, који се преузима аутоматски сваки дан, или по вашем курсу. Купцима у Србији цене треба приказати у динарима.

Шта банка проверава на мом сајту?

Логотипе банке и картица, услове куповине са квадратићем, потврду о плаћању са подацима трговца, CAPTCHA за купце без налога, контакт са подацима фирме, испоруку, повраћај и рекламације и политику приватности. Одељак Сертификација показује шта је спремно, а шта треба урадити.

Како се ради сертификација код банке?

У тест режиму направите тест плаћања са банкиног списка. Одељак Сертификација сам попуњава табелу (поруџбина, OID, TransId, AuthCode, износ, резултат), коју преузимате као CSV или штампате и шаљете банци.

Да ли могу да користим NikolicWP NestPay уз други NestPay додатак?

Можете. Од верзије 2.0.0 додатак има сопствени ИД начина плаћања (nwp_nestpay), па ради упоредо са другим NestPay додацима без мешања подешавања и поруџбина.

Ради ли са блоковском страницом за плаћање?

Да – и са класичном и са блоковском страницом за плаћање, и са HPOS складиштем поруџбина.

Да ли додатак прати изглед моје теме?

Да. Поруке, дугмад, мејлови и потврда користе стил ваше теме. Страница банке за унос картице има изглед банке.

Шта се дешава када лиценца истекне?

Плаћање картицама ради као и до тада, са свим подешавањима. Само не добијате нове верзије и подршку док лиценцу не обновите.

На колико сајтова могу да користим лиценцу?

Зависно од пакета: 1, 5 или 10 сајтова. Локални и тест сајтови не троше место. Деактивацијом на једном сајту ослобађате место за други.

Да ли је NikolicWP NestPay званични додатак банке?

Не. То је независан додатак бренда NikolicWP, направљен по техничким упутствима банке за трговце. Banca Intesa и Payten га не подржавају званично.

Шта ако обришем додатак?

Поруџбине и подаци о трансакцијама се никад не бришу. Подешавања и приступни подаци бришу се само ако сте укључили „Брисање података“ у одељку Напредно.

↑ Садржај

25. Брза референца

NikolicWP NestPay је производ бренда NikolicWP – https://nikolicwp.rs. Документација важи за верзију 2.2.0, ажурирано 20. октобра 2026.