Статуси
Статуси замовлення
Section titled “Статуси замовлення”| Статус | Значення |
|---|---|
draft |
Кошик. Сервер магазину ще може замінити позиції; віджет збирає контакти й доставку. |
pending_payment |
Покупець натиснув «Перейти до оплати»: створено платіж, позиції заморожено. Повторне оформлення створює нову спробу оплати, статус не змінюється. |
paid |
Оплата успішна. Підписки створено, листи надіслано. Далі не змінюється. |
cancelled |
Скасовано з панелі (з draft або pending_payment). Остаточний. |
Переходи: draft → pending_payment → paid; cancelled можливий із draft і pending_payment. Назад шляху немає: з pending_payment у draft замовлення не повертається, навіть якщо оплата не пройшла.
Що можна зробити в якому статусі
Section titled “Що можна зробити в якому статусі”| Дія | draft |
pending_payment |
paid |
cancelled |
|---|---|---|---|---|
Сервер магазину замінює склад (PUT /v1/shop/orders/{order}/items) |
200 | 409 | 409 | 409 |
| Покупець змінює контакти й доставку у віджеті | так | так | ні | ні |
| Покупець починає оплату у віджеті | так | так (нова спроба) | ні — показується екран успіху | ні — «Оформлення недоступне» |
Невідоме або чуже замовлення — завжди 404. Незавершене замовлення («Чернетка», «Очікує оплати») віджет відкриває завжди. Оплачене чи скасоване — лише протягом 24 годин після останньої зміни; старіше він вважає зниклим (neocarts:order-missing). На Shop API це обмеження не діє.
Тексти помилок 409/422 (message)
Section titled “Тексти помилок 409/422 (message)”Мова береться з Accept-Language. Логіку будуйте на коді статусу, а не на тексті.
| Ключ | uk | en |
|---|---|---|
already_paid |
Це замовлення вже оплачене. | This order has already been paid. |
cancelled |
Це замовлення скасовано. | This order has been cancelled. |
not_editable |
Оплачене замовлення змінити не можна. | A paid order can no longer be changed. |
items_frozen |
Товари замовлення, яке вже в оформленні, змінити не можна. | The items of an order in checkout can no longer be changed. |
checkout_incomplete (422) |
Перед оформленням треба зберегти контакти та доставку. | The contact and delivery steps have to be saved before checkout. |
payments_unavailable (422) |
Цей магазин не може приймати оплату. | This shop cannot take payments. |
| валідація позицій (422) | У замовленні має бути щонайменше один товар за підпискою. | An order has to hold at least one subscription item. |
Чому оплата не пройшла
Section titled “Чому оплата не пройшла”Якщо оплата не вдалася, віджет показує покупцю один із цих текстів і пропонує спробувати ще раз. Сервер магазину нічого не робить: замовлення лишається pending_payment, доки покупець не оплатить.
| Причина | uk | en | Що далі |
|---|---|---|---|
payment_failed |
Оплату відхилено. Спробуйте ще раз, за потреби іншою карткою. | The payment was declined. Try again, with another card if needed. | Покупець повторює оплату. |
payment_expired |
Термін дії сторінки оплати минув. Розпочніть оплату знову. | The payment page has expired. Start the payment again. | Покупець повторює оплату. |
card_not_saved |
Оплата пройшла, але картку не вдалося зберегти для підписки, тому кошти повернуто. Будь ласка, оплатіть ще раз іншою карткою. | The payment went through but the card could not be saved for the subscription, so the money has been sent back. Please pay again with another card. | Кошти вже повернуто автоматично; покупець платить іншою карткою. |
cancelled |
Це замовлення скасовано. | This order has been cancelled. | Сервер магазину створює нове замовлення. |
Статуси підписки
Section titled “Статуси підписки”| Статус | Значення |
|---|---|
active |
Списання за графіком. Створюється лише після успішної першої оплати. |
paused |
Списань немає. Пауза ставиться вручну з панелі (необовʼязково — з датою paused_until), самим покупцем (завжди з датою) або автоматично системою. |
cancelled |
Підписку зупинено — з панелі з указаною причиною або самим покупцем (причина необовʼязкова). Активувати знову можна лише з панелі. |
Дозволені переходи: active → paused, active → cancelled, paused → active, paused → cancelled, cancelled → active. Інші дають помилку Підписку не можна перевести зі стану «:from» у стан «:to». Скасованій підписці графік не змінюють — спершу активуйте її.
Причини паузи (status_reason)
Section titled “Причини паузи (status_reason)”| Значення | Коли | Текст у панелі (uk) |
|---|---|---|
charge_failed |
Пʼята поспіль невдала спроба списання. | Картку відхилено п’ять днів поспіль. Покупець може прив’язати іншу картку в кабінеті Neocarts і відновити підписку. |
no_card |
Немає придатної картки: токен не збережено, належить іншому провайдеру або магазин не може приймати оплату. | Немає збереженої картки для списання. Покупець може прив’язати картку в кабінеті Neocarts і відновити підписку. |
| довільний текст | Пауза, поставлена вручну продавцем. | Текст, який ввів продавець. |
null |
Пауза, яку поставив сам покупець (reason_key: "customer" у вебхуку). |
— |
Деталі повторних спроб — у Білінгу. Причини скасування — у Перелічуваних значеннях.
Статуси платежу
Section titled “Статуси платежу”| Статус | Значення |
|---|---|
pending |
Рахунок виставлено, результату ще немає. |
failed |
Провайдер відхилив оплату. |
expired |
Сторінка оплати прострочена (або списання за підпискою висіло понад добу й не підтвердилося). |
success |
Оплату отримано. |
refunded |
Кошти повернуто повністю; refunded_amount — джерело правди про суму. |
Статус змінюється лише в один бік — «храповик»: pending < failed / expired < success < refunded. Пізнє підтвердження від провайдера може перевести expired у success, але success ніколи не стане failed. Одна спроба — один платіж; повторне оформлення створює новий запис.