Personalize a interface de pagamento

Como funciona

Há dois temas padrão disponíveis para a interface de pagamento: claro e escuro. Para alternar entre eles sem usar o personalizador, passe o ID do tema no parâmetro settings.ui.theme ao obter o token:

  • para o tema claro (padrão) — 6a54b1b3c01b9c25e567a065
  • para o tema escuro — 6a54b174c01b9c25e5679fa2

Para adequar a interface de pagamento ao design do jogo, você pode criar um tema personalizado e configurar as seguintes características:

Você pode usar um tema personalizado como o tema padrão para todos os seus projetos na Conta de Distribuidor. Se quiser especificar temas diferentes para jogos individuais, passe essas configurações no token.

Aviso
As configurações de tema passadas no token têm prioridade sobre as configurações especificadas na Conta de Distribuidor.

Para adequar a interface de pagamento ao design do jogo, você pode criar um tema personalizado e configurar as seguintes características:

Você pode usar um tema personalizado como tema padrão para todos os seus projetos na conta. Se quiser especificar temas diferentes para jogos individuais, passe essas configurações no token.

Aviso
As configurações de tema passadas no token têm prioridade sobre as configurações especificadas na conta.
Observação
Para que o logotipo da Xsolla e os botões sejam exibidos corretamente ao escolher um método de pagamento, consulte as diretrizes.

Configurar personalização na Conta de Distribuidor

Observação
Você pode criar um tema personalizado em um projeto e usá-lo em todos os seus projetos nesta Conta de Distribuidor.

Para criar um tema personalizado:

  1. Abra seu projeto na Conta de Distribuidor e acesse a seção Payments > Payment interface > Pay Station customization.

Configurar personalização na conta

Observação
Você pode criar um tema personalizado em um projeto e usá-lo em todos os seus projetos nesta conta.

Para criar um tema personalizado:

  1. Abra seu projeto na conta e acesse a seção Payments > Payment interface > Pay Station customization.

Configurar personalização na conta

Observação
Você pode criar um tema personalizado em um projeto e usá-lo em todos os seus projetos nesta conta.

Para criar um tema personalizado:

  1. Abra seu projeto na conta e acesse a seção Payments > Payment interface > Pay Station customization.

Configurar personalização na conta

Observação
Você pode criar um tema personalizado em um projeto e usá-lo em todos os seus projetos nesta conta.

Para criar um tema personalizado:

  1. Abra seu projeto na conta e acesse a seção Payments > Payment interface > Pay Station customization.

Configurar personalização na conta

Observação
Você pode criar um tema personalizado em um projeto e usá-lo em todos os seus projetos nesta conta.

Para criar um tema personalizado:

  1. Abra seu projeto na conta e acesse a seção Payments > Payment interface > Pay Station customization.
  1. Selecione Create new theme.
  1. Pressione o ícone de lápis para alterar o nome do tema.
  1. Na lista suspensa Preset, você pode selecionar um tema base. Se você tiver feito alterações e não tiver publicado o tema, elas serão perdidas ao alternar entre presets.
  1. Para alterar as cores dos elementos da interface, acesse a aba Colors. Você pode alterar a paleta de cores de superfícies, textos e controles, bem como as cores que aparecem nas notificações de status.
Observação

Ao alterar as cores do tema, o contraste é verificado automaticamente. Se o contraste estiver baixo, você verá uma notificação com o botão Check. Pressione-o para acesse a seção Components, onde todos os elementos da interface são exibidos. Revise a aparência e altere as cores dos elementos com contraste insuficiente.

  1. Para definir a fonte e seu tamanho, acesse a aba Typography.

Use os campos correspondentes para alterar o tamanho da fonte dos seguintes elementos da interface:

CampoElemento da interface
Title 1Cabeçalho na página de status do pagamento.
Title 2Valor do total.
Title 3Títulos de seção (por exemplo, Payment via card).
Body L
  • títulos de subseção
  • títulos nas instruções para pagamentos em dinheiro
  • texto do botão
  • texto do total
Body M
  • nome do projeto (exibido quando não há logotipo do projeto)
  • texto em dicas de ferramenta e descrições
  • mensagem na página de status do pagamento
  • texto na lista de métodos de pagamento (a lista suspensa na versão móvel)
Minor text
  • nome do usuário
  • textos legais
  • informações no carrinho (por exemplo, nome de um item, valor do IVA)
  1. Para configurar a largura da borda e o raio do canto dos elementos da interface, acesse a aba Borders e faça as alterações.

  2. Para ver como o logotipo do jogo aparece na interface de pagamento, na seção Preview, marque a caixa Show logo. Para configurar a exibição de um logotipo de jogo na interface de pagamento, passe os parâmetros necessários no token.

  1. Para ver como um tema aparece nas versões móvel e desktop da interface de pagamento, alterne entre as abas na seção Preview.
Aviso
Os botões e os links não funcionam no modo de visualização.
  1. Para ver diferentes estados da interface de pagamento, alterne entre as abas Payment by card, Payment methods, Payment status: successful e Payment status: failed.
  1. Para alterar a imagem na página de status do pagamento, acesse a aba Payment status: successful ou Payment status: failed, pressione Upload e selecione o arquivo necessário no seu dispositivo.
Observação

Tamanho máximo do arquivo: 5 MB.

Formatos suportados: JPG/JPEG, PNG, GIF, APNG.

Observação

Imagens da Xsolla são usadas para os status de pagamento por padrão.

Exemplo:

  1. Selecione Publish.
  1. Para aplicar este tema a todos os seus projetos na Conta de Distribuidor, ative a opção Set as default na janela modal que abrir. Isso não afetará projetos em que o tema é passado no token.
  1. Para aplicar este tema a todos os seus projetos na conta, ative a opção Set as default na janela modal que abrir. Isso não afetará projetos em que o tema é passado no token.
  1. Para aplicar este tema a todos os seus projetos na conta, ative a opção Set as default na janela modal que abrir. Isso não afetará projetos em que o tema é passado no token.
  1. Para aplicar este tema a todos os seus projetos na conta, ative a opção Set as default na janela modal que abrir. Isso não afetará projetos em que o tema é passado no token.
  1. Para aplicar este tema a todos os seus projetos na conta, ative a opção Set as default na janela modal que abrir. Isso não afetará projetos em que o tema é passado no token.
  1. Selecione Publish.
Aviso
Depois que o tema for publicado, você poderá editá-lo a qualquer momento. O tema não é aplicado à interface de pagamento, a menos que você o defina como tema padrão ou o habilite usando as configurações do token.

Na aba UI theme, ao pressionar em ••• no bloco de um tema específico, as seguintes ações rápidas ficam disponíveis:

  • Personalizar — abre o personalizador para fazer alterações.
  • Editar — altera o nome do tema e permite ativar a opção Set as default.
  • Duplicar — copia um tema para criar outro com base nele.
  • Excluir tema.

Configurar personalização via API

Configurar a exibição dos métodos de pagamento

Para configurar como os métodos de pagamento são exibidos ao abrir a interface de pagamento, você pode passar os seguintes parâmetros no token:

  • is_payment_methods_list_mode permite exibir a lista de métodos de pagamento disponíveis no país do usuário ao abrir a interface de pagamento.
  • settings.ui.gp_quick_payment_button permite configurar a exibição do método de pagamento Google Pay na interface de pagamento. Esse parâmetro pode ter os seguintes valores:

    • true — neste caso, o botão de pagamento rápido via Google Pay é exibido no topo da interface de pagamento, independentemente do dispositivo e do navegador do usuário.
Observação
Se o parâmetro não for passado, o Google Pay é exibido no topo da interface de pagamento em quaisquer dispositivos e navegadores do usuário, exceto no Safari. No Safari, ele é exibido na lista de métodos de pagamento.
    • false — nesse caso, o Google Pay é exibido na lista de métodos de pagamento de acordo com o algoritmo PayRank.
  • settings.​ui.​alternative_first_screen permite configurar uma visualização alternativa da tela da interface de pagamento ao abrir. Esse parâmetro pode ter os seguintes valores:

    • apple-pay — nesse caso, o usuário vê o botão Apple Pay como a opção principal de pagamento juntamente com um link para a lista de outros métodos de pagamento. Essa lógica não se aplica a dispositivos Android.
    • compact_list — nesse caso, o usuário vê o botão All methods junto dos principais métodos de pagamento. Ao pressionar ele, o usuário vê uma lista em grade de todos os métodos de pagamento disponíveis. Se houver menos de 4 métodos disponíveis, o botão fica oculto.

Passar configurações personalizadas do tema da interface no token

Para aplicar configurações personalizadas a um jogo específico, passe o ID do tema personalizado publicado no parâmetro settings.ui.theme ao criar o token.

Você encontra o ID do tema:

  • Na lista de todos os temas na aba UI theme.
  • No personalizador, abaixo do nome do tema.
Aviso
As configurações de tema passadas no token têm prioridade sobre as configurações especificadas na Conta de Distribuidor.
Aviso
As configurações de tema passadas no token têm prioridade sobre as configurações especificadas na conta.

Para exibir o logotipo do seu jogo na interface de pagamento:

  1. Abra seu projeto na Conta de Distribuidor e envie uma imagem na seção Payments > Payment interface > General settings.

Para exibir o logotipo do seu jogo na interface de pagamento:

  1. Abra seu projeto na conta e envie uma imagem na seção Payments > Payment interface > General settings.

Para exibir o logotipo do seu jogo na interface de pagamento:

  1. Abra seu projeto na conta e envie uma imagem na seção Payments > Payment interface > General settings.

Para exibir o logotipo do seu jogo na interface de pagamento:

  1. Abra seu projeto na conta e envie uma imagem na seção Payments > Payment interface > General settings.

Para exibir o logotipo do seu jogo na interface de pagamento:

  1. Abra seu projeto na conta e envie uma imagem na seção Payments > Payment interface > General settings.
Observação
Tamanho máximo do arquivo: 1 MB.
Formatos suportados: JPEG, PNG, SVG.

  1. Na solicitação de criação do token, passe true nos parâmetros settings.ui.desktop.header.is_visible e settings.ui.desktop.header.visible_logo. Dependendo do seu cenário de integração, você pode chamar o método do lado do servidor ou do lado do cliente para criar um token.

Exemplo de exibição do logotipo do jogo na interface de pagamento:

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].