Огляд
Neocarts додає до інтернет-магазину підписку на товари з регулярною доставкою. Каталог, кошик і ціни лишаються в магазині; кнопку підписки, оформлення, оплату, збережену картку та повторні списання бере на себе Neocarts.

Як працює
Section titled “Як працює”- Сервер магазину створює замовлення з кошика через Shop API і отримує його
id. - Сторінка магазину відкриває віджет з цим
id— покупець вводить контакти, доставку й оплачує. - Після оплати Neocarts створює підписки й далі сам списує гроші за графіком.
- Про кожну подію (оплата, продовження, пауза, повернення) сервер магазину дізнається з вебхуків.
Канали інтеграції
Section titled “Канали інтеграції”| Хто | Що | Автентифікація |
|---|---|---|
| Сервер магазину → Neocarts | Shop API https://core.neocarts.com/v1/shop/* |
Authorization: Bearer nc_live_… |
| Сторінка магазину | Віджет https://cdn.neocarts.com/bundle.js |
data-shop-id — UUID магазину, не секрет |
| Neocarts → сервер магазину | Вебхуки — POST на URL із вкладки «Інтеграція» |
X-Neocarts-Signature — HMAC-SHA256 секретом whsec_… |
Shop API — лише сервер-сервер: ключ ніколи не потрапляє в браузер. Магазин не опитує Neocarts — про зміни повідомляють вебхуки.
Основні поняття
Section titled “Основні поняття”| Поняття | Що це |
|---|---|
| Замовлення | Знімок кошика: рядки, ціни, знижка, контакт, доставка, підсумки. У статусі draft воно і є кошиком. Має містити хоча б один рядок mode: "subscription". |
| Підписка | Створюється лише після успішної оплати. Зберігає ціну, кількість, знижку, інтервал і картку покупця. |
| Платіж | Одна спроба оплати. Повторна спроба — новий платіж на тому самому замовленні. |
Структура — у документі замовлення, переходи — у статусах.
Правила
Section titled “Правила”- Каталог не зберігає ціну.
PUT /v1/shop/products/{external_id}передає назву, варіант, зображення й посилання. Переоцінити чинні підписки — окремий викликPUT /v1/shop/products/{external_id}/price. - Гроші — цілі копійки, валюта UAH.
249000= 2 490,00 ₴. Див. Гроші й округлення. - Дві мови:
ukіen. ЗаголовокAccept-Languageзадає мову відповідей API; полеlocaleзамовлення — мову листів і оформлення.
Куди далі
Section titled “Куди далі”Швидкий стартВід налаштованої панелі до першої оплаченої підписки.
Панель магазинуКлюч, оплата, доставка, знижка, вигляд віджета.
Shop APIАвтентифікація, товари, замовлення, помилки.
ВіджетиКнопки підписки й checkout на сторінці магазину.