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

Статуси

Статус Значення
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.

Якщо оплата не вдалася, віджет показує покупцю один із цих текстів і пропонує спробувати ще раз. Сервер магазину нічого не робить: замовлення лишається 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. Сервер магазину створює нове замовлення.
Статус Значення
active Списання за графіком. Створюється лише після успішної першої оплати.
paused Списань немає. Пауза ставиться вручну з панелі (необовʼязково — з датою paused_until), самим покупцем (завжди з датою) або автоматично системою.
cancelled Підписку зупинено — з панелі з указаною причиною або самим покупцем (причина необовʼязкова). Активувати знову можна лише з панелі.

Дозволені переходи: active → paused, active → cancelled, paused → active, paused → cancelled, cancelled → active. Інші дають помилку Підписку не можна перевести зі стану «:from» у стан «:to». Скасованій підписці графік не змінюють — спершу активуйте її.

Значення Коли Текст у панелі (uk)
charge_failed Пʼята поспіль невдала спроба списання. Картку відхилено п’ять днів поспіль. Покупець може прив’язати іншу картку в кабінеті Neocarts і відновити підписку.
no_card Немає придатної картки: токен не збережено, належить іншому провайдеру або магазин не може приймати оплату. Немає збереженої картки для списання. Покупець може прив’язати картку в кабінеті Neocarts і відновити підписку.
довільний текст Пауза, поставлена вручну продавцем. Текст, який ввів продавець.
null Пауза, яку поставив сам покупець (reason_key: "customer" у вебхуку). —

Деталі повторних спроб — у Білінгу. Причини скасування — у Перелічуваних значеннях.

Статус Значення
pending Рахунок виставлено, результату ще немає.
failed Провайдер відхилив оплату.
expired Сторінка оплати прострочена (або списання за підпискою висіло понад добу й не підтвердилося).
success Оплату отримано.
refunded Кошти повернуто повністю; refunded_amount — джерело правди про суму.

Статус змінюється лише в один бік — «храповик»: pending < failed / expired < success < refunded. Пізнє підтвердження від провайдера може перевести expired у success, але success ніколи не стане failed. Одна спроба — один платіж; повторне оформлення створює новий запис.