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

Огляд

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

Кнопки підписки під кнопками «Додати в кошик» на картках товарів

  1. Сервер магазину створює замовлення з кошика через Shop API і отримує його id.
  2. Сторінка магазину відкриває віджет з цим id — покупець вводить контакти, доставку й оплачує.
  3. Після оплати Neocarts створює підписки й далі сам списує гроші за графіком.
  4. Про кожну подію (оплата, продовження, пауза, повернення) сервер магазину дізнається з вебхуків.
Хто Що Автентифікація
Сервер магазину → 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 — про зміни повідомляють вебхуки.

Поняття Що це
Замовлення Знімок кошика: рядки, ціни, знижка, контакт, доставка, підсумки. У статусі draft воно і є кошиком. Має містити хоча б один рядок mode: "subscription".
Підписка Створюється лише після успішної оплати. Зберігає ціну, кількість, знижку, інтервал і картку покупця.
Платіж Одна спроба оплати. Повторна спроба — новий платіж на тому самому замовленні.

Структура — у документі замовлення, переходи — у статусах.

  • Каталог не зберігає ціну. PUT /v1/shop/products/{external_id} передає назву, варіант, зображення й посилання. Переоцінити чинні підписки — окремий виклик PUT /v1/shop/products/{external_id}/price.
  • Гроші — цілі копійки, валюта UAH. 249000 = 2 490,00 ₴. Див. Гроші й округлення.
  • Дві мови: uk і en. Заголовок Accept-Language задає мову відповідей API; поле locale замовлення — мову листів і оформлення.