Limites de compra do item
Como funciona
Você pode determinar um limite de compra por usuário e configurar redefinições programadas para esses limites.
A configuração de limite está disponível para os seguintes cenários:
- venda de itens no jogo — itens virtuais, pacotes de moedas virtuais e conjuntos
- venda de jogos e DLCs via chaves de jogo
Você pode ativar redefinições periódicas de limites para:
- permitir compras repetidas.
- sincronizar dados com o seu sistema quando itens são vendidos entre diversas plataformas de publicação de jogos.
- o catálogo de itens usando chamadas da subseção Catálogo do grupo Itens virtuais & Moeda.
- O catálogo de jogos usando chamadas da subseção Catálogo do grupo Game Keys.
A Xsolla aplica limites e impede que usuários comprem mais itens do que o limite definido.
- Quando a interface de pagamento é aberta e um item é comprado, todos os pedidos não pagos que contêm o item se tornam inválidos.
- Exemplo: um usuário pode abrir o formulário de pagamento por um item limitado em múltiplas abas de navegador ou navegadores diferentes antes de concluir a compra, o que cria diversos pedidos para o mesmo item. Quando a compra é concluída em uma aba, a Xsolla cancela todos os pedidos não pagos daquele item.
- Quando um pagamento é reembolsado ou um pedido é cancelado, os limites não são redefinidos. Você pode redefini-los usando as seguintes chamadas de API: Atualizar todos os limites de compra para o usuário especificado e Atualizar todos os limites de promoção para o usuário especificado.
- Exemplo: um usuário pode comprar um item que possui limites de compra, usá-lo no jogo, e então solicitar um reembolso. Se os limites fossem redefinidos automaticamente, o usuário poderia comprar o item novamente, usá-lo e repetir o ciclo, efetivamente contornando os limites planejados. Para impedir isso, os limites não são redefinidos quando um pagamento é reembolsado ou quando um pedido é cancelado.
Configuração e atualização de limites
Configuração e atualização na Conta de Distribuidor
- O processo de configuração abaixo é exibido usando itens virtuais como exemplo.
- Antes de configurar itens virtuais, é recomendado criar grupos. Grupos permitem que você construa um catálogo multinível e gerencie como os itens são exibidos na sua loja.
- Na Conta de Distribuidor, você pode atualizar limites para um item específico de todos os usuários. Há opções avançadas de configuração disponíveis via chamadas de API.
- Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items > Virtual items.
- Selecione Add e então Virtual items.
- Especifique os seguintes parâmetros:
- imagem
- SKU
- um ou diversos grupos aos quais o item deve pertencer
- nome
- descrição
- preços
- Para limitar a quantidade de vezes que um usuário pode comprar um item, defina a opção Limit the number of times one user can buy this item como On e especifique o limite.
- Para definir quantas vezes os limites são atualizados:
- Na lista suspensa, selecione o período:
- Diário
- Semanal
- Mensal
- Intervalo personalizado. O intervalo é calculado a partir da data inicial do período de exibição do item na loja.
- Sem atualização regular.
- Na lista suspensa, selecione o período:
- Defina o cronograma de atualização especificando os parâmetros correspondentes ao período.
- Para definir um período de exibição do item no catálogo, selecione Limited time, especifique o fuso horário, data inicial e data final. Para tornar um item disponível indefinidamente, selecione No end date.
- Selecione Create item.
Para configurar ou atualizar limites para um item existente:
- Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items > Virtual items.
- Abra o grupo contendo o item.
- Na fileira do item, selecione ••• e escolha Edit na lista suspensa.
- Na seção Limites for single user, defina o limite e/ou selecione a frequência de redefinição de limites, então especifique o horário e fuso.
- Selecione Save changes.

Configure e atualize via chamadas API
Para definir limites diários, semanais ou mensais, passe a matriz recurrent_schedule nas seguintes chamadas API:
| Característica | Chamada de API |
|---|---|
| Atualizar limites do item especificado para todos ou alguns dos usuários. | Atualizar limite de compra. |
| Limpa todos os limites para um usuário específico. | Atualizar todos os limites de compra para o usuário especificado. |
| Altera o limite na compra de um item especificado para um usuário especificado. | Defina o número de itens disponíveis para o usuário especificado. |
| Obtém informações sobre quais limites são configurados para um item especificado e para um usuário especificado. | Obtenha o número de itens disponíveis para o usuário especificado. |
| Aumenta o número de itens que podem ser comprados por um usuário específico. | Aumente o número de itens disponíveis para o usuário especificado. |
| Reduz o número de itens que podem ser comprados para um usuário específico. | Diminuir o número de itens disponíveis para o usuário especificado. |
Exibe os limites no catálogo de itens
Limites na venda de itens são exibidos no catálogo dependendo de como são implementados — seja pelo Site Builder ou via API.
Exibição via site builder
Se você usar o construtor de sites, os limites são exibidos automaticamente — um cartão de itens exibe um contador de itens disponíveis ao usuário.
Obter informações de limites via API
Se o catálogo for implementado usando a API, a informação de limites é retornada na matriz items.limits nas seguintes chamadas API relacionadas ao catálogo:
- Obter lista de itens virtuais
- Obter lista de moedas virtuais
- Obter lista de pacotes de moedas virtuais
- Obter lista de pacotes
- Obter lista de jogos
can_be_bought = false.
Você pode atualizar esses limites como necessário.
Esses dados podem ser usados para exibir limites no catálogo — por exemplo, para exibir a quantidade máxima de itens disponíveis para compra.Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.