Події
Віджет повідомляє сторінку про важливі моменти подіями на 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.
Приклад
Section titled “Приклад”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 });Деталі
Section titled “Деталі”neocarts:ready
Section titled “neocarts:ready”Надходить один раз. Якщо ваш код виконується пізніше, події вже не буде — тому спочатку перевіряйте window.NeocartsSubscription, як у прикладі.
neocarts:paid
Section titled “neocarts:paid”Надходить після підтвердження оплати — у відкритому checkout або коли покупець знову відкрив уже оплачене замовлення. Віджет до цього моменту вже очистив вибір покупця. Сервер отримує вебхук order.paid — для виконання замовлення спирайтеся на нього, а не на подію в браузері.
neocarts:order-missing
Section titled “neocarts:order-missing”reason |
Коли |
|---|---|
not_found |
id хибний, замовлення видалене або оплачене/скасоване понад 24 години тому |
cancelled |
замовлення скасоване в панелі |
neocarts:close
Section titled “neocarts:close”Лише коли checkout закриває покупець (✕, Esc, екран успіху). Виклик close() подію не надсилає. Після оплати спершу надходить neocarts:paid, а neocarts:close — коли покупець закриє екран успіху.