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

Інтеграція та API-ключ

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

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

Поле Що це Секрет?
«ID магазину» UUID магазину. Потрібен віджету (data-shop-id) і приходить у кожному вебхуку як shop_id ні — можна вставляти в HTML
«API-ключ» nc_live_…, яким ваш сервер викликає Shop API. Один на магазин так — показується лише раз
«URL для вебхуків» Адреса на вашому сервері, куди Neocarts надсилає POST про події ні
«Секрет підпису» whsec_…, яким перевіряється підпис вебхука так — але показується щоразу
  1. Натисніть «Згенерувати API-ключ» і підтвердьте.

  2. Скопіюйте ключ, що зʼявився, і передайте розробнику захищеним каналом.

  3. Після перезавантаження сторінки замість ключа видно лише «Згенеровано дд.мм.рррр гг:хх».

Заміна. Коли ключ уже є, кнопка називається «Згенерувати новий API-ключ». Старий ключ перестає працювати одразу після підтвердження, перехідного періоду немає — плануйте заміну разом із розробником: згенерували → внесли на сервер → перевірили. Замінюйте ключ, якщо його втрачено або він міг потрапити до сторонніх.

Згенерувати ключ може будь-який користувач панелі (ролей немає), тож давайте доступ лише тим, кому довіряєте ключ. Ключ також може видати адміністратор Neocarts на ваше прохання.

  • «URL для вебхуків» — порожнє поле вимикає вебхуки; у продакшені приймається лише https://. Зберігається кнопкою «Зберегти».
  • «Секрет підпису» — кнопка «Згенерувати секрет». Без секрету вебхуки не підписуються. Секрет можна скопіювати й пізніше.
  • «Згенерувати новий секрет» — поточний секрет перестає працювати одразу, тому внесіть новий на сервер без затримки. Доставки, що тим часом не пройшли перевірку, Neocarts повторює, а невдалі можна надіслати повторно з журналу «Магазин» → «Вебхуки».

Чеклист перед запуском

Section titled “Чеклист перед запуском”
  • API-ключ згенеровано й передано розробнику; ID магазину скопійовано.
  • За потреби — задано «URL для вебхуків» і згенеровано «Секрет підпису».
  • Обрано платіжну систему та введено ключі — Оплата.
  • Увімкнено хоча б один спосіб доставки — Доставка.
  • Задано знижку або свідомо залишено порожньою — Підписки.
  • Обрано палітру — Зовнішній вигляд.

Без оплати й хоча б одного способу доставки магазин не готовий: віджет на сайті не показується і замовлення не відкриваються.