Інтеграція та API-ключ
Вкладка «Налаштування» → «Інтеграція» видає все, що потрібно розробнику: ідентифікатор магазину, API-ключ для Shop API і налаштування вебхуків.

| Поле | Що це | Секрет? |
|---|---|---|
| «ID магазину» | UUID магазину. Потрібен віджету (data-shop-id) і приходить у кожному вебхуку як shop_id |
ні — можна вставляти в HTML |
| «API-ключ» | nc_live_…, яким ваш сервер викликає Shop API. Один на магазин |
так — показується лише раз |
| «URL для вебхуків» | Адреса на вашому сервері, куди Neocarts надсилає POST про події |
ні |
| «Секрет підпису» | whsec_…, яким перевіряється підпис вебхука |
так — але показується щоразу |
API-ключ
Section titled “API-ключ”-
Натисніть «Згенерувати API-ключ» і підтвердьте.
-
Скопіюйте ключ, що зʼявився, і передайте розробнику захищеним каналом.
-
Після перезавантаження сторінки замість ключа видно лише «Згенеровано дд.мм.рррр гг:хх».
Заміна. Коли ключ уже є, кнопка називається «Згенерувати новий API-ключ». Старий ключ перестає працювати одразу після підтвердження, перехідного періоду немає — плануйте заміну разом із розробником: згенерували → внесли на сервер → перевірили. Замінюйте ключ, якщо його втрачено або він міг потрапити до сторонніх.
Згенерувати ключ може будь-який користувач панелі (ролей немає), тож давайте доступ лише тим, кому довіряєте ключ. Ключ також може видати адміністратор Neocarts на ваше прохання.
Вебхуки
Section titled “Вебхуки”- «URL для вебхуків» — порожнє поле вимикає вебхуки; у продакшені приймається лише
https://. Зберігається кнопкою «Зберегти». - «Секрет підпису» — кнопка «Згенерувати секрет». Без секрету вебхуки не підписуються. Секрет можна скопіювати й пізніше.
- «Згенерувати новий секрет» — поточний секрет перестає працювати одразу, тому внесіть новий на сервер без затримки. Доставки, що тим часом не пройшли перевірку, Neocarts повторює, а невдалі можна надіслати повторно з журналу «Магазин» → «Вебхуки».
Чеклист перед запуском
Section titled “Чеклист перед запуском”- API-ключ згенеровано й передано розробнику; ID магазину скопійовано.
- За потреби — задано «URL для вебхуків» і згенеровано «Секрет підпису».
- Обрано платіжну систему та введено ключі — Оплата.
- Увімкнено хоча б один спосіб доставки — Доставка.
- Задано знижку або свідомо залишено порожньою — Підписки.
- Обрано палітру — Зовнішній вигляд.
Без оплати й хоча б одного способу доставки магазин не готовий: віджет на сайті не показується і замовлення не відкриваються.