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, повторіть спробу пізніше; не створюйте дублікати замовлень замість підтвердження статусу.

​
Пов’язані інтерфейси