Se você não tiver nenhum servidor ou implementar a lógica para processamento de compras no lado do cliente, você poderá usar as seguintes maneiras:

1. WebSocket API.
2. Short-polling.

Obtenção de status de pedido no lado do cliente usando WebSocket API

A solução utiliza websockets para obter diversos status do pedido sem obter informações detalhadas sobre ele. Esse método é preferível: apenas uma conexão é criada entre o cliente (por exemplo, seu site ou aplicativo móvel) e o servidor Xsolla, e portanto não há carga adicional no cliente ou no servidor.

Conclua as seguintes etapas:

1. Para permitir que o servidor de websocket Xsolla e o seu cliente identifiquem mensagens de status de pedido, crie uma conexão:

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 receber novas mensagens sobre status de pedidos, inscreva-se em eventos usando a função client.on:

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

3. Acione o estabelecimento de uma conexão:

client.connect()

4. Para receber o histórico de alterações nos status de pedidos, conecte o método API de histórico.

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

Exemplo de corpo de mensagem:

{
order_id: 59614241,
status: 'new'
}

Os seguintes status de pedido são possíveis:

• New — o pedido foi criado mas não pago
• Paid — o pedido foi pago
• Done — o pedido foi entregue (todos os recibos enviados, entregas feitas do lado da Xsolla, plataformas externas, etc.)
• Canceled — o pedido é cancelado e o pagamento reembolsado a um usuário

Recomendações de uso de websocket:

• O tempo máximo de espera por uma resposta via websocket é de 5 minutos.
• A conexão deve ser estabelecida ao abrir a interface de pagamento.
• A conexão deve ser abortada quando o status final do pedido for recebido, seja ele Canceled ou Done.
• Se o tempo de vida útil do websocket expirar, ou se houver qualquer problema com a conexão, utilize short-polling.

  Short-polling

  Para obter informações detalhadas sobre itens no pedido depois de alternar para o status, chame a API Obter pedido.

  Observação

  Uma pesquisa periódica de status do pedido é usada — uma solicitação HTTP simples que recebe o status do pedido e informações sobre o pedido. O atraso recomendado entre as solicitações é de 3 segundos.

O método XsollaCatalog.Purchase encapsula diversos métodos para rastrear o status do pedido. O mecanismo de rastreamento é detalhado na documentação do SDK de nível empresarial para Unity.

Adicionalmente, você pode implementar o gerenciamento do status e conteúdo do pedido, que são passados à função de retorno de chamada onSuccess do método comprado.

Ao usar o SDK, você pode rastrear o status do pedido das seguintes maneiras:

• inscrevendo-se nas alterações de status do pedido
• solicitando o status do pedido

Inscrevendo-se nas alterações de status do pedido

Para se inscrever nas alterações de status de pedido, use o método SDK getOrderStatus da biblioteca Store e passe os seguintes parâmetros ao método:

• listener — objeto do ouvinte do tipo OrderStatusListener.
• orderId — ID do pedido recebido da compra através do carrinho de compras, compras com um clique ou compras com moedas virtuais como parâmetro.

Documentação de referência do SDK

Saiba mais sobre os métodos SDK e seus parâmetros.

Exemplo de chamada do 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 chamar o método XStore.getOrderStatus ao abrir a interface de pagamento.

Esses métodos de compra encapsulam vários métodos para controlar o status do pedido. O rastreamento é realizado de acordo com o seguinte algoritmo:

1. Uma conexão de websocket é estabelecida.
2. Se a conexão for estabelecida com sucesso e o status do pedido for alterado para done ou cancel, o rastreamento é interrompido. Se uma conexão de websocket falhar ou a resposta contiver dados incorretos, o status do pedido é rastreado usando short-polling.
3. O rastreamento do status do pedido continua com short-polling. Uma solicitação de status de pedido HTTP simples é enviada a cada 3 segundos. O rastreamento é interrompido se o status do pedido for alterado para done ou cancel.

Solicitando o status do pedido

Para solicitar o status atual da transação de pagamento, chame o método getOrder da biblioteca Store, passando os seguintes parâmetros a ele:

• orderId — o ID de pedido, que foi recebido ao comprar o item.

• callback — o retorno de chamada por receber as informações do pedido com sucesso. Ao implementar um retorno de chamada, use a interface GetStatusCallback e implemente os métodos onSuccess e onError.

• callback — o retorno de chamada por receber as informações do pedido com sucesso. Ao implementar um retorno de chamada, use a interface GetStatusCallback e implemente os métodos onSuccess e onError.

Exemplo:

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

})

Você pode rastrear o status do pedido usando o método SDK CheckPendingOrder. Passe os seguintes parâmetros ao método:

• AccessToken — o token de pagamento, que foi recebido ao comprar o item.
• OrderId o ID de pedido, que foi recebido ao comprar o item.
• SuccessCallback — o retorno de chamado de pagamento bem-sucedido.
• ErrorCallback — o retorno de chamada de erro de solicitação.
• bIsUserInvolvedToPayment — se o usuário está envolvido no processo de pagamento. Passe true para comprar com moedas reais, e false para a compra de itens grátis e compras com moedas virtuais.

O mecanismo de rastreamento é detalhado na documentação SDK de nível empresarial do Unreal Engine.

Para solicitar o status e conteúdo de um pedido, chame o método SDK CheckOrder, passe os seguintes parâmetros a ele:

• AccessToken — o token de pagamento, que foi recebido ao comprar o item.
• OrderId o ID de pedido, que foi recebido ao comprar o item.
• SuccessCallback — o retorno de chamada de verificação de pedido bem-sucedido. A resposta contém o status de pedido.
• ErrorCallback — o retorno de chamada de erro de solicitação.