Швидкий старт
Мінімальна інтеграція: кнопка підписки на сторінці товару, один ендпоїнт на вашому сервері, що створює замовлення, і виклик open().
-
Налаштуйте панель. У панелі магазину увімкніть оплату і хоча б один спосіб доставки. За бажанням задайте знижку на підписку.
-
Візьміть ключ і shop id. На вкладці Налаштування → Інтеграція натисніть «Згенерувати новий API-ключ» і збережіть його — він показується один раз. Там само скопіюйте «ID магазину».

-
Додайте скрипт і кнопку. Скрипт — один раз на сторінку; кнопку — під своєю кнопкою «Купити»:
<script src="https://cdn.neocarts.com/bundle.js" data-shop-id="SHOP_UUID" defer></script><neocarts-button product-id="SKU-1" amount="249000" title="Brit Care Adult Large Breed"variant="12 кг" image="https://shop.example.com/i/brit.jpg"></neocarts-button>product-id— вашexternal_idтовару;amount— ціна однієї одиниці в копійках (249000= 2 490,00 ₴). Покупець обирає частоту у вікні кнопки. Див. Кнопка підписки. -
Зберіть items на сторінці. На «Оформити» пропустіть рядки кошика через
getOrderItems()і надішліть на свій сервер:const nc = window.NeocartsSubscription;const items = nc.getOrderItems([{ external_id: 'SKU-1', title: 'Brit Care Adult Large Breed', variant: '12 кг',image_url: 'https://shop.example.com/i/brit.jpg', product_url: 'https://shop.example.com/p/brit',price: 249000, quantity: 1 },]);const { orderId } = await fetch('/api/neocarts/order', {method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ items }),}).then((r) => r.json()); -
Створіть замовлення на сервері. Ваш ендпоїнт викликає
POST /v1/shop/orders/createз ключем і повертаєorder.id:Terminal window curl -X POST https://core.neocarts.com/v1/shop/orders/create \-H "Authorization: Bearer nc_live_…" \-H "Accept-Language: uk" \-H "Content-Type: application/json" \-d '{"locale": "uk","redirect_url": "https://shop.example.com/cart?neocarts=checkout","items": [{"external_id": "SKU-1", "title": "Brit Care Adult Large Breed", "variant": "12 кг","image_url": "https://shop.example.com/i/brit.jpg", "product_url": "https://shop.example.com/p/brit","price": 249000, "quantity": 1,"mode": "subscription", "interval_value": 4, "interval_unit": "week"}]}'export async function createNeocartsOrder(items) {const res = await fetch('https://core.neocarts.com/v1/shop/orders/create', {method: 'POST',headers: {Authorization: `Bearer ${process.env.NEOCARTS_KEY}`,'Accept-Language': 'uk','Content-Type': 'application/json',},body: JSON.stringify({ locale: 'uk', redirect_url: 'https://shop.example.com/cart?neocarts=checkout', items }),});const order = await res.json();if (!res.ok) throw new Error(`${res.status} ${order.message}`);return { orderId: order.id };}Звірте ціни рядків зі своєю базою — не довіряйте тим, що прийшли з браузера. Поля й помилки — Замовлення.
-
Відкрийте checkout і слухайте події.
await nc.open({ orderId });nc.on(nc.events.Paid, ({ number }) => { /* очистіть кошик, покажіть номер */ });nc.on(nc.events.OrderMissing, () => { /* забудьте orderId, створіть нове замовлення */ }); -
Перевірте. Пройдіть оформлення як покупець. На staging оплата працює в пісочниці без реальних грошей (Середовища); на production оплатіть невелике замовлення і поверніть гроші з панелі. Після оплати замовлення стає
paid, зʼявляється підпискаactive, сторінка отримуєneocarts:paid.
Далі: потік інтеграції, вебхуки, усунення проблем.