Спочатку відкрийте консоль браузера: віджет пише попередження з префіксом [Neocarts].
| Симптом |
Причина |
Виправлення |
Кнопки немає, у консолі <neocarts-button …> hidden: missing or invalid … |
бракує обовʼязкового атрибута або він невалідний |
виправити атрибути — Кнопка підписки |
| Кнопки немає, у консолі нічого |
на сторінці немає shop id |
додати data-shop-id або викликати init({ shopId }) — Підключення |
Кнопки немає, у консолі … is not ready |
магазин не налаштував оплату або доставку |
завершити Оплату і Доставку |
| Кнопки немає, запит конфігурації магазину повертає 422 |
хибний shop id |
звірити з вкладкою «Інтеграція» в панелі |
| Ціна в 100 разів менша |
amount у гривнях |
передавати копійки: 249000, а не 2490 |
| «Регулярна доставка з Neocarts» замість знижки |
у магазину немає знижки — це не помилка |
задати знижку в Підписках |
| Кнопка вузька там, де чекали широку |
контейнер вужчий, ніж здається, або має display: contents |
поставити кнопку в блоковий контейнер потрібної ширини |
Покупець додав підписку, а в замовленні one_time |
items зібрані без getOrderItems() або product-id ≠ external_id |
будувати items через getOrderItems(lines) |
select() кидає TypeError |
інтервал поза межами магазину або невідомий mode |
брати значення з config().intervals |
| Симптом |
Причина |
Виправлення |
open() відхиляється з Shop is not ready |
магазин не налаштував оплату або доставку |
завершити налаштування в панелі |
open() відхиляється зі status: 404, надходить order-missing |
хибний id, замовлення видалене або оплачене/скасоване понад 24 години тому |
створити нове замовлення |
order-missing з cancelled |
замовлення скасоване в панелі |
створити нове замовлення |
| Оформлення відкривається двічі, події дублюються |
скрипт підключено більше одного разу |
лишити один тег у спільному шаблоні |
| Сторінка оплати не відкривається, помилка CSP |
frame-src не дозволяє домен платіжної системи |
доповнити CSP — Підключення |
| Після оплати кошик не спорожнів |
немає обробника neocarts:paid |
додати обробник — Події |
409 на PUT /v1/shop/orders/{order}/items |
покупець уже перейшов до оплати, склад зафіксовано |
створити нове замовлення й відкрити його |
| Оформлення англійською на українському сайті |
<html lang="en"> або замовлення з locale: en |
задати lang="uk" і правильний locale |
| Симптом |
Причина |
Виправлення |
window.NeocartsSubscription — undefined |
ваш код виконується раніше за скрипт |
дочекатися neocarts:ready |
| Скрипт або запити блокуються |
CSP не дозволяє cdn.neocarts.com / core.neocarts.com |
доповнити CSP |
| Шрифт системний |
заблоковано Google Fonts |
дозволити fonts.googleapis.com і fonts.gstatic.com |
| «Забагато запитів — зачекайте хвилину» |
понад 60 запитів/хв з однієї IP-адреси |
зачекати хвилину; не викликати config() у циклі |
Напишіть на [email protected]: shop id, номер замовлення (number), час і скриншот консолі.