Skip to main content
Активно запросите последний статус соответствующего способа оплаты заказа и синхронизируйте его с платформой. Этот запрос может обращаться к платёжному сервису и изменять статус заказа, используйте его только при задержке обратного вызова или когда требуется немедленное подтверждение.

​
Подготовка

​
Обзор интерфейса

При успехе возвращается полный обновлённый объект Order. Используйте state для определения результата и finished_at в качестве времени завершения; в текущей модели отсутствует поле paid_at. Значения статуса включают Pending, Paid, Finished, Expired, Failed, Refunded. Срок оплаты изменяет на Expired только заказы, всё ещё находящиеся в состоянии Pending. Уже возвращённые заказы Refunded остаются в возвращённом состоянии при обновлении или после получения отложенного обратного вызова оплаты.

​
Рекомендации по повторным попыткам

  • При обычной оплате в первую очередь полагайтесь на обратный вызов платформы; активно выполняйте refresh только если статус долго не обновляется.
  • Не выполняйте фиксированный высокочастотный опрос. Рекомендуется экспоненциальная задержка и остановка после достижения явного конечного состояния.
  • 401 означает недействительный токен; 403 означает, что вы не являетесь владельцем заказа; 404 означает, что заказ не существует.
  • При ошибке запроса к платёжному сервису сохраните ID заказа и trace ID, повторите попытку позже; не создавайте дублирующие заказы вместо подтверждения статуса.

​
Связанные интерфейсы