Pagamentos com um clique

Como funciona

O pagamento com um clique permite que os usuários paguem com métodos de pagamento familiares e nativos seguros, como o Apple Pay e Google Pay, nos dispositivos suportados. Esses sistemas de pagamentos empregam mecanismos de segurança adicionais para impedir transações não autorizadas. Para garantir um processo de pagamento rápido e fluído, podem ser necessárias configurações adicionais do seu lado.

Fluxo do usuário ao pagar com um clique:

  1. O usuário acessa a interface de pagamento para fazer uma compra.
  2. O usuário clica em um botão para pagar com um dos métodos nativos.
  3. O usuário é redirecionado à carteira eletrônica e seleciona um cartão para pagamento.
  4. O usuário passa o procedimento de autenticação com a biometria no dispositivo.
  5. O usuário retorna à interface de pagamento que exibe o status bem-sucedido do pagamento.

Apple Pay

Para adicionar uma opção de pagamento com um clique via Apple Pay à interface de pagamento:

  1. Crie uma solicitação para habilitar essa opção. Para fazer isso:

    a. Abra sua Conta de Distribuidor e vá para a seção Support Hub.

    b. Clique em Submit request.

    c. Na janela que surgir, preencha os seguintes campos:

    • Summary. Por exemplo, Configuração de pagamento com um clique.
    • Description. Especifique o domínio utilizado para abrir a interface de pagamento, como amazing.store.com, e indique uma opção de pagamento com um clique: via Apple Pay ou tanto Apple Pay quanto Google Pay.
    • Project ID. Selecione um ID de projeto na lista suspensa. Se você quiser configurar a opção de pagamento com um clique para múltiplos projetos, especifique os IDs deles no campo Description.

    d. Clique em Send.

  2. Espere pelo arquivo de associação do domínio. Essa etapa é realizada pela Xsolla:
    1. A Xsolla cadastra seu domínio com a Apple.
    2. A Xsolla recebe o arquivo de associação do domínio da Apple.
    3. A Xsolla envia um e-mail a você com o arquivo de associação do domínio e fornece instruções sobre aonde deve enviá-lo.
  3. Dependendo da maneira que você abrir a interface de pagamento, conclua as seguintes configurações adicionais descritas na tabela abaixo:
  4. Responda ao e-mail da Xsolla e confirme que você enviou o arquivo de associação do domínio ao local especificado.
  5. Espere pela confirmação da Xsolla a respeito da verificação bem-sucedida do seu domínio com a Apple.
Aviso
Se seu site foi criado usando o Xsolla Site Builder ou Web Shop, você precisará republicá-lo para habilitar o pagamento com um clique.

Configurações adicionais para abrir a interface de pagamento

Opção de abertura da interface de pagamentoConfigurações adicionais
Nova janelaNenhuma configuração adicional necessária.
IframePasse seu domínio no parâmetro de pesquisa parent_domain, como parent_domain=amazing.store.com, e adicione o atributo allow=”payment”.
Script Pay Station EmbedAtualize o script à versão 1.5.0. ou além e passe seu domínio no parâmetro de pesquisa parent_domain, como parent_domain=amazing.store.com.
O script da versão 1.5.0. suporta o atributo allow=”payment” por padrão.
Exemplo da interface de pagamento abrindo no iframe:
Copy
Full screen
Small screen
<iframe src="https://secure.xsolla.com/paystation4/?token=token_body&parent_domain=amazing.store.com" allow="payment""></iframe>

Exemplo da interface de pagamento abrindo com o script Pay Station Embed:

Copy
Full screen
Small screen
<script>
        const options = {
            access_token: 'PAYMENT_TOKEN',
            lightbox: {
                width: '800px',
                height: '700px',
            },
            queryParams: {
                parent_domain: 'amazing.store.com'
            }
        };
        const s = document.createElement('script');
        s.type = "text/javascript";
        s.async = true;
        s.src = "https://cdn.xsolla.net/payments-bucket-prod/embed/1.5.0/widget.min.js";
        s.addEventListener('load', function (e) {
            XPayStationWidget.init(options);
        }, false);

        const head = document.getElementsByTagName('head')[0];
        head.appendChild(s);
</script>

Limitações:

  • Se você passar o parâmetro settings.ui.is_independent_windows na solicitação do token para abrir a interface de pagamento em uma nova aba de um navegador externo, você não poderá ativar o pagamento com um clique via Apple Pay. Porém, independentemente de esse parâmetro ser passado, você pode aceitar pagamentos via Apple Pay abrindo-o em uma nova aba.
  • Se você usar o SDK, garanta o uso da versão mais nova.
  • Se você usar o script Pay Station Embed, ele deve ser da versão 1.5.0. ou além.

Google Pay

Para adicionar uma opção de pagamento com um clique via Google Pay à interface de pagamento:

  1. Dependendo da maneira que você abrir a interface de pagamento, conclua as seguintes configurações adicionais:
Opção de abertura da interface de pagamentoConfigurações adicionais
Nova janelaNenhuma configuração adicional necessária.
IframeAdicione o atributo allow=”payment”.
Script Pay Station EmbedAtualize o script à versão 1.5.0. ou além.
O script da versão 1.5.0. suporta o atributo allow=”payment” por padrão.
Android WebViewNenhuma configuração adicional necessária.
Custom TabsNenhuma configuração adicional necessária.
Exemplo da interface de pagamento abrindo no iframe:
Copy
Full screen
Small screen
<iframe src="https://secure.xsolla.com/paystation4/?token=token_body" allow="payment""></iframe>
  1. Crie uma solicitação para habilitar essa opção. Para fazer isso:

    a. Abra sua Conta de Distribuidor e vá para a seção Support Hub.

    b. Clique em Submit request.

    c. Na janela que surgir, preencha os seguintes campos:

    • Summary. Por exemplo, Configuração de pagamento com um clique.
    • Description. Especifique a maneira que você abre a interface de pagamento e indique a opção de pagamento com um clique: via Google Pay ou tanto Google Pay quanto Apple Pay.
    • Project ID. Selecione um ID de projeto na lista suspensa. Se você quiser configurar a opção de pagamento com um clique para múltiplos projetos, especifique os IDs deles no campo Description.

    d. Clique em Send.

  2. Espere pela confirmação da Xsolla a respeito da ativação bem-sucedida da opção de pagamento com um clique no seu projeto.
Aviso
Se seu site foi criado usando o Xsolla Site Builder ou Web Shop, você precisará republicá-lo para habilitar o pagamento com um clique.

Limitações:

  • Se você passar o parâmetro settings.ui.is_independent_windows na solicitação do token para abrir a interface de pagamento em uma nova aba de um navegador externo, você não poderá ativar o pagamento com um clique via Google Pay. Porém, independentemente de esse parâmetro ser passado, você pode aceitar pagamentos via Google Pay abrindo-o em uma nova aba.
  • Se você usar o script Pay Station Embed, ele deve ser da versão 1.5.0. ou além.
  • Engines de jogos não suportam janelas pop-up. É por isso que o pagamento com um clique do Google Pay fica indisponível ao utilizar o SDK Xsolla para Unity (exceto em builds WebGL) e Unreal Engine.
  • Para cumprir com a legislação brasileira, os usuários devem inserir o número de identificação fiscal (CPF) deles manualmente ao pagar com o Google Pay. É por isso que o pagamento com um clique do Google Pay não pode ser ativado para aceitar pagamentos no Brasil.
  • Para builds WebGL no Unity, garanta o uso da versão mais nova do SDK.
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: 3 de Março 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!