Restrições regionais de vendas

Como funciona

As restrições de venda regionais permitem que você controle em quais países seus itens virtuais ou pacotes de moedas podem ser vendidos. A Xsolla detecta o país do usuário e exibe somente os itens disponíveis na região.

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

Quem pode usar

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

Fluxo de integração

Para configurar restrições regionais:

  1. Crie regiões onde seus itens estão disponíveis chamando a API Create region. A API retorna o ID da região, que será preciso 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 de regiões chamando o API da categoria Admin do grupo Virtual items & currency ao criar ou atualizar o SKU de um item.
Exemplo de uma matriz regions com IDs de regiões onde os itens podem ser vendidos:
Copy
Full screen
Small screen
1"regions": [
2  {
3     "id": 123
4  },
5  {
6     "id": 456
7  }
8]
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: 8 de Outubro 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.