Потік інтеграції
Шлях від порожньої панелі до підписки, що поновлюється сама. Код магазину потрібен лише на кроках 3–8.
-
Панель. Увімкніть оплату і хоча б один спосіб доставки; за бажанням — знижку і палітру. Без оплати й доставки магазин «не готовий»: кнопка підписки не показується,
open()відхиляється. -
Ключ і shop id. На вкладці Інтеграція згенеруйте API-ключ
nc_live_…(показується один раз) і скопіюйте ID магазину. Ключ — лише на сервері; ID — в атрибутdata-shop-id. -
Товари (необовʼязково).
PUT /v1/shop/products/{external_id}при збереженні товару — назва, варіант, зображення, посилання. Можна пропустити: замовлення й так додає товари в каталог. -
Кнопка підписки. Підключіть скрипт і поставте
<neocarts-button>під кнопкою «Купити». Покупець обирає частоту у вікні кнопки — вибір зберігається у віджеті. -
Кошик → items. Перед оформленням пропустіть рядки кошика через
getOrderItems(lines)— отримаєтеitemsзmode,interval_value,interval_unit. -
Замовлення. Ваш сервер викликає
POST /v1/shop/orders/createзitems,localeі необовʼязковимredirect_url. Відповідь201— документ замовлення у статусіdraft; поверніть сторінціorder.id. Кошик змінився до оплати —PUT /v1/shop/orders/{order}/items; на409створіть нове замовлення. -
Checkout. Сторінка викликає
NeocartsSubscription.open({ orderId }). Покупець проходить контакти → доставку → огляд → оплату в діалозі Neocarts. -
Результат. На сторінці — подія
neocarts:paid{ number }: очистіть кошик.neocarts:order-missing— забудьте збережений id і створіть нове замовлення. Сервер отримує вебхукorder.paid. -
Поновлення. Neocarts сам надсилає нагадування за 3 дні, списує гроші зі збереженої картки, створює замовлення на кожен період і шле листи. При невдачі — до 5 спроб, потім пауза з причиною
charge_failed. Кожна зміна приходить вебхуком. Див. Регулярні списання.
Що реалізує магазин
Section titled “Що реалізує магазин”| Де | Що |
|---|---|
| Шаблон сайту | скрипт і <neocarts-button> під кнопкою «Купити» |
| Кошик (браузер) | getOrderItems() → запит на свій сервер → open({ orderId }); обробники neocarts:paid і neocarts:order-missing |
| Сервер | POST /v1/shop/orders/create з API-ключем |
| Сервер | обробник вебхуків — для виконання замовлень і обліку підписок |