Підключення
Один скрипт підключає обидва віджети — кнопки підписки й checkout. Додайте його в спільний шаблон сайту.
<script src="https://cdn.neocarts.com/bundle.js" data-shop-id="SHOP_UUID" defer></script>| Атрибут | Обовʼязковий | Опис |
|---|---|---|
src |
так | https://cdn.neocarts.com/bundle.js. Без версії: завжди поточна збірка, зміни зворотно сумісні. |
data-shop-id |
так | ID магазину (UUID). Потрібен кнопкам підписки, config() та openHowItWorks(). |
defer |
рекомендовано | Скрипт не блокує завантаження сторінки. |
Після завантаження скрипт створює window.NeocartsSubscription, реєструє елемент <neocarts-button> і надсилає подію neocarts:ready.
Де взяти shop id
Section titled “Де взяти shop id”У панелі магазину: Налаштування → Інтеграція, поле «ID магазину». Shop id не секретний, на відміну від API-ключа.

SPA та модулі
Section titled “SPA та модулі”Якщо тег додається динамічно або скрипт завантажується як модуль, data-shop-id не прочитається. Передайте shop id викликом:
NeocartsSubscription.init({ shopId: 'SHOP_UUID' });Кнопки, які вже є на сторінці, зʼявляться одразу після виклику. init() можна викликати повторно з іншим магазином.
Коли віджет готовий
Section titled “Коли віджет готовий”Ваш код може виконатися раніше за скрипт. Перевіряйте глобальний обʼєкт, а якщо його ще немає — дочекайтеся neocarts:ready:
const ready = () => { const nc = window.NeocartsSubscription; // підписки на події, config(), open()};if (window.NeocartsSubscription) ready();else document.addEventListener('neocarts:ready', ready, { once: true });Повернення до оформлення: ?neocarts=checkout
Section titled “Повернення до оформлення: ?neocarts=checkout”Якщо адреса сторінки містить ?neocarts=checkout (або #neocarts-checkout), віджет знову відкриває незавершене оформлення покупця в цьому браузері й прибирає маркер з адреси. Якщо оформлення немає — нічого не відбувається.
Зручно для redirect_url замовлення та посилань «повернутися до оплати».
Content Security Policy
Section titled “Content Security Policy”Якщо на сайті є CSP, дозвольте:
| Директива | Значення |
|---|---|
script-src |
https://cdn.neocarts.com |
connect-src |
https://core.neocarts.com |
style-src |
https://fonts.googleapis.com |
font-src |
https://fonts.gstatic.com |
frame-src |
домен платіжної системи магазину (сторінка оплати відкривається у вікні checkout) |
Домен платіжної системи залежить від провайдера в Налаштуваннях → Оплата.