Venda via link direto

Observação

Antes de configurar a venda por link direto, crie pacotes de chaves de jogo na sua conta.

Além disso, você pode configurar o seguinte no seu projeto:

Um link direto permite vender chaves de jogo em qualquer lugar onde seja possível abrir uma página da web ou um navegador dentro do aplicativo, por exemplo, no site do jogo, em redes sociais, em um inicializador, em boletins informativos ou em posts de criadores de conteúdo.

O link abre a página de pedido da Xsolla. Nela, o usuário realiza todo o fluxo de compra: faz o pedido e efetua o pagamento. Você não precisa desenvolver sua própria interface para isso.

Esse formato é adequado nos seguintes casos:

  • Você precisa lançar rapidamente vendas do jogo ou pré-vendas em diferentes canais. Basta colocar o link no seu site, em redes sociais ou em um boletim informativo.
  • Você precisa reduzir o número de solicitações ao suporte causadas por e-mails incorretos ou plataformas incompatíveis. O usuário informa qualquer dado ausente na página do pedido e, se você vender chaves para várias plataformas, pode predefinir a plataforma no SKU (consulte Formato do link e parâmetros).

Fluxo do usuário

  1. O usuário acessa o link.
  2. A Xsolla exibe a página do pedido.
  3. O usuário fornece os dados que não foram passados no link:
    1. Seleciona uma plataforma para a qual há chaves disponíveis.
    2. Informa um Código Promocional (opcional).
    3. Informa o endereço de e-mail para o qual serão enviados o recibo, a chave do jogo e as instruções de ativação, e pressiona o botão Continue.
  1. A página exibe o endereço informado novamente. O usuário o confirma ou pressiona em Change e corrige.
Observação

O conjunto de etapas para fazer um pedido pode variar:

  • A seleção de plataforma fica disponível se o SKU do pacote de chaves de jogo for passado sem uma plataforma.
  • A inserção de códigos promocionais fica disponível apenas se houver um código ativo para o pacote de chaves de jogo ou conjunto.
  • Para usuários autenticados, o endereço de e-mail é preenchido automaticamente no formulário do pedido a partir dos dados do usuário.
  1. A Xsolla reserva uma chave para a plataforma selecionada e abre a interface de pagamento.
  2. O usuário paga a compra.
  3. Após o pagamento ser concluído, a Xsolla envia um e-mail com o recibo, a chave do jogo e as instruções de ativação para o endereço de e-mail confirmado.

Um link para vender chaves de jogo tem o seguinte formato:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}

Lista de parâmetros de consulta:

ParâmetroDescrição
type

Tipo de Item. Obrigatório.

Valores possíveis:

project_id

ID do projeto, que você pode encontrar:

  • Ao lado do nome do projeto quando você o seleciona no cabeçalho da Conta de Distribuidor.
  • No URL de qualquer página da Conta de Distribuidor. O URL tem o seguinte formato: https://publisher.xsolla.com/<merchant_id>/projects/<project_id>/.

Obrigatório.

sku

SKU do pacote de chaves de jogo. Obrigatório.

Exemplos:

  • game456 — um SKU sem uma plataforma específica.
  • game456_steam — um SKU com uma plataforma específica. Para a lista de plataformas suportadas pela Xsolla e exemplos de sufixos, consulte a tabela abaixo.

Para garantir que o link funcione corretamente, você pode verificar o valor do SKU usando a chamada de API Get games list. O SKU do Item é retornado no parâmetro items.unit_items.sku (geralmente esse SKU tem o formato game_key_sku_drm_sku).

xsolla_login_tokenToken de autenticação do usuário (JWT) obtido via Xsolla Login. Para detalhes, consulte Venda para usuários autenticados.
access_dataObjeto JSON codificado em Base64 com dados do usuário e configurações de pagamento. Para mais detalhes, consulte Venda para usuários autenticados.
authToken de autenticação do usuário obtido via Pay Station. Para mais detalhes, consulte Venda para usuários autenticados.
ui_settingsObjeto JSON codificado em Base64 com as configurações do tema da interface. Para mais detalhes, consulte Personalização da interface.
modePasse o valor sandbox para fazer pagamentos de teste. Para detalhes, consulte Teste de pagamentos.
ParâmetroDescrição
type

Tipo de Item. Obrigatório.

Valores possíveis:

project_id

ID do projeto, que você pode encontrar:

  • Ao lado do nome do projeto quando você clica nele no cabeçalho da conta.
  • No URL de qualquer página da conta. O URL tem o seguinte formato: https://xsolla.com/for/<business-account-type>/account/<merchant_id>/projects/<project_id>/.

Obrigatório.

sku

SKU do pacote de chaves de jogo. Obrigatório.

Exemplos:

  • game456 — um SKU sem uma plataforma específica.
  • game456_steam — um SKU com uma plataforma específica. Para a lista de plataformas suportadas pela Xsolla e exemplos de sufixos, consulte a tabela abaixo.

Para garantir que o link funcione corretamente, você pode verificar o valor do SKU usando a chamada de API Get games list. O SKU do Item é retornado no parâmetro items.unit_items.sku (geralmente esse SKU tem o formato game_key_sku_drm_sku).

xsolla_login_tokenToken de autenticação do usuário (JWT) obtido via Xsolla Login. Para detalhes, consulte Venda para usuários autenticados.
access_dataObjeto JSON codificado em Base64 com dados do usuário e configurações de pagamento. Para mais detalhes, consulte Venda para usuários autenticados.
authToken de autenticação do usuário obtido via Pay Station. Para mais detalhes, consulte Venda para usuários autenticados.
ui_settingsObjeto JSON codificado em Base64 com as configurações do tema da interface. Para mais detalhes, consulte Personalização da interface.
modePasse o valor sandbox para fazer pagamentos de teste. Para detalhes, consulte Teste de pagamentos.

Para vender pacote de chaves de jogo para uma plataforma específica, passe o SKU do pacote com um sufixo de plataforma no parâmetro de consulta sku. O sufixo é adicionado automaticamente ou manualmente, dependendo de onde você cria o pacote:

  • Se você criar pacotes de chaves do jogo na sua conta, o sufixo de uma plataforma específica, por exemplo, _steam ou _playstation, é adicionado automaticamente ao SKU que você informou manualmente, separado por um sublinhado.
  • Se você criar pacotes de chaves do jogo específicos a uma plataforma por meio de chamadas de API, você poderá especificar o sufixo da plataforma em qualquer formato usando apenas letras latinas minúsculas e maiúsculas, dígitos, pontos, hifens e sublinhados.

Lista de plataformas suportadas pela Xsolla e exemplos de sufixos:

NomeExemplo de sufixo de SKU
Steam_steam
PlayStation_playstation
Xbox_xbox
Uplay_uplay
Origin_origin
Sem DRM_drmfree
GOG_gog
Epic Games_epicgames
Nintendo Switch eShop_nintendo_eshop
Discord Game Store_discord_game_store
Oculus_oculus
Viveport_viveport
Google Stadia_stadia
MY.GAMES Store_my_game

Observação
Se você passar no link o SKU de um pacote de chaves de jogo com uma plataforma específica, o usuário não poderá alterar a plataforma na página do pedido.

URL de exemplo para vender um jogo no Steam:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type=game_key&project_id=123456&sku=game456_steam

Personalização da interface

Para que a interface da página do pedido corresponda ao estilo do seu jogo, configure o tema, o tamanho e outros parâmetros seguindo as instruções de personalização. Adicione o parâmetro ui_settings ao link e passe nele o objeto JSON settings.ui, codificado em Base64.

Exemplo de URL para abrir a página do pedido com um tema personalizado:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&ui_settings=ewoJCQkic2l6ZSI6ICJzbWFsbCIsCgkJCSJ0aGVtZSI6ICJkYXJrIgoJCX0=

Venda para usuários autenticados

Observação

A autenticação não é obrigatória para vender chaves de jogo por link direto. A chave é enviada para o endereço de e-mail que o usuário informa ao fazer a compra. A autenticação do usuário é obrigatória se você quiser limitar o número de chaves por usuário, usar o sistema de direitos ou armazenar dados do usuário na interface de pagamento da Xsolla.

Uma etapa adicional de autenticação pode reduzir a taxa de conversão da compra.

Para vender chaves do jogo a usuários autenticados, adicione um dos seguintes parâmetros ao link:

  • xsolla_login_token — um JWT obtido via Xsolla Login. Use este parâmetro se você autenticar usuários via Xsolla Login. Para obter o token, autentique o usuário pela API Login, por exemplo, usando a chamada Auth by username and password.
  • auth — um token obtido via Pay Station. Use este parâmetro se você tiver seu próprio sistema de autenticação. Para obter o token, envie a solicitação Create token a partir do seu servidor. Para mais detalhes, consulte Como obter um token para abrir a interface de pagamento.
  • access_data — um objeto JSON codificado em Base64 com dados do usuário e configurações de pagamento. Use este parâmetro se você tiver seu próprio sistema de autenticação ou precisar passar o endereço de e-mail e o país. A estrutura do objeto corresponde ao corpo da solicitação da chamada Create token (os objetos user e settings).

Exemplo de JSON para access_data antes da codificação:

Copy
Full screen
Small screen
 1{
 2  "user": {
 3    "id": {
 4      "value": "USER_ID"
 5    },
 6    "email": {
 7      "value": "[email protected]"
 8    },
 9    "country": {
10      "value": "US"
11    }
12  },
13  "settings": {
14    "language": "en",
15    "currency": "USD"
16  }
17}

Codifique o objeto JSON em Base64 e passe o resultado no parâmetro access_data do link.

Para mais informações sobre métodos de autenticação e geração de tokens de autenticação, consulte Como configurar a autenticação para vender chaves de jogo.

Exemplo de URL para abrir a página do pedido com um token de autenticação:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&xsolla_login_token={ACCESS_TOKEN}

Teste de pagamentos

Para testar pagamentos no modo sandbox, adicione o parâmetro mode=sandbox ao link. Você pode usar cartões de teste para concluir as transações.

Exemplo de URL para abrir a página do pedido no modo sandbox:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&mode=sandbox
Aviso
Ao comprar no modo sandbox, as chaves enviadas não são usadas. O sistema simula uma compra bem-sucedida sem entregar chaves reais.
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 Novembro 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 [email protected].