Оформлення замовлення
Checkout — вікно оформлення поверх сторінки магазину. Покупець вводить контакти й доставку, перевіряє замовлення та оплачує його карткою; картка зберігається для наступних списань за підпискою.
Як працює
Section titled “Як працює”- Покупець натискає «Оформити» у вашому кошику.
- Ваш сервер створює замовлення через
POST /v1/shop/orders/createз рядками зgetOrderItems()і повертає сторінціorder.id. - Сторінка викликає
NeocartsSubscription.open({ orderId }). - Покупець проходить кроки: контакти → доставка → огляд → оплата.
- Після оплати сторінка отримує
neocarts:paid, сервер — вебхукorder.paid.
Відкриття
Section titled “Відкриття”try { await NeocartsSubscription.open({ orderId: order.id });} catch (e) { // 'Shop is not ready' — магазин не завершив налаштування // e.status === 404 — замовлення не знайдено}| Параметр | Тип | Обовʼязковий | Опис |
|---|---|---|---|
orderId |
рядок | так | id замовлення з відповіді Shop API |
locale |
рядок | ні | uk або en; діє, лише якщо в замовленні немає locale |
Повторний open() з тим самим orderId нічого не робить; з іншим — відкриває нове замовлення, а введені контакти й доставка зберігаються. close() закриває вікно.
Кроки покупця
Section titled “Кроки покупця”1. Контакти
Section titled “1. Контакти”Імʼя та прізвище, телефон (+380…), email.

2. Доставка
Section titled “2. Доставка”Лише способи, увімкнені в Налаштуваннях → Доставка: Нова Пошта — відділення, поштомат або адреса, з пошуком міста й відділення. Отримувач за замовчуванням — з контактів.

3. Огляд
Section titled “3. Огляд”Товари й суми із замовлення, контакти, доставка і згода на регулярні списання (якщо в замовленні є підписки). Кнопка «Перейти до оплати» фіксує склад замовлення — після неї змінити рядки вже не можна.

4. Оплата
Section titled “4. Оплата”Сторінка платіжної системи магазину відкривається всередині checkout. Після оплати покупець автоматично повертається до результату.
5. Результат
Section titled “5. Результат”| Екран | Коли | Що бачить покупець |
|---|---|---|
| Успіх | оплату підтверджено | номер замовлення, сплачена сума, доставка, підписки з датами наступних списань, «Повернутися до магазину» |
| Помилка | банк відхилив платіж, час на оплату вичерпано, картку не збережено | причина й кнопка повторної оплати |
| Недоступно | замовлення скасоване або не знайдене | «Оформлення недоступне», «Повернутися до магазину» |
| Успіх | Помилка |
|---|---|
![]() |
![]() |
Тексти причин — у Статусах.
На телефоні checkout займає весь екран:

Що робить сторінка магазину
Section titled “Що робить сторінка магазину”| Момент | Дія |
|---|---|
| покупець натиснув «Оформити» | створити замовлення на сервері, зберегти order.id, викликати open({ orderId }) |
open() відхилено з Shop is not ready |
показати, що підписки тимчасово недоступні; завершити налаштування оплати й доставки в панелі |
| покупець змінив кошик до оплати | оновити рядки через PUT /v1/shop/orders/{order}/items; на 409 — створити нове замовлення |
neocarts:paid |
спорожнити кошик, забути order.id, показати номер замовлення |
neocarts:order-missing |
забути order.id; наступне «Оформити» створює нове замовлення |
| покупець закрив вікно без оплати | нічого; кнопка «Продовжити оформлення» викликає open() з тим самим order.id |
Повернення до оформлення
Section titled “Повернення до оформлення”Віджет памʼятає незавершене оформлення в браузері покупця, тож після перезавантаження сторінки нічого вводити заново не треба. Щоб продовжити, викличте open() з тим самим order.id або відкрийте сторінку з маркером ?neocarts=checkout. Якщо замовлення вже оплачене — покупець побачить екран успіху, а сторінка отримає neocarts:paid.
redirect_url
Section titled “redirect_url”Куди веде екран успіху: кнопка «Повернутися до магазину», а також закриття checkout кнопкою в шапці чи Esc. Платіжній системі не передається. Без неї усе це просто закриває вікно.

