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

Потік інтеграції

Шлях від порожньої панелі до підписки, що поновлюється сама. Код магазину потрібен лише на кроках 3–8.

  1. Панель. Увімкніть оплату і хоча б один спосіб доставки; за бажанням — знижку і палітру. Без оплати й доставки магазин «не готовий»: кнопка підписки не показується, open() відхиляється.

  2. Ключ і shop id. На вкладці Інтеграція згенеруйте API-ключ nc_live_… (показується один раз) і скопіюйте ID магазину. Ключ — лише на сервері; ID — в атрибут data-shop-id.

  3. Товари (необовʼязково). PUT /v1/shop/products/{external_id} при збереженні товару — назва, варіант, зображення, посилання. Можна пропустити: замовлення й так додає товари в каталог.

  4. Кнопка підписки. Підключіть скрипт і поставте <neocarts-button> під кнопкою «Купити». Покупець обирає частоту у вікні кнопки — вибір зберігається у віджеті.

  5. Кошик → items. Перед оформленням пропустіть рядки кошика через getOrderItems(lines) — отримаєте items з mode, interval_value, interval_unit.

  6. Замовлення. Ваш сервер викликає POST /v1/shop/orders/create з items, locale і необовʼязковим redirect_url. Відповідь 201 — документ замовлення у статусі draft; поверніть сторінці order.id. Кошик змінився до оплати — PUT /v1/shop/orders/{order}/items; на 409 створіть нове замовлення.

  7. Checkout. Сторінка викликає NeocartsSubscription.open({ orderId }). Покупець проходить контакти → доставку → огляд → оплату в діалозі Neocarts.

  8. Результат. На сторінці — подія neocarts:paid { number }: очистіть кошик. neocarts:order-missing — забудьте збережений id і створіть нове замовлення. Сервер отримує вебхук order.paid.

  9. Поновлення. Neocarts сам надсилає нагадування за 3 дні, списує гроші зі збереженої картки, створює замовлення на кожен період і шле листи. При невдачі — до 5 спроб, потім пауза з причиною charge_failed. Кожна зміна приходить вебхуком. Див. Регулярні списання.

Де Що
Шаблон сайту скрипт і <neocarts-button> під кнопкою «Купити»
Кошик (браузер) getOrderItems() → запит на свій сервер → open({ orderId }); обробники neocarts:paid і neocarts:order-missing
Сервер POST /v1/shop/orders/create з API-ключем
Сервер обробник вебхуків — для виконання замовлень і обліку підписок