Hacer un seguimiento del estado del pedido

Después de que un usuario haga una compra, su aplicación puede realizar las siguientes acciones:

• mostrar el estado del pedido en la interfaz de usuario de la aplicación
• abonar el importe en el saldo de un usuario tras un pago aceptado
• conceder los artículos comprados tras un pago aceptado

Cuando utilice el SDK para implementar la lógica de estas acciones, puede hacer un seguimiento del estado del pedido de las siguientes maneras:

• suscribirse a los cambios de estado del pedido (recomendado)
• solicitar el estado del pedido

Suscribirse a los cambios de estado de los pedidos

Utilice el método de la biblioteca de Store

Para suscribirse a los cambios de estado del pedido, use el método del SDK getOrderStatus de la biblioteca de Store y transmita los siguientes parámetros al método:

• listener - objeto de agente de escucha del tipo OrderStatusListener.
• orderId - ID del pedido recibido de la compra mediante la cesta de la compra, compra con un solo clic o compra a cambio de moneda virtual como el parámetro.

Documentación de referencia del SDK

Obtenga más información sobre los métodos del SDK y sus parámetros.

Ejemplo de llamada al método 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)

Recomendamos invocar el método XStore.getOrderStatus al abrir la interfaz de pago.

Estos métodos de compra encapsulan varios métodos de seguimiento del estado del pedido. El seguimiento se realiza conforme al siguiente algoritmo:

1. Hay establecida una conexión de socket web.
2. Si la conexión de socket web está establecida correctamente y el estado del pedido cambia a done o cancel, se detiene el seguimiento. Si la conexión de socket web falla o la respuesta contiene datos incorrectos, el seguimiento del estado del pedido se realiza mediante sondeo corto.
3. El seguimiento del estado del pedido prosigue con sondeo corto. Una simple solicitud HTTP de estado del pedido se envía una vez cada 3 segundos. El seguimiento se detiene si el estado del pedido cambia a done o cancel.

Utilice el método de la biblioteca de Payments

1. Al crear el objeto XPayments.IntentBuilder, transmita la devolución de llamada StatusReceivedCallback utilizando el método setStatusReceivedCallback.
2. Implemente el método onSuccess en la devolución de llamada StatusReceivedCallback, que se llama con cada cambio de estado único.

Ejemplo

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()

Solicitar el estado del pedido

Para solicitar el estado actual del pago, llame al método getOrder de la biblioteca de Store, transmitiendo los siguientes parámetros:

• orderId — el ID del pedido, que se recibió al realizar la compra a través de la cesta de la compra, compra con un solo clic o compra por moneda virtual.
• callback — la devolución de llamada para recuperar la información del pedido correctamente. Cuando implemente una devolución de llamada, utilice la interfaz GetStatusCallback e implemente los métodos onSuccess y onError.

Ejemplo

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")
            }

})

Enlaces útiles