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

Кнопка підписки

Кнопка підписки показує ціну зі знижкою за підпискою і дає покупцю обрати, як часто доставляти товар. Ставиться під кнопкою «Купити» на сторінці товару, у картці каталогу або в рядку кошика.

Кнопка підписки: оформлена (ліворуч) і доступна (праворуч)

  • Ціна за підпискою та розмір знижки прямо на кнопці.
  • Вибір частоти доставки з пресетів магазину або власний інтервал.
  • Зміна та видалення підписки на товар.
  • Однаковий стан на всіх сторінках і вкладках: сторінка товару, каталог, кошик.
  1. Покупець натискає «Оформити підписку» — відкривається вікно вибору частоти.
  2. Обирає частоту й натискає «Додати підписку». Кнопка переходить у стан «Підписку додано».
  3. Вибір зберігається в браузері покупця. Ваш кошик бере його через getOrderItems(), коли створює замовлення.

Кнопка не додає товар у кошик і не створює замовлення — це робить ваша сторінка.

<neocarts-button
product-id="food"
amount="249000"
title="Brit Care Adult Large Breed Lamb & Rice"
image="https://shop.example.com/img/brit-care-12kg.png"
variant="12 кг"
checkout-url="/cart"
></neocarts-button>

Скрипт має бути підключений на сторінці.

Атрибут Тип Обовʼязковий Опис
product-id рядок так Ваш ID товару — той самий external_id, що в рядку замовлення. Приклад: food
amount ціле так Ціна однієї одиниці в копійках, до знижки, більше 0. Приклад: 249000 = 2 490,00 ₴
title рядок так Назва товару у вікні підписки
image URL так Зображення товару у вікні підписки
variant рядок ні Варіант під назвою. Приклад: 12 кг
checkout-url URL ні Додає кнопку «Перейти до оформлення» після збереження підписки. Лише http(s) або відносний шлях

Якщо обовʼязкового атрибута бракує або amount не є цілим додатним числом, кнопка не показується, а в консолі зʼявляється попередження з переліком проблем:

[Neocarts] <neocarts-button product-id="food"> hidden: missing or invalid amount, image

Атрибути можна змінювати скриптом — кнопка оновиться сама. Додавати кнопки можна будь-коли (SPA, нескінченна прокрутка).

Стан Коли Що бачить покупець
Доступна підписки на товар немає «Оформити підписку», «−7% на кожну доставку», стара й нова ціна
Оформлена покупець додав підписку «Підписку додано», ціна з підпискою та знижка, частота доставки, «Змінити»
Прихована магазин не завершив налаштування оплати чи доставки, або на сторінці немає shop id нічого
Доступна Оформлена
Кнопка в стані «Доступна» Кнопка в стані «Оформлена»

Знижку задає магазин у Налаштуваннях → Підписки. Без знижки кнопка показує «Регулярна доставка з Neocarts» і ціну без закреслення.

Ціна зі знижкою на кнопці — попередній перегляд. Остаточні суми рахує сервер під час створення замовлення (Гроші та округлення).

Вікно вибору частоти доставки

  • Товар — зображення, назва, варіант, ціна зі знижкою.
  • Як часто доставляти — пресети магазину й «Інша частота…» (кожні N днів чи тижнів, у межах, дозволених магазином).
  • Ціна з підпискою — економія з кожного списання та дата наступного списання.
  • «Додати підписку» — зберігає вибір. У режимі редагування: «Зберегти зміни» і «Прибрати підписку».

Кількості у вікні немає: вона лишається у вашому кошику. Вартість доставки оплачується перевізнику окремо.

Після збереження покупець бачить підтвердження з кнопками «Продовжити покупки» і, якщо задано checkout-url, «Перейти до оформлення».

Підписку додано

Кнопка лише запамʼятовує частоту для product-id. Кошик лишається вашим, тому звʼяжіть їх у двох місцях.

Підписка на товар, якого немає в кошику. Покупець може оформити підписку з картки каталогу, не додаючи товар у кошик, і натиснути «Перейти до оформлення». Щоб кошик не був порожнім, додавайте товар, коли зʼявляється підписка:

NeocartsSubscription.subscribe((all) => {
for (const [id, s] of Object.entries(all)) {
if (s.mode === 'subscription' && !cart.has(id)) {
cart.add(id, 1); // ваш кошик
}
}
renderCart();
});

subscribe() викликає функцію з усіма виборами покупця при кожній зміні. Товар, який уже є в кошику, не чіпайте: його кількість лишається, а підпискою він стане в getOrderItems().

Видалення з кошика. Коли покупець прибирає товар із кошика, забудьте і його вибір, інакше товар повернеться як підписка, щойно його додадуть знову:

NeocartsSubscription.remove(id);

«Прибрати підписку» у вікні підписки забуває лише вибір: товар лишається у кошику і йде в замовлення як one_time. Якщо він має зникати разом із підпискою, прибирайте його з кошика у тому ж subscribe().

Вікно «Як працює підписка»

Section titled “Вікно «Як працює підписка»”

Пояснює покупцю, як працює підписка: частота, нагадування за 3 дні до списання, оплата карткою через платіжний сервіс магазину, керування підпискою. Відкривається посиланням «Як це працює» у вікні підписки або з вашої кнопки:

<button type="button" onclick="NeocartsSubscription.openHowItWorks()">Як працює підписка?</button>

Вікно «Як працює підписка»

  • Кнопка займає всю ширину батьківського блоку. Поставте її в ту саму колонку, що й кнопку «Купити».
  • У вузькому контейнері (до 256 px) кнопка складається у два рядки — для карток каталогу на телефоні.
  • Не задавайте контейнеру display: contents — кнопка завжди буде вузькою.
  • Кнопку можна вкладати в картку-посилання <a>: клік по кнопці не переходить за посиланням.

Кольори задає палітра магазину (Палітри та мови); стилі сторінки на кнопку не впливають.