Dúvidas gerais

Configurações do projeto

Preciso criar novos projetos para cada ambiente (QA, staging, produção)?

Para testes, recomendamos que você use projetos separados para evitar afetar o ambiente de produção.

Eu sou um desenvolvedor de jogos para dispositivos móveis. O que devo especificar como o site nas configurações do projeto?

Especifique o URL do site do jogo ou o URL do site da sua empresa.

Como posso convidar membros da minha empresa para conceder o acesso à minha Conta de Distribuidor a eles?

Na sua Conta de Distribuidor, vá para Company settings > Users e clique em Invite new user.

Onde posso encontrar o ID do projeto?

Abra seu projeto na Conta de Distribuidor e vá para as configurações do Project settings > General settings.

Onde posso encontrar o ID do comerciante?

Abra a Conta de Distribuidor e vá para as configurações da Company settings > Company.

Observação
O ID do comerciante é o mesmo que o ID do distribuidor.

Qual é a diferença entre uma chave secreta, chave de projeto e chave de API?

Uma chave secreta e uma chave de projeto são as mesmas. Ele é usado para a assinatura digital que é necessária ao processar pagamentos seguros. O corpo JSON da solicitação é concatenado com essa chave e, em seguida, o resultado é hashed com SHA-1.

A chave de API é usada para chamadas de API enviadas ao servidor Xsolla. Essa chave deve ser mantida em seu próprio servidor e nunca dentro de arquivos binários ou frontend. Para obter mais informações sobre como trabalhar com chaves de API, consulte a referência de API.

Qual é a diferença entre um URL de webhook e um URL de retorno?

Um URL de webhook é o endereço URL do seu servidor webhook para onde as notificações são enviadas. Um URL de retorno é o endereço URL para o qual um usuário é redirecionado após concluir um pagamento.

Onde posso encontrar a chave de API?

A API key é mostrada na Conta de Distribuidor apenas uma vez, durante a criação, e deve ser armazenada por você. Você pode criar uma nova chave na seguinte seção:

Aviso

Para obter mais informações sobre como trabalhar com chaves de API, consulte a Referência de API.

Principais recomendações:

  • Salve a chave de API gerada cuidadosamente. Você pode visualizar a chave de API na Conta de Distribuidor apenas uma vez, durante sua criação.
  • Mantenha sua chave de API em segredo. Ela fornece acesso à sua conta pessoal e aos seus projetos na Conta de Distribuidor.
  • A chave de API deve ser armazenada em seu servidor, e jamais em arquivos binários ou no frontend.

Se uma chamada de API que você precisa não contiver o trajeto-parâmetro project_id, use a chave de API que for válida em todos os projetos da empresa para configurar a autorização.

API e webhooks

Quais APIs Xsolla estão disponíveis?

Você pode usar a seguinte API:

Como começar a trabalhar com a Xsolla API?

Consulte as informações introdutórias.

Onde posso encontrar informações sobre como trabalhar com webhooks?

Na documentação do webhook.

Quais endereços IP da rede Xsolla preciso adicionar à lista de permissões para configurar webhooks?

Consulte a documentação de webhooks para ver a lista de endereços IP pelos quais os webhooks são enviados.

Preciso usar HTTPS para um protocolo webhook?

Sim.

Por que a notificação Xsolla não foi enviada para o URL do webhook?

Certifique-se de que o servidor webhook suporta os tipos necessários de solicitações HTTP (POST, GET).

Por que os webhooks não são enviados para meu aplicativo móvel?

Os webhooks são enviados para apenas um único endereço URL especificado nas configurações do projeto. Sendo servidor para servidor, os webhooks não podem ser enviados para vários endereços URL. Se você gostaria de receber notificações em seu jogo, site ou aplicativo móvel, configure o envio de webhooks em seu servidor para passar dados entre a Xsolla e seu jogo.

Por que o cabeçalho Authorization está ausente da solicitação webhook?

Para corrigir esse erro, você precisa editar os arquivos Apache .htaccess ou httpd.conf. Consulte a documentação do SDK para obter mais informações.

SDKs

Quais SDKs Xsolla estão disponíveis?

A Xsolla suporta os seguintes SDKs:

Onde posso encontrar informações detalhadas sobre cada SDK?

Vá para a documentação SDK e escolha a seção correspondente.

Existe SDK para Node.JS/C#/Ruby/Java/ASP, etc.?

Atualmente existem SDKs para PHP e Android. Você pode criar seu próprio SDK usando qualquer linguagem/plataforma, desde que tenha funcionalidade de solicitação HTTPS.

Notificações automáticas sobre mudanças importantes nas configurações da Conta de Distribuidor

A Xsolla notifica você sobre mudanças nas configurações do seu projeto que podem impactar no processamento ou operação dos seus sistemas. As notificações por e-mail são enviadas aos usuários com a função Owner especificada na Conta de Distribuidor na seção Company settings > Users. As notificações são enviadas com um atraso de até 1 minuto.

Aviso
Esse recurso está disponível por padrão. Não é possível remover a assinatura destes e-mails ou modificar o conteúdo deles.
Você recebe notificações sobre os seguintes eventos:
Seção da Conta de DistribuidorEventos de notificação
Company settings
  • A chave API foi criada.
  • A chave API está desativada.
Project settings
  • URL de webhook alterado.
  • Chave secreta de webhook alterada.
StoreAlterações nas configurações das chaves de jogo, moedas virtuais e itens virtuais:
  • Sku alterado.
  • Um item foi excluído.
  • O preço foi reduzido em mais de 50%.
  • Alterações de status de Partially available e Available para Unavailable.
  • Alterações de status de Available para Partially available.

Registro de atividades de usuário

O registro de atividades de usuário exibe as principais ações tomadas pelos usuários da sua empresa relacionados à operação dos principais serviços da Xsolla. O registro captura solicitações HTTP à API que são enviadas diretamente ou acionadas pela interface da Conta de Distribuidor.

Você pode ver o registro de atividades de usuário na Conta de Distribuidor na seção Company settings > Activity.

Aviso

Esta seção está disponível aos usuários da Conta de Distribuidor que cumprirem os seguintes critérios:

  • Ter a função Proprietário.
  • Se o acesso estiver restringido por projeto, o usuário deve ter acesso a todos os projetos.

Recursos principais:

  • Filtrar dados por período e o endereço de e-mail do usuário que iniciou a solicitação API.
  • Exporte o registro de atividades de usuário como um arquivo CSV com base no filtro aplicado.
Observação
Dependendo da quantidade de registros que correspondem ao filtro, a exportação pode demorar. O resultado será enviado ao seu endereço de e-mail especificado na Conta de Distribuidor como um arquivo protegido por senha. A senha será incluída no e-mail de exportação.
Limitações:
  • O registro inclui dados dos últimos 2 anos. Para solicitar dados mais antigos do que 2 anos, contate seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com.
  • Dados só podem ser exportados por um período de até 1 ano. Para exportar dados de uma faixa maior, divida-a em segmentos de menos de um ano e exporte cada segmento separadamente.
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: 21 de Novembro 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.