Отслеживание статуса заказа

После совершения покупки в вашем приложении могут выполняться следующие действия:

• отображение статуса заказа в интерфейсе приложения;
• пополнение баланса виртуальной валюты пользователя в результате успешной оплаты;
• начисление купленных предметов пользователю в результате успешной оплаты.

Чтобы реализовать логику этих действий, отслеживайте статус заказа с помощью метода SDK OrderTracking.Instance.AddOrderForTracking. Передайте в метод следующие параметры:

• projectId — ID проекта из Личного кабинета;
• orderId — ID заказа, полученный в результате покупки через корзину, покупки в один клик или покупки за виртуальную валюту;
• onSuccess — функция, которая вызывается в случае перехода заказа в статус done;
• onError — функция, которая вызывается в случае, если сервер Иксоллы возвращает ошибку.

Этот метод инкапсулирует в себя несколько методов отслеживания статуса заказа. Механизм отличается в зависимости от платформы, для которой собирается приложение:

• Для WebGL-сборок отслеживание осуществляется на основе postMessage событий виджета платежного интерфейса. Если от виджета платежного интерфейса приходит сообщение об изменении статуса заказа изменен на done или cancel, отслеживание прекращается.

• Для сборок для других платформ отслеживание осуществляется с помощью простых HTTP-запросов (short-polling) и запросов по протоколу WebSocket. Отслеживание выполняется по следующему алгоритму:

1. 1. Устанавливается веб-сокет-соединение.
   2. Если в течение 5 минут статус заказа не сменился на done или cancel, веб-сокет-соединение закрывается. Если статус заказа изменен на done или cancel, отслеживание прекращается.
   3. Отслеживание статуса заказа продолжается с помощью short-polling. Раз в 3 секунды отправляется простой HTTP-запрос статуса заказа. Отслеживание прекращается если:
      • статус заказа изменился на done или cancel;
      • в течение 10 минут статус заказа не сменился на done или cancel.

Дополнительно вы можете реализовать:

• запрос статуса и содержимого заказа с помощью метода SDK CheckOrderStatus;
• обработку вебхуков на сервере вашего приложения для событий, которые происходят с транзакцией на стороне на стороне Иксоллы.

Полезные ссылки