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

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

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

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

• подписаться на изменение статуса заказа (рекомендуется);
• запрашивать статус заказа.

Подписка на изменение статуса заказа

С помощью метода библиотеки Store

Чтобы подписаться на изменения статуса заказа, используйте метод SDK getOrderStatus из библиотеки Store. Передайте в метод следующие параметры:

• listener — объект слушателя типа OrderStatusListener;
• orderId — ID заказа, полученный в результате покупки через корзину, покупки в один клик или покупки за виртуальную валюту.

Справочная документация SDK

Узнайте больше о методах SDK и их параметрах.

Пример вызова метода XStore.getOrderStatus:

XStore.getOrderStatus(object : OrderStatusListener() {

               override fun  onStatusUpdate(status: OrderResponse.Status) {

                   if(status == OrderResponse.Status.DONE) {

                       Log.d("MainActivity", "Success")

                   }

               }

               override fun  onFailure() {

                   Log.d("MainActivity", "Failure")

               }

           }, orderId)

Мы рекомендуем вызывать метод XStore.getOrderStatus вместе с открытием платежного интерфейса.

Этот метод инкапсулирует в себя несколько методов отслеживания статуса заказа. Отслеживание выполняется по следующему алгоритму:

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

С помощью метода библиотеки Payments

1. При создании объекта XPayments.IntentBuilderпередайте обработчик StatusReceivedCallback с помощью метода setStatusReceivedCallback.
2. В обработчике onSuccess реализуйте метод StatusReceivedCallback, который вызывается при каждом уникальном изменении статуса.

Пример:

val intent = XPayments.createIntentBuilder(this)
               .accessToken(<accessToken>)
               .isSandbox(<isSandbox>)
           	.setStatusReceivedCallback(object : StatusReceivedCallback {
               	override fun onSuccess(data: InvoicesDataResponse) {
                   		Log.d(TAG, "StatusReceivedCallback is fired. Result data = $data")
               	}
           	})
           	.build()

Запрос статуса заказа

Для запроса текущего статуса платежной транзакции вызовите метод getOrder из библиотеки Payments, передав в него следующие параметры:

• orderId — ID заказа, который был получен в результате покупки через корзину, покупки в один клик или покупки за виртуальную валюту.
• callback — обработчик, вызываемый после успешного получения информации о заказе. При создании обработчика используйте интерфейс GetStatusCallback и реализуйте методы onSuccess и onError.

Пример:

XPayments.getStatus(<token>, <isSandbox>, object : GetStatusCallback {
            override fun onSuccess(data: InvoicesDataResponse?) {
                Log.d(TAG, "onSuccess is fired. Result data = $data")
            }

           override fun onError(throwable: Throwable?, errorMessage: String?) {
                Log.d(TAG, "onError is fired. ErrorMessage = $errorMessage")
            }

})

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