Перейти до вмісту

Підключення

Один скрипт підключає обидва віджети — кнопки підписки й 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.

У панелі магазину: Налаштування → Інтеграція, поле «ID магазину». Shop id не секретний, на відміну від API-ключа.

Вкладка «Інтеграція» в панелі магазину

Якщо тег додається динамічно або скрипт завантажується як модуль, data-shop-id не прочитається. Передайте shop id викликом:

NeocartsSubscription.init({ shopId: 'SHOP_UUID' });

Кнопки, які вже є на сторінці, зʼявляться одразу після виклику. init() можна викликати повторно з іншим магазином.

Ваш код може виконатися раніше за скрипт. Перевіряйте глобальний обʼєкт, а якщо його ще немає — дочекайтеся 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 замовлення та посилань «повернутися до оплати».

Якщо на сайті є 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)

Домен платіжної системи залежить від провайдера в Налаштуваннях → Оплата.