Venda via link direto
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:
- campanhas promocionais (por exemplo, Códigos Promocionais)
- Autenticação do Usuário
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
- O usuário acessa o link.
- A Xsolla exibe a página do pedido.
- O usuário fornece os dados que não foram passados no link:
- Seleciona uma plataforma para a qual há chaves disponíveis.
- Informa um Código Promocional (opcional).
- 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.
- A página exibe o endereço informado novamente. O usuário o confirma ou pressiona em Change e corrige.

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.
- A Xsolla reserva uma chave para a plataforma selecionada e abre a interface de pagamento.
- O usuário paga a compra.
- 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.

Formato do link e parâmetros
Um link para vender chaves de jogo tem o seguinte formato:
- http
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âmetro | Descrição |
|---|---|
type | Tipo de Item. Obrigatório. Valores possíveis:
|
project_id | ID do projeto, que você pode encontrar:
Obrigatório. |
sku | SKU do pacote de chaves de jogo. Obrigatório. Exemplos:
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 |
xsolla_login_token | Token de autenticação do usuário (JWT) obtido via Xsolla Login. Para detalhes, consulte Venda para usuários autenticados. |
access_data | Objeto JSON codificado em Base64 com dados do usuário e configurações de pagamento. Para mais detalhes, consulte Venda para usuários autenticados. |
auth | Token de autenticação do usuário obtido via Pay Station. Para mais detalhes, consulte Venda para usuários autenticados. |
ui_settings | Objeto JSON codificado em Base64 com as configurações do tema da interface. Para mais detalhes, consulte Personalização da interface. |
mode | Passe o valor sandbox para fazer pagamentos de teste. Para detalhes, consulte Teste de pagamentos. |
| Parâmetro | Descrição |
|---|---|
type | Tipo de Item. Obrigatório. Valores possíveis:
|
project_id | ID do projeto, que você pode encontrar:
Obrigatório. |
sku | SKU do pacote de chaves de jogo. Obrigatório. Exemplos:
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 |
xsolla_login_token | Token de autenticação do usuário (JWT) obtido via Xsolla Login. Para detalhes, consulte Venda para usuários autenticados. |
access_data | Objeto JSON codificado em Base64 com dados do usuário e configurações de pagamento. Para mais detalhes, consulte Venda para usuários autenticados. |
auth | Token de autenticação do usuário obtido via Pay Station. Para mais detalhes, consulte Venda para usuários autenticados. |
ui_settings | Objeto JSON codificado em Base64 com as configurações do tema da interface. Para mais detalhes, consulte Personalização da interface. |
mode | Passe 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,
_steamou_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:
| Nome | Exemplo 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 |
URL de exemplo para vender um jogo no Steam:
- http
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:
- http
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
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 objetosuseresettings).
Exemplo de JSON para
- json
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:
- http
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:
- http
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&mode=sandbox
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.