Configuração de venda de itens
Venda de itens
Você pode vender itens das seguintes maneiras:
- 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).
- Comprar um carrinho. Neste caso, o jogador pode pré-encher um carrinho, adicionar ou remover itens, ou alterar suas quantidades.
Compra rápida
- Chame a API Criar pedido com item especificado . Um token para abrir a interface de pagamento será passado para a resposta.
- Abra a interface de pagamento usando o token de pagamento recebido.
Compra no carrinho
Implemente a lógica:- 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.
- 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.
- 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.
- 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.
- 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:
- 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.
- 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.
- 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
, ondeACCESS_TOKEN
é o token recebido quando o pedido foi criado. - Via widget. Use o script Xsolla PayStation Widget (o arquivo README contém instruções).
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.