Códigos promocionais

Como funciona

Informações gerais

Promoções com códigos promocionais são uma ferramenta de marketing desenvolvida para reforçar as taxas de conversões de compra e aumentar a receita média. Quando um código promocional é aplicado a um pedido, o usuário pode receber:

  • um desconto aplicado na compra inteira ou em itens específicos
  • itens bônus, incluindo:
    • pacotes de moedas virtuais
    • chaves de jogo
    • itens virtuais
    • conjuntos

Recursos principais:

  • Configuração de bônux flexível. Você pode configurar um tipo de bônus único (desconto em uma compra, desconto em itens específicos, ou um item bônus) ou uma combinação deles.
  • Definição da quantidade total de resgates dentro de uma campanha.
  • Definição da quantidade de resgates por usuário dentro de uma campanha.
  • Múltipla geração de códigos promocionais.
  • Aplicação de restrições regionais para campanhas e itens vinculados a um código promocional.
Observação
Para configurar restrições regionais para uma campanha, contate-nos via igs@xsolla.com.

Limitações:

  • Apenas um código promocional pode ser aplicado à compra.
  • Para receber um desconto ou item bônus, o usuário deve pagar pela compra.
  • Descontos não são aplicados a preços especificados nas moedas virtuais. Para itens tanto com preços de moedas reais e virtuais, os descontos se aplicam somente ao preço de moedas reais.
  • Se chaves de jogo forem usadas como um item bônus, a chave será enviada ao usuário via e-mail ou para o sistema de direitos após o resgate. Se a campanha exaurir as chaves, o usuário não poderá resgatar o código promocional.
  • Se as restrições regionais forem aplicadas a uma campanha de código promocional, os usuários dessas regiões não poderão resgatar o código promocional.
  • Se um código promocional incluir ao menos um item bônus com uma restrição regional, um usuário daquela região não poderá resgatar esse código promocional.
Exemplo: Um escudo e espada são oferecidos como bônus com o código promocional. O escudo tem uma restrição regional e está disponível para compra somente nos EUA. Se um usuário fora dos EUA inserir o código promocional, um erro será retornado em resposta às chamadas Verify promotion code ou Redeem promo code. O usuário não conseguirá obter qualquer um dos itens do código promocional.
Observação

Você também pode configurar promoções de cupons para sua loja.

Principais diferenças:

  • Um cupom permite que um usuário receba somente itens bônus. Um código promocional pode fornecer itens bônus, um desconto para um item específico, ou um desconto no carrinho inteiro.
  • Códigos promocionais são resgatados durante a compra (na finalização), e os cupons são resgatados após o usuário inserir e aplicar o código.

Fluxo do usuário

Observação
O usuário pode cancelar a aplicação do código de promoção antes de concluir o pagamento.

Regras para aplicar descontos

Se várias promoções forem válidas para um item no momento da compra, os descontos serão aplicados ao item um a um. A ordem em que os descontos são aplicados não importa.

Exemplo:

O preço de um item virtual é $10. Na Conta de Distribuidor, as seguintes promoções foram criadas para os itens virtuais:

  • Promoção de desconto Black Friday com um desconto de 10% entre 4 e 30 de novembro
  • Promoção de desconto Oferta com um desconto de 20% entre 15 de novembro e 15 de dezembro
  • promoção com um código promocional de 5% de desconto entre 4 e 30 de novembro

Se o item for comprado em 20 de novembro, tanto as promoções de desconto quanto as promoções com códigos promocionais são válidas.

O custo total do item virtual é então calculado como (($10 - 10%) - 20%) - 5% = $10 × (100%-10%) × (100%-20%) × (100%-5%) = $10 × 0,9 × 0,8 × 0,95, e será de $6,84 USD.

Configure uma campanha com códigos promocionais

Observação

Se quiser criar uma promoção com itens bônus, você precisa primeiro configurar esses itens e então prosseguir à configuração da promoção.

Para criar itens manualmente no seu projeto na Conta de Distribuidor, acesse Items catalog > All items. Encontre informações detalhadas sobre esse e outros métodos para criar itens na seção Catálogo de itens da documentação.

Configuração na Conta de Distribuidor

Para criar uma nova campanha com códigos promocionais:

  1. Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Promotions.
  2. Na aba Promotions, selecione Create promotion.
  1. Especifique o Nome da promoção (Promotion name).
  2. Na lista suspensa Promotion type, selecione Promo code.
  3. No campo External ID, especifique um ID de promoção usado para gerenciar promoções via chamadas de API.
  4. Para aplicar um desconto a qualquer item ou o carrinho inteiro quando um código promocional é resgatado:

    1. Defina a poção Discount on purchase como On.
    1. Campo Discount amount, especifique o percentual de desconto.

  1. Para aplicar um desconto a itens específicos quando um código promocional é resgatado:

    1. Defina a opção Discount on selected items como On.
    1. Campo Discount amount, especifique o percentual de desconto.
    1. Na lista suspensa Item type, selecione o tipo do item que será descontado ao resgatar o código promocional.
    1. Selecione os itens.

  1. Para fornecer itens bônus quando um código promocional é resgatado:

    1. Defina a opção Bonus items como On.
    1. Na lista suspensa Select bonus items, selecione o tipo de um item a ser concedido ao usuário após o resgate do código promocional.
    1. Selecione os itens a serem fornecidos ao resgatar o código promocional.
    1. Para itens virtuais, especifique a quantidade para cada item.
    1. Para chaves de jogo, especifique quando a plataforma será determinada:
      • Para pré-atribuir uma plataforma específica (ex.: Steam), selecione Select DRM during code generation na lista suspensa Type of DRM selection. Depois, selecione a plataforma da lista suspensa DRM.
      • Para permitir que o usuário escolha, selecione Player selects DRM at redemption na lista suspensa Type of DRM selection.
    1. Selecione Next.

Observação

O desconto para um pedido ou itens específicos deve ser um número inteiro e não pode exceder 99%. Ao configurar descontos para itens específicos ou itens bônus, considere o seguinte:

  • Um tipo de item fica disponível para seleção somente se ao menos um item daquele tipo foi criado no seu projeto.
  • Você pode configurar itens ou tipos diferentes. Para trocar entre tipos de itens, use o campo de seleção do tipo de item.
  1. Configure limites de resgate de códigos promocionais:

    1. Para limitar a quantidade total de resgates de códigos promocionais entre todos os usuários dentro de uma campanha, defina a opção Limit total number of redemptions como On e especifique a quantidade máxima de resgates.
    1. Para limitar a quantidade de códigos promocionais que um único usuário pode resgatar dentro de uma campanha, defina a opção Limit total number of redemptions per user como On e especifique a quantidade máxima de resgates por usuário.
    1. Para limitar a quantidade de vezes que qualquer código promocional exclusivo pode ser resgatado entre todos os usuários, defina a opção Limit number of unique promo code redemptions como On e especifique a quantidade máxima de resgates para o cupom promocional.
    1. Selecione Next.

  1. Especifique o período de validade da campanha: um fuso horário, data inicial e data final. Para criar uma campanha sem uma data final, marque a caixa No end date.
  2. Selecione Next.
  3. Revise as configurações de campanha.
  4. Selecione Save and exit.

Para adicionar códigos promocionais a uma campanha:

  1. Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Promotions.
  2. Na fileira da promoção de código promocional, selecione ••• e escolha Edit promotion na lista suspensa.
  1. Vá para a aba Codes.
  2. Para gerar códigos automaticamente:
    1. Na lista suspensa Code string format, selecione Auto-generated.
    1. Especifique a quantidade de códigos a gerar e selecione Generate.
  1. Para adicionar códigos manualmente:
    1. Na lista suspensa Code string format, selecione Manually entered.
    1. Insira o código promocional e selecione Create.
    1. Repita a etapa anterior para adicionar a quantidade necessária de códigos.
  1. Baixe um arquivo CSV com os códigos (opcional).
Observação

Códigos promocionais diferenciam maiúsculas de minúsculas. Por exemplo, winter123 e WINTER123 são considerados cupons promocionais diferentes.

Você pode adicionar novos códigos a uma campanha quantas vezes quiser sem limitações. Porém, a quantidade total de códigos adicionados não pode exceder 50.000.

Se você precisar enviar uma quantidade grande de códigos autogerados, contate-nos via igs@xsolla.com.

Para disponibilizar a campanha aos usuários, você deve ativá-la. Para fazer isso:

  1. Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Promotions.
  2. Na fileira da promoção de código promocional, selecione ••• e escolha Edit promotion na lista suspensa.
  3. Na lista suspensa no canto superior direito, selecione Activate promotion.

Configurar via API

Observação
Ao configurar uma promoção via API, você pode especificar uma quantidade de desconto fracionada.
Aviso
A lista de parâmetros necessários ao usar as chamadas API para atualizar as promoções não corresponde à lista de parâmetros retornados pelas chamadas API para recuperar promoções. Ao chamar os métodos API para atualizar promoções, você deve passar:
  • os parâmetros necessários
  • os parâmetros que você deseja alterar
  • todos os outros parâmetros retornados pela chamada de recuperação de promoções

Para configurar e gerenciar campanhas com códigos promocinais via API, use as seguintes chamadas:

TarefaChamada API
Crie uma promoção com um código promocional.Crie uma promoção de código promocional.
Ativar uma promoção com um código promocional.Ative uma promoção de código promocional.
Edite uma promoção.Atualize a promoção de código promocional com novas opções de promoção. A edição de promoções também está disponível para promoções com o status Active.
Desativar promoção.Desative a promoção de código promocional.
Defina uma promoção de prazo indeterminado.Create promo code promotion ou Update promo code promotion. Passe o parâmetro “date_end”:null às chamadas especificadas.
Exclua uma promoção.Delete promo code promotion.
Observação
Se você desativar ou excluir uma promoção ativa, ela não ficará mais disponível aos usuários.

Defina uma resgate de código promocional no seu aplicativo ou site

Uso de código promocional na sua interface

  1. Na interface do seu aplicativo (no catálogo ou carrinho), implemente os seguintes elementos:

    • um campo de entrada de código promocional
    • Elementos de interface para exibir recompensas e descontos de código promocional
    • um formulário de seleção para recompensas de código promocional (se aplicável)
    • um botão para aplicar o código promocional
  2. Implemente a lógica do código promocional usando as seguintes chamadas API do lado do cliente:

Observação
Para chamar a API Xsolla, você pode usar os métodos SDK prontos para engines e plataformas de jogos:
TarefaChamada API
Confira se o código promocional é válido.Verificar o código promocional.
Obtenha uma lista de plataformas de distribuição de jogos para exibir ao usuário se uma chave de jogo é fornecida como bônus de cupom promocional.

Obter recompensas de código promocional.

Se a resposta retornar is_selectable=true, para cada item com type=unit, você deve exibir um formulário de seleção para os elementos no objeto unit_items. Nesse formulário, o usuário pode selecionar apenas um elemento para cada tipo de unit.

O parâmetro type=unit é passado para chaves de jogo. Nesse caso, o usuário precisará selecionar uma plataforma de jogo.

Exiba o catálogo atualizado considerando descontos e itens bônus de um código promocional.Use chamadas da subseção Catalog. Você precisa passar o código promocional no parâmetro de solicitação promo_code.
Compre um item específico diretamente (sem adicioná-lo ao carrinho) e resgate um código promocional.

Criar pedido com item especificado.

Você precisa passar o código promocional no parâmetro de solicitação promo_code.

Aplique um código promocional e atualize o conteúdo do carrinho e custo total (aplicar descontos e adicionar itens bônus).

Resgatar código promocional.

Você precisa passar o código promocional no parâmetro de solicitação coupon_code.

Observação
Para verificar adicionalmente quantas vezes um usuário pode aplicar um código promocional dentro de uma campanha, use a chamada API do lado do servidor Obter limite de código promocional para o usuário especificado.
  1. Garanta que os itens sejam corretamente concedidos ao usuário no resgate do código promocional.
  1. Se você já implementou uma loja no jogo no seu aplicativo ou no seu site, não é necessária nenhuma outra configuração. Os itens vinculados a um código promocional são concedidos ao usuário da mesma maneira que uma compra padrão.
Observação
Chaves de jogo são enviadas ao usuário por e-mail ou para o sistema de direitos.

Uso de códigos promocionais no site criados com a Xsolla

Aviso
Você só pode adicionar o cupom e o recurso de resgate de códigos promocionais a sites criados usando o modelo Web Shop.

Para exibir o campo de entrada de código no seu site:

  1. Abra seu projeto na Conta de Distribuidor e acesse a seção Storefronts > Websites.
  2. Na seção Sites, selecione seu site e clique em Open Site Builder.
  3. Na área principal do construtor, escolha um lugar onde você deseja adicionar um novo bloco e selecione Add block.
  4. Selecione o bloco Promo codes.
  5. Personalize a aparência do bloco (opcional):
    • Edite o cabeçalho do bloco e texto de descrição.
    • Defina um plano de fundo personalizado para o bloco.
    • Altere o estilo do botão.
    • Edite o texto para o botão de resgate do cupom.
  6. Para aplicar as alterações, publique o site:

    1. No canto superior direito do construtor de sites, selecione Publish.
    1. Marque as caixas próximas às páginas que deseja publicar.
    1. Selecione Publish.

Observação

Se a publicação do site não estiver disponível, certifique-se de que todas as condições sejam cumpridas:

  • Não há seções vazias no construtor (marcadas com um indicador vermelho).
  • O Acordo de Licenciamento com a Xsolla foi assinado.
  • A página principal foi publicada ou selecionada para publicação. Você não pode publicar páginas descendentes antes da página principal.
Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Última atualização: 13 de Fevereiro de 2026

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

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!
Não conseguimos enviar seu feedback
Tente novamente mais tarde ou contate-nos via doc_feedback@xsolla.com.