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.

Para exibir corretamente a quantidade disponível a um usuário, você deve configurar a autenticação. Usuários não autenticados sempre veem a quantidade máxima de itens que podem comprar. Para exibir a quantidade de itens restante do usuário com o limite ativo aplicado, inclua os dados de autorização do usuário ao solicitar:

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

Para configurar os limites de uso da promoção, consulte as instruções.

Configuração e atualização de limites

Configuração e atualização na Conta de Distribuidor

Para criar um item com uma quantidade limitada de usos:

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items > Virtual items.
2. Selecione Add e então Virtual items.

3. Especifique os seguintes parâmetros:
   • imagem
   • SKU
   • um ou diversos grupos aos quais o item deve pertencer
   • nome
   • descrição
   • preços

4. 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.
5. Para definir quantas vezes os limites são atualizados:
   1. 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.

1. 2. Defina o cronograma de atualização especificando os parâmetros correspondentes ao período.

6. 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.
7. Selecione Create item.

Para configurar ou atualizar limites para um item existente:

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items > Virtual items.
2. Abra o grupo contendo o item.
3. Na fileira do item, selecione ••• e escolha Edit na lista suspensa.
4. 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.
5. 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:

• Criar item virtual
• Criar jogo
• Criar moeda virtual
• Criar pacote de moedas virtuais
• Criar conjunto

Para atualizar e gerenciar limites, use as chamadas API da seção Limits:

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

Os itens dos quais o usuário já atingiu o limite de compra são retornados com 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.

Links úteis

Última atualização: 13 de Fevereiro de 2026