Restrições regionais de venda

Como funciona

As restrições de venda regionais permitem que você controle em quais países suas chaves de jogo podem ser vendidas, e também ajuda a prevenir abusos, como quando um usuário compra uma chave por preço reduzido em uma região e ativa-a em outra região.

O país do usuário é passado no parâmetro country ao solicitar um catálogo (chamada de API Get game list). Se esse parâmetro não for fornecido, o país será determinado com base no endereço IP do usuário. O catálogo é gerado então com base no país do usuário.

Aviso
Quando as restrições de venda regionais estão ativadas, um país deve ser incluído em ao menos uma região para que as chaves possam ser vendidas nele. Se um país não fizer parte de uma região, as chaves não estarão disponíveis nesse país.

Quem pode usar

Parceiros que desejam limitar a disponibilidade de chaves de jogo em certas regiões.

Fluxo de integração

Para configurar restrições regionais:

  1. Crie regiões onde o SKU do jogo ficará disponível enviando a chamada de API Create region. A API retorna o ID da região, que será necessário na próxima etapa.

Exemplo de criação de uma região norte-americana que inclui os EUA e o Canadá:

Copy
Full screen
Small screen
1{
2  "name": {
3     "en-US": "North America",
4   },
5  "countries": ["US", "CA"]
6}
Observação
O código do país é especificado no formato ISO 3166-1 alpha-2. Confira a lista de países suportados pela Xsolla antes de criar uma região.

  1. Passe o ID da região à matriz regions chamando a categoria Admin do grupo Game keys ao criar ou atualizar um jogo.

Exemplo de uma matriz regions com IDs de regiões onde chaves de jogo podem ser vendidas:

Copy
Full screen
Small screen
1"regions": [
2  {
3     "id": 123
4  },
5  {
6     "id": 456
7  }
8]
Aviso
Depois que as regiões forem configuradas e atribuídas a um jogo, chaves só podem ser enviadas usando a chamada de API Upload codes.
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: 19 de Setembro de 2025

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.