Integre a loja ao jogo

Depois de criar e configurar bens (itens virtuais, moedas virtuais, conjuntos, chaves) em sua Conta de Distribuidor, adicione uma In-Game Store ao seu jogo:

1. Implemente a exibição do catálogo de itens.
2. Implemente a lógica de venda de itens.

Exibição do catálogo de itens

Implemente uma exibição do catálogo de itens por meio de chamadas da In-Game Store API:

Venda de itens

Você pode vender itens das seguintes maneiras:

1. Compra rápida de um item. Neste caso, você pode vender um SKU em qualquer quantidade (por exemplo, 100 poções idênticas ou uma quantia personalizada de moedas virtuais).
2. Comprar um carrinho. Neste caso, o jogador pode pré-encher um carrinho, adicionar ou remover itens, ou alterar suas quantidades.

Compra rápida

Compra no carrinho

1. Para configurar um carrinho e obter o token:
   • No cliente — se você quiser implementar o carrinho em seu aplicativo por conta própria.
   • No servidor — se você quiser usar a solução da Xsolla (Chamadas de In-Game Store API) para gerenciar o carrinho.
2. Para abrir a interface de pagamento.

Configure e compre um carrinho no cliente

Implemente a lógica de adicionar e remover itens por si mesmo. Você também precisa considerar que, antes de chamar a API para configurar um carrinho, você não terá informações sobre quais promoções serão aplicadas à compra. Isso significa que o custo total e os detalhes dos itens de bônus adicionados não serão conhecidos.

1. Depois que o jogador tiver preenchido um carrinho, chame a API Preencher o carrinho com itens. As informações atuais sobre os itens selecionados (preços antes e depois dos descontos, itens bônus) serão passadas para a resposta.
2. Chame a API Criar pedido com todos os itens do carrinho atual. O ID do pedido e o token de pagamento serão passados para a resposta. O pedido criado receberá um status de pedido New.
3. Abra a interface de pagamento.

Configure e compre um carrinho no servidor

Essa variante pode levar mais tempo para configurar o carrinho, já que cada alteração no carrinho deve ser acompanhada por chamadas de API.

Conclua as seguintes etapas:

1. Alterar o carrinho:
   • Para adicionar um item ou alterar a quantidade do item, chame a API Update cart item by card ID.
   • Para remover um item, chame a API Delete cart item by card ID.

2. Chame a API Create order with all items from the current cart. O ID do pedido e o token de pagamento serão passados para a resposta. O pedido criado receberá um status de New.
3. Abra a interface de pagamento.

Abertura da interface de pagamento

Para itens pagos, abra a interface de pagamento. Um token para abrir a interface de pagamento será passado para a resposta API Criar pedido com todos os itens do carrinho atual.

Implemente a abertura da interface de pagamento de uma das seguintes maneiras:

• Em uma nova janela. Para abrir a interface de pagamento em uma nova janela do navegador, use o link: https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN, onde ACCESS_TOKEN é o token recebido quando o pedido foi criado.
• Via widget. Use o script Xsolla PayStation Widget (o arquivo README contém instruções).

Teste do processo de pagamento

Você pode testar o fluxo de pagamento no modo Sandbox. Você pode usar um cartão bancário de teste e qualquer conta.

Obtenção do status do pedido do usuário

Você pode usar as seguintes maneiras de obter um status de pedido do usuário:

1. No lado do servidor via webhooks.
2. No lado do cliente via WebSocket API ou IGS API.

Obtenha o status do pedido do usuário no lado do servidor por meio de webhooks

Obtenha o status do pedido do usuário no lado do cliente via WebSocket API ou IGS API

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.
  Este artigo foi útil?

  Sim

  Não

  Obrigado!

  Podemos melhorar alguma coisa? Mensagem Enviar

  Que pena ouvir isso

  Explique porque este artigo não foi útil para você. Mensagem Enviar

  Obrigado pelo seu feedback!

  Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
  Última atualização: 8 de Novembro de 2024

  Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.