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

Оформлення замовлення

Checkout — вікно оформлення поверх сторінки магазину. Покупець вводить контакти й доставку, перевіряє замовлення та оплачує його карткою; картка зберігається для наступних списань за підпискою.

  1. Покупець натискає «Оформити» у вашому кошику.
  2. Ваш сервер створює замовлення через POST /v1/shop/orders/create з рядками з getOrderItems() і повертає сторінці order.id.
  3. Сторінка викликає NeocartsSubscription.open({ orderId }).
  4. Покупець проходить кроки: контакти → доставка → огляд → оплата.
  5. Після оплати сторінка отримує neocarts:paid, сервер — вебхук order.paid.
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() закриває вікно.

Імʼя та прізвище, телефон (+380…), email.

Крок «Контактні дані»

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

Крок «Доставка»

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

Крок «Огляд»

Сторінка платіжної системи магазину відкривається всередині checkout. Після оплати покупець автоматично повертається до результату.

Екран Коли Що бачить покупець
Успіх оплату підтверджено номер замовлення, сплачена сума, доставка, підписки з датами наступних списань, «Повернутися до магазину»
Помилка банк відхилив платіж, час на оплату вичерпано, картку не збережено причина й кнопка повторної оплати
Недоступно замовлення скасоване або не знайдене «Оформлення недоступне», «Повернутися до магазину»
Успіх Помилка
Екран успіху Екран помилки оплати

Тексти причин — у Статусах.

На телефоні checkout займає весь екран:

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.

Куди веде екран успіху: кнопка «Повернутися до магазину», а також закриття checkout кнопкою в шапці чи Esc. Платіжній системі не передається. Без неї усе це просто закриває вікно.