Статус платежа и статус заказа связаны, но это разные записи
Шлюз сообщает о платеже, а ваше приложение решает судьбу заказа. Нельзя выполнять заказ по непроверенному вебхуку, откатывать состояние после нового события или автоматически признавать исключение по сумме полной оплатой без явной политики.
Никакие запросы, вебхуки, переводы, возвраты или изменения заказов в OxaPay не отправляются. Ввод остаётся в браузере; источником истины служит реальный ответ API.
Модель показывает возможные переходы и действия продавца. Она не создаёт платежи, не вызывает API, не проверяет реальные транзакции и не заменяет Payment Information.
Как пользоваться симулятором статусов платежей
Этот симулятор помогает продавцам и разработчикам оценивать влияние платёжного события на заказ. Выберите сценарий или задайте сумму, срок действия, подтверждения, тип платежа и поведение вебхука. Модель учебная: реальные переводы не проверяются и запросы в OxaPay не отправляются.
Статус платежа и статус заказа — разные записи
Шлюз сообщает состояние платежа, а магазин отдельно решает, оставить ли заказ в ожидании, выдать товар или начать проверку. Обнаружение перевода не означает принятие оплаты. Необратимая выдача допустима только после проверенного финального статуса. Дублирующие и непоследовательные вебхуки не должны вызывать повторное выполнение заказа.
Недоплата и сроки
Допустимая недоплата вычисляется из суммы заказа и заданного порога. Существенный недостаток средств, поздний перевод и нестандартный сценарий требуют явной политики продавца, а не автоматической выдачи. Депозиты на постоянный адрес нужно отдельно связывать с клиентом и транзакцией. Нулевые подтверждения не заменяют итоговый статус от шлюза.
Доставка вебхуков и восстановление
Примеры охватывают повторы, неверную HMAC-подпись, неправильный порядок, сбой первой попытки и исчерпание повторов. Обработчик должен проверять подпись исходного тела, сопоставлять заказ, делать обновления идемпотентными и сверять спорные записи через Payment Information или Payment History. Пример JSON не является ответом реального API.
Ограничения симулятора
Все заказы, хеши, даты и полезные нагрузки вымышлены. Статусы, пределы и повторы OxaPay могут меняться, поэтому перед запуском изучайте актуальную документацию. Инструмент не отправляет деньги, возвраты, вебхуки или секретные ключи.
Документированные статусы OxaPay
Допустимая недоплата вычисляется из суммы заказа и заданного порога. Существенный недостаток средств, поздний перевод и нестандартный сценарий требуют явной политики продавца, а не автоматической выдачи. Депозиты на постоянный адрес нужно отдельно связывать с клиентом и транзакцией. Нулевые подтверждения не заменяют итоговый статус от шлюза.
new- Счёт создан; валюта не выбрана.
waiting- Валюта выбрана; ожидание оплаты.
paying- Попытка платежа или транзакция обрабатывается.
paid- Счёт полностью оплачен.
manual_accept- Продавец вручную принял счёт.
underpaid- Частичный платёж не покрывает счёт.
refunding- Возврат инициирован.
refunded- Средства возвращены.
expired- Срок счёта истёк без принятой оплаты.
Актуальная документация OxaPay
Проверяйте таблицу статусов, параметры счёта, сведения о платеже и вебхуки.