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

Події

Віджет повідомляє сторінку про важливі моменти подіями на document. Підписуйтеся через NeocartsSubscription.on(name, fn) — обробник отримує дані події й повертає функцію відписки. Підійде й document.addEventListener (дані — у event.detail).

Подія Дані Коли Що робити
neocarts:ready {} скрипт завантажено ініціалізувати свій код
neocarts:selection-change усі вибори: Record<external_id, Selection> покупець змінив підписку в кнопці; ваш select() / remove() / clear(); зміна в іншій вкладці оновити кошик і перемикачі
neocarts:paid { number } оплату підтверджено спорожнити кошик, забути order.id
neocarts:order-missing { reason: 'not_found' | 'cancelled' } замовлення недоступне забути order.id, наступного разу створити нове
neocarts:close {} покупець закрив checkout за потреби — аналітика, фокус

Назви також доступні як NeocartsSubscription.events.Ready, .SelectionChange, .Paid, .OrderMissing, .Close.

const ready = () => {
const nc = window.NeocartsSubscription;
nc.on(nc.events.Paid, ({ number }) => {
cart.clear();
localStorage.removeItem('my-shop:order-id');
showNotice(`Оплачено: замовлення № ${number}`);
});
nc.on(nc.events.OrderMissing, () => {
localStorage.removeItem('my-shop:order-id');
showError('Замовлення більше недоступне — оформіть нове.');
});
nc.on(nc.events.SelectionChange, (all) => renderCart(all));
};
if (window.NeocartsSubscription) ready();
else document.addEventListener('neocarts:ready', ready, { once: true });

Надходить один раз. Якщо ваш код виконується пізніше, події вже не буде — тому спочатку перевіряйте window.NeocartsSubscription, як у прикладі.

Надходить після підтвердження оплати — у відкритому checkout або коли покупець знову відкрив уже оплачене замовлення. Віджет до цього моменту вже очистив вибір покупця. Сервер отримує вебхук order.paid — для виконання замовлення спирайтеся на нього, а не на подію в браузері.

reason Коли
not_found id хибний, замовлення видалене або оплачене/скасоване понад 24 години тому
cancelled замовлення скасоване в панелі

Лише коли checkout закриває покупець (✕, Esc, екран успіху). Виклик close() подію не надсилає. Після оплати спершу надходить neocarts:paid, а neocarts:close — коли покупець закриє екран успіху.