Preços regionais

A configurar um catálogo de itens, você deve definir as políticas de preço para usuários em diferentes países (precificação regional) para itens virtuais e pacotes de chaves de jogo. Por padrão, o preço por cada item ou pacote de chaves de jogo é definido em USD. Você pode definir restrições regionais e preços regionais ao mesmo tempo.

Como funciona

Os preços no catálogo se baseiam no país do usuário.

Durante o pagamento via Pay Station, o preço de um item é convertido para a moeda do país do usuário e inclui impostos, se aplicável.

Determinação de país

• Ao solicitar um catálogo de itens, o país do usuário é passado no parâmetro country nos métodos da subseção Catalog do grupo de métodos Virtual Items & Currency ou Game keys.
  Se o país não for especificado, ele será determinado com base no endereço IP do usuário. Depois, os preços para o catálogo de itens são selecionados para o país do usuário.
• Ao comprar um item:
  • Se você usar as chamadas de cliente para obter um token de pagamento, é importante usá-las apenas do lado do cliente e não do lado do servidor. O país e a moeda nas chamadas de clientes são determinados pelo endereço IP do usuário. Usar esse método a partir do servidor pode levar a uma determinação incorreta da moeda e afetar os métodos de pagamento no Pay Station.
  • Se você usar a chamada de servidor Criar token de pagamento para compra, você deverá passar o objeto country no corpo da solicitação ou o endereço IP do usuário no cabeçalho X-User-Ip.

1. 1. Se o país no parâmetro country.value e o endereço IP no cabeçalho X-User-Ip forem passados, a preferência é dada ao valor do país no parâmetro country.value.

Princípios de exibição de preço no catálogo de itens

Para todos os itens do catálogo, você deve usar a mesma lista de moedas na qual os preços são especificados.

Isso deve ser feito para que todos os itens do catálogo sejam exibidos na mesma moeda. Se o preço não for especificado para um dos itens em um dos países, os preços de todo o catálogo nesse país serão exibidos na moeda padrão.

Se a moeda padrão for diferente nos itens, o preço será exibido na moeda padrão do primeiro item no catálogo. Se um dos itens não possuir um preço nessa moeda, será retornado um valor de null na resposta. Isso levará a uma exibição incorreta do preço do item e pode afetar a exibição do catálogo como um todo.

Exemplos:

• 1 item, 1 moeda, sem preços regionais
• 1 item, 2 moedas, sem preços regionais
• 1 item, existem preços regionais
• Múltiplos itens, existem preços regionais, uma moeda padrão
• Múltiplos itens, existem preços regionais, moedas padrões diferentes

A moeda padrão para o item é USD e o preço é 5 USD. Não há configurações para países. Nesse caso, todos os usuários de todos os países verão esse preço.

Duas opções de preço são definidas para o item: em USD e em EUR, mas preços especiais para países não são especificados. Nesse caso, os usuários dos países onde EUR é usado verão o preço como 7 EUR. Os usuários de todos os outros países verão o preço como 5 USD, pois esse é o preço na moeda padrão.

O projeto possui preços nas seguintes moedas:

• preço padrão — 7 USD
• preço em euro — 6 EUR
• preços regionais:
  • Alemanha — 8 EUR
  • Itália — 5 EUR
  • Malásia — 20 MYR
  • África do Sul — 90 ZAR

Dependendo do país do usuário, a exibição de preços no catálogo será como a seguir:

País do usuário	Preço do catálogo	Comentário
EUA	7 USD	Os EUA é um país onde se utiliza USD. Um preço especial para os EUA não é especificado.
Japão	7 USD	A moeda do Japão não é especificada, então o preço é exibido na moeda padrão.
França	6 EUR	A França é um país onde se utiliza EUR. Um preço especial para a França não é especificado.
Alemanha	8 EUR	Um preço regional é especificado para a Alemanha.
Itália	5 EUR	Um preço regional é especificado para a Itália.
Malásia	20 MYR	Um preço regional é especificado para a Malásia.
África do Sul	90 ZAR	Um preço regional é especificado para a África do Sul.

O projeto tem preços nas seguintes moedas:

• o preço padrão para todos os itens é exibido em dólares americanos (USD)
• na Malásia, os preços para todos os itens estão no Ringgit malaio (MYR)
• na África do Sul, os preços para todos os itens, com exceção de um, em Rand sul-africano (ZAR)

Nesse caso, o catálogo é exibido em MYR para os usuários da Malásia, mas em USD para a África do Sul. Para os usuários da África do Sul, o preço é exibido em USD, pois o preço em ZAR não foi especificado a um dos itens.

O projeto possui preços nas seguintes moedas:

• o preço padrão para o 1_test_item está em dólares americanos (USD)
• o preço padrão para o item 2_test_item está em euro (EUR)
• na África do Sul, o preço para 1_test_item é atribuído em rand sul-africano (ZAR), para 2_test_item ele não é especificado

Nesse caso, o preço deve ser exibido na moeda padrão do primeiro item do catálogo para os usuários da África do Sul — 1_test_item.

A moeda padrão para 1_test_item — USD. Não corresponde à moeda padrão de 2_test_item — EUR. Além disso, não há preço em USD na lista de preços para ele.

Portanto, o valor retornado para 2_test_item será null.

Quem pode usar

Parceiros que querem incrementar as vendas em países com baixo poder de compra ao definir a política de preços da loja para usuários de diferentes países.

Como obtê-lo

Você pode adicionar, editar e excluir preços regionais:

• através da Conta do Publicador ao criar/editar um item
• através da Conta do Publicador ao importar preços via arquivo
• usando métodos de API

Configurando via Conta do Publicador ao criar e editar itens:

1. Abra o projeto na Conta do Publicador.
2. Clique em Loja no menu lateral.
3. No painel Itens Virtuais , clique em Configurar.
4. Clique em + e selecione Criar item na lista suspensa.

5. Especifique:
   • imagem
   • SKU
   • um ou vários grupos ao qual o item deve pertencer
   • nome
   • descrição
   • propriedade do item — itens consumíveis, não consumíveis ou de tempo limitado
6. No bloco Configurações de preço, escolha Item pago.
7. Alterne o Preço na moeda real para Ativo e especifique o preço. Se você não definir preços regionais, o preço de um item será o mesmo para todos os países e em dólares americanos.

8. Configurar preços:
   • Se você quiser configurar o preço de um item em diferentes moedas, clique em + para especificar a moeda e o preço.
   • Se você quer definir preços especiais para países, clique em Adicionar preço e especifique o país, moeda e quantidade. Você pode definir a quantidade de preços regionais necessário.
9. Se você quer adicionar o preço na moeda virtual, alterne para Preço na moeda virtual para Ativo e especifique o preço.
10. Se quiser limitar a disponibilidade de itens para usuários específicos, alterne para Limitar número de vezes um usuário pode comprar este item para Ativo e especifique o número.
11. Se quiser exibir um item na loja, alterne para Exibir item na loja para Ativo.
12. Clique Criar item.

Importar do arquivo na Conta de Publicador

Você pode importar preços regionais de um arquivo para itens pré-criados.

Recursos:

• Ação única para carregar ou atualizar preços regionais para vários itens.
• Compatível com itens de todos os tipos:
  • itens virtuais
  • moeda virtual
  • pacotes de moeda virtual
  • pacotes de chaves de jogo
  • em uma plataforma específica

• Validação dos dados carregados. Se a estrutura do arquivo ou o formato de dados não atender aos requisitos, será exibida uma lista de erros durante a importação.

• SKU — o SKU do item para a qual os preços regionais devem ser definidos.
• Country — o código do país no formato ISO 3166-1 alpha-2. Confira a lista de países suportados pela Xsolla antes de enviar o arquivo CSV. O preenchimento das células na coluna é opcional. Você pode ver exemplos de exibição de preço se o país não for especificado.
• Currency — o código da moeda no formato ISO 4217.
• Amount — o preço do item. Use um ponto como separador decimal.

• IsDefault — se é o preço padrão. Especifique:

  • 1 — na linha com o preço padrão. É exibido em todos os países sem preços regionais.
  • 0 — em todas as outras linhas. Você também pode deixar a célula na coluna isDefault vazia.

1. O preço padrão não deve ser regional - deixe a célula na coluna Country vazia.
   Se houver múltiplos SKUs de itens no arquivo, um preço na moeda padrão deverá ser definido para cada SKU. Caso não seja especificado, será exibido um erro ao importar o arquivo.

Exemplo de um arquivo de preços:

1. Abra seu projeto na Conta do Publicador.
2. Clique em Loja no menu lateral e vá para a seção com qualquer tipo de produto.
3. Clique em Importar preços.

4. Na janela Importar, baixe o modelo de arquivo e adicione os valores.
5. Carregue o arquivo para o campo correspondente na janela Importar.
6. Se ocorrer qualquer erro durante a importação, a janela Importar exibe uma lista dos erros e as recomendações para correção. Faça as alterações necessárias ao arquivo e carregue novamente.

Após um envio bem-sucedido, os preços regionais dos itens com os SKUs especificados será atualizado de acordo com os preços no arquivo. Os preços especificados anteriormente serão excluídos.

Exemplo:

Há diversos preços em moedas diferentes e diversos preços regionais para o item na Conta de Distribuidor. No arquivo importado, há apenas um preço em EUR. Depois de importar o arquivo, apenas um preço em EUR será especificado para esse item na Conta de Distribuidor.

Configuração usando métodos de API

• nos métodos para criar e atualizar itens virtuais
• nos métodos para criar e atualizar a moeda virtual
• nos métodos para criar e atualizar pacotes de moeda virtual
• nos métodos para criar e atualizar pacotes

• nos métodos para criar e atualizar pacotes de chaves de jogo

"prices": [
      {
        "amount": 100,
        "currency": "USD",
        "is_enabled": true,
        "is_default": true
      },
      {
        "amount": 200,
        "currency": "CZK",
        "country_iso": "CZ",
        "is_enabled": false,
        "is_default": false
      }
    ]