Restrições regionais de venda

Como funciona

As restrições de venda regionais permitem que você controle em quais países seus itens podem ser vendidos e ajudam a prevenir abusos, por exemplo, quando um usuário compra uma chave de jogo 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 o catálogo usando chamadas API da subseção Catálogo do grupo Chaves de jogo e o grupo Itens virtuais & moeda. Se o parâmetro não for fornecido, o país é determinado com base no endereço IP do usuário. O sistema então gera um catálogo de itens disponíveis no país do usuário.

Quem pode usar

Parceiros que querem limitar a disponibilidade em certos países ou regiões.

Fluxo de integração

Observação
Se as regiões forem especificadas para um item e o país do usuário não estiver incluso em qualquer um deles, o item não está disponível no país.
Para configurar as restrições regionais de vendas:
  1. Crie regiões onde itens ficarão disponíveis chamando a chamada API Criar região. 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 para a matriz regions ao criar ou atualizar um item usando as chamadas de API correspondentes da subseção Admin:
Exemplo de uma matriz regions com IDs de regiões onde o item pode ser vendido:
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 Carregar códigos.
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.