Середовища
| Призначення | Адреса |
|---|---|
| Shop API | https://core.neocarts.com/v1/shop/* |
| Віджет (CDN) | https://cdn.neocarts.com/bundle.js |
| Сайт | https://neocarts.com |
| Підтримка | [email protected] |
Адресу панелі магазину й staging-адреси для тестування дає підтримка.
Ліміти запитів
Section titled “Ліміти запитів”Запити Shop API з чинним ключем не лімітуються. Обмежено лише невдалу автентифікацію: 60 спроб за хвилину з однієї IP-адреси, після чого до кінця хвилини кожен запит із цієї IP отримує 429 — навіть із правильним ключем.
CORS і CSP
Section titled “CORS і CSP”Shop API працює лише сервер-сервер: CORS вимкнено, виклик зі сторінки браузер заблокує.
Якщо на сайті діє Content Security Policy, дозвольте:
| Директива | Значення |
|---|---|
script-src |
https://cdn.neocarts.com |
connect-src |
https://core.neocarts.com |
style-src |
https://fonts.googleapis.com |
font-src |
https://fonts.gstatic.com |
frame-src |
домен платіжної системи магазину — сторінка оплати відкривається в iframe |
Версії
Section titled “Версії”Версія Shop API — у шляху: /v1/shop/…. v1 чинна з вересня 2026.
- Зміна, що ламає сумісність, виходить новою мажорною версією; попередня працює ще 6 місяців після оголошення.
- Нові необовʼязкові поля, значення переліків і ендпоїнти додаються в поточну версію. Ігноруйте невідомі поля в JSON.
- Віджет не версіонується: CDN завжди віддає поточну збірку.
Історія змін — Changelog.
Пісочниця для оплати
Section titled “Пісочниця для оплати”На staging замість платіжної системи магазину працює пісочниця ("payment": { "provider": "sandbox" }, у панелі — «Пісочниця»). Реальних грошей і номерів карток немає. Сторінка оплати показує номер замовлення, суму й чотири кнопки:
| Кнопка | Результат |
|---|---|
| Оплатити і зберегти картку | платіж успішний, поновлення проходитимуть |
| Оплатити карткою, яку відхилять при наступному списанні | перший платіж успішний, кожне поновлення — відмова (повторні спроби й пауза charge_failed) |
| Оплатити без збереження картки | платіж успішний, але гроші автоматично повертаються, card_not_saved |
| Відхилити оплату | payment_failed |
Перші дві кнопки зберігають картку 444444******1111 (visa). На production пісочниці поки немає.
Браузери
Section titled “Браузери”Сучасні браузери з автоматичним оновленням: Chrome, Edge, Firefox, Safari. Стилі сайту на кнопку підписки й вікна віджета не впливають.