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

Швидкий старт

Мінімальна інтеграція: кнопка підписки на сторінці товару, один ендпоїнт на вашому сервері, що створює замовлення, і виклик open().

  1. Налаштуйте панель. У панелі магазину увімкніть оплату і хоча б один спосіб доставки. За бажанням задайте знижку на підписку.

  2. Візьміть ключ і shop id. На вкладці Налаштування → Інтеграція натисніть «Згенерувати новий API-ключ» і збережіть його — він показується один раз. Там само скопіюйте «ID магазину».

    Вкладка «Інтеграція»: ID магазину, API-ключ і вебхуки

  3. Додайте скрипт і кнопку. Скрипт — один раз на сторінку; кнопку — під своєю кнопкою «Купити»:

    <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 ₴). Покупець обирає частоту у вікні кнопки. Див. Кнопка підписки.

  4. Зберіть 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());
  5. Створіть замовлення на сервері. Ваш ендпоїнт викликає 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"
    }]
    }'

    Звірте ціни рядків зі своєю базою — не довіряйте тим, що прийшли з браузера. Поля й помилки — Замовлення.

  6. Відкрийте checkout і слухайте події.

    await nc.open({ orderId });
    nc.on(nc.events.Paid, ({ number }) => { /* очистіть кошик, покажіть номер */ });
    nc.on(nc.events.OrderMissing, () => { /* забудьте orderId, створіть нове замовлення */ });

    Див. Checkout і Події.

  7. Перевірте. Пройдіть оформлення як покупець. На staging оплата працює в пісочниці без реальних грошей (Середовища); на production оплатіть невелике замовлення і поверніть гроші з панелі. Після оплати замовлення стає paid, зʼявляється підписка active, сторінка отримує neocarts:paid.

Далі: потік інтеграції, вебхуки, усунення проблем.