Si no dispone de servidor o implementa la lógica para el procesamiento de compras en el lado del cliente, puede utilizar los siguientes métodos:

1. WebSocket API.
2. Short-polling (Sondeo corto).

Obtener el estado de un pedido en el lado del cliente usando la API de WebSocket

La solución usa websockets para obtener los estados del pedido sin recuperar información detallada sobre este. Este método es preferente: solo se crea una conexión entre el cliente (por ejemplo, su sitio web o aplicación móvil) y el servidor de Xsolla, por lo que no hay carga adicional ni en el cliente ni en el servidor.

Dé los siguientes pasos:

1. Para permitir que el servidor de Websocket de Xsolla y su cliente identifiquen los mensajes de estado del pedido, cree una conexión:

const client = new Centrifuge(
connectionURL,
{
data: {
  user_external_id: user_external_id,
  auth: auth,
  project_id: project_id
}
}
)
connectionURL - wss://ws-store.xsolla.com/connection/websocket
auth - user JWT token

2. Para recibir nuevos mensajes sobre el estado del pedido, suscríbase a los eventos mediante la función client.on:

client.on('publication', (ctx) => {
   //handle the status
});

3. Desencadenar el establecimiento de una conexión real:

client.connect()

4. Para recibir el historial de cambios en los estados del pedido, conecte el método del historial de la API.

client.on('subscribed', function (ctx) {
   client.history(ctx.channel, { limit: -1, since: { offset: 0 }, reverse: false }).then(function (resp) {
resp.publications.forEach((ctx) => {
   /handle the status
});

   }, function (err) {
       //handle the status
   });
});

Ejemplo de cuerpo de mensaje:

{
order_id: 59614241,
status: 'new'
}

Están disponibles los siguientes estados de pedido:

• New — pedido creado pero no pagado
• Paid — pedido pagado
• Done — pedido entregado (todos los recibos enviados, entregas realizadas por parte de Xsolla, plataformas externas, etc.)
• Canceled — pedido cancelado y pago reembolsado a un usuario

Recomendaciones de uso de Websocket:

• El tiempo de espera máximo de una respuesta mediante websocket es de 5 minutos.
• La conexión debería establecerse al abrir la interfaz de pago.
• La conexión debería interrumpirse cuando se reciba el estado final del pedido, ya sea Canceled o Done.
• Si se agota la vida útil del websocket o si hay cualquier problema con la conexión, recurra al sondeo corto.

  Sondeo corto

  Para obtener información detallada sobre los artículos del pedido después de cambiar el estado, llame a la API Obtener pedido.

  Nota

  Se utiliza un sondeo periódico del estado del pedido: una simple solicitud HTTP que recibe el estado del pedido e información sobre el mismo. El retardo recomendado entre solicitudes es de 3 segundos.

El método XsollaCatalog.Purchase encapsula varios métodos de seguimiento del estado del pedido. El mecanismo de seguimiento se explica en la documentación de SDK de nivel empresarial para Unity.

Además, puede implementar el procesamiento del estado y del contenido de un pedido, que se transmiten a la función de devolución de llamada onSuccess del método de compra.

Cuando utilice el SDK, puede hacer un seguimiento del estado del pedido de las siguientes maneras:

• suscribirse a los cambios de estado del pedido
• solicitar el estado del pedido

Suscribirse a los cambios de estado de los pedidos

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.

Solicitar el estado del pedido

Para solicitar el estado actual de la transacción de pago, invoque el método getOrder de la biblioteca de Store, transmitiéndole los siguientes parámetros:

• orderId — el ID del pedido, que se recibió al adquirir el artículo.

• 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.

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

})

Puede hacer el seguimiento del estado del pedido usando el método AuthViaSocialNetwork del SDK. Transmita los siguientes parámetros al método:

• AccessToken — el token de pago, el cual se recibió al adquirir el artículo.
• OrderId — el ID del pedido, el cual se recibió al adquirir el artículo.
• SuccessCallback — devolución de llamada de pago realizada correctamente.
• ErrorCallback — devolución de llamada de error de la solicitud.
• bIsUserInvolvedToPayment — si el usuario participa en el proceso de pago. Transmita true para la compra con moneda real, y false para la compra de artículos gratuitos y la compra con moneda virtual.

El mecanismo de seguimiento se explica en la documentación de SDK de nivel empresarial para Unreal Engine.

Para solicitar el estado y el contenido de un pedido, invoque el método CheckOrder del SDK, transmitiéndole los siguientes parámetros:

• AccessToken — el token de pago, el cual se recibió al adquirir el artículo.
• OrderId — el ID del pedido, el cual se recibió al adquirir el artículo.
• SuccessCallback — la devolución de llamada para la comprobación satisfactoria del pedido. La respuesta contiene el estado del pedido.
• ErrorCallback — devolución de llamada de error de la solicitud.