Lite SDK (Pagamento)

O Lite SDK oferece controle total sobre sua experiência de pagamento. Ao contrário do Full SDK essa versão permite que você consulte os métodos de pagamento disponíveis e decida quais serão exibidos no checkout. Depois que o cliente seleciona um método de pagamento, o processo de pagamento segue as mesmas etapas do Full SDK.

Além disso, o Lite SDK suporta o registro de métodos de pagamento para uso futuro. Para obter mais detalhes, consulte Lite SDK (Enrollment).

📘
Google Pay e Apple Pay no Lite SDK
O Google Pay e o Apple Pay não estão disponíveis como opções de pagamento integradas no Lite SDK. Para usar esses métodos de pagamento, você deve usar o mountExternalButtons método. Consulte os guias específicos da plataforma para obter detalhes sobre a implementação.

Com o Lite SDK, você pode:

Executar o processo de pagamento
Registrar um cartão de crédito ao fazer um pagamento
Usar um token protegido de um método de pagamento registrado para concluir uma transação
Realize cálculos de impostos em tempo real usando o retorno de chamada BIN (Número de Identificação Bancária)

Use os guias a seguir para implementar cada processo:

Workflow de pagamento

Fluxo de trabalho de pagamento usando um token protegido por cofre

Registrar um cartão de crédito durante o pagamento

Workflow de pagamento

O diagrama abaixo ilustra o fluxo de pagamento completo:

Fluxo de pagamento do SDK Lite

Esse diagrama ilustra o processo de pagamento usando o SDK Lite, detalhando as interações entre o Cliente comerciante, o Servidor do comerciante, o Yuno Server e o Yuno SDK. Ele descreve as etapas desde o início de um checkout e a seleção de métodos de pagamento até a criação e conclusão do pagamento.

Visão geral dos componentes

O fluxo de trabalho de pagamento envolve vários componentes-chave que trabalham juntos para processar pagamentos com segurança. Veja a seguir como cada componente contribui para o processo:

Cliente comerciante

O Cliente comerciante representa seu aplicativo front-end que lida com a interface do usuário e o fluxo de pagamento. Suas principais responsabilidades incluem:

Iniciar o checkout
Listar os métodos de pagamento
O usuário selecionar os métodos de pagamento
Iniciar o SDK com a sessão de checkout e o método de pagamento
Obtém token (uso único)
Iniciar o pagamento
Iniciar o SDK para continuar o fluxo de pagamento

Servidor do comerciante

O Servidor do comerciante representa seu aplicativo de back-end que coordena entre seu front-end e os serviços da Yuno. Suas principais responsabilidades incluem:

Criar o cliente
Criar a sessão de checkout
Solicitar método de pagamento disponível
Criar o pagamento
Receber o resultado do pagamento via webhook

Servidor da Yuno

O Yuno Server lida com todas as operações de back-end relacionadas ao processamento de pagamentos e à integração de provedores. Suas principais responsabilidades incluem:

Criar os clientes
Criar a sessão de checkout
Devolve o método de pagamento disponível
Criar o pagamento no provedor de pagamento
Receber resultados de pagamento do provedor de pagamento

Yuno SDK

O Yuno SDK gerencia o fluxo de pagamento no lado do cliente, lidando com as interações do usuário e o processamento do pagamento. Suas principais responsabilidades incluem:

Recebe a sessão de checkout e o método de pagamento selecionado pelo usuário
Retorno com o token de uso único
Continuar com o fluxo de pagamento
Mostra a tela para o usuário concluir o pagamento
Exibir o resultado do pagamento (opcional)

Fluxo completo

As etapas a seguir descrevem o fluxo completo de interação entre todos os componentes da integração do SDK Lite Payment, detalhando como cada solicitação e resposta passa pelo sistema:

Servidor do comerciante: Criar cliente --> Servidor Yuno: Cria cliente
Cliente comerciante: Inicia o Checkout --> Servidor do comerciante: Cria a sessão de checkout
Servidor do comerciante: Criar sessão de checkout --> Servidor Yuno: Cria sessão de Checkout
Cliente comerciante: Iniciar checkout --> Cliente comerciante: Listar métodos de pagamento
Cliente comerciante: Listar métodos de pagamento --> Cliente comerciante: O usuário seleciona os métodos de pagamento
Cliente comerciante: o usuário seleciona os métodos de pagamento --> Cliente comerciante: inicia o SDK com a sessão de checkout e o método de pagamento
Cliente comerciante: inicia o SDK com a sessão de checkout e o método de pagamento --> Yuno SDK: Recebe a sessão de checkout e o método de pagamento selecionados pelo usuário
Yuno SDK: Recebe a sessão de checkout e o método de pagamento selecionado pelo usuário --> Yuno SDK: Callback com o token de uso único
Yuno SDK: Callback com o token de uso único --> Cliente comerciante: Cliente comerciante: Obtém token (uso único)
Cliente comerciante: Cliente comerciante: Obtém token (uso único) --> Cliente comerciante: Iniciar pagamento
Cliente comerciante: Iniciar pagamento --> Cliente comerciante: Iniciar SDK para continuar o fluxo de pagamento
Cliente comerciante: Iniciar o SDK para continuar o fluxo de pagamento --> Yuno SDK: Continuar com o fluxo de pagamento
Yuno SDK: Continuar com o fluxo de pagamento --> Yuno SDK: Mostra a tela para o usuário concluir o pagamento
Cliente comerciante: Inicia o Checkout --> Servidor do comerciante: Cria a sessão de checkout
Cliente comerciante: Listar métodos de pagamento --> Servidor do comerciante: Solicitar método de pagamento disponível
Cliente comerciante: Iniciar o pagamento --> Servidor do comerciante: Criar pagamento
Servidor do comerciante: Criar pagamento --> Servidor da Yuno: Cria o pagamento no provedor de pagamento
Servidor do comerciante: Receber resultado de pagamento via webhook --> Servidor Yuno: Receber resultados de pagamento do provedor de pagamento
Servidor Yuno: Receber resultados de pagamento do provedor de pagamento --> Yuno SDK: Exibir o resultado do pagamento (opcional)

Configuração do SDK específico da plataforma

Para implementar a integração do Lite SDK , siga os guias específicos da plataforma abaixo:

Web

iOS

Android

Fluxo de trabalho de pagamento usando um token protegido por cofre

Se o seu cliente se inscreveu em um dos métodos de pagamento disponíveis, o pagamento pode ser feito de forma retroativa usando o token Vaulted do processo de inscrição. Com essa abordagem, você não precisa solicitar informações adicionais sobre o método de pagamento.

A imagem a seguir descreve o fluxo de trabalho completo:

Fluxo de token armazenados

Esse diagrama ilustra o processo de pagamento usando um token protegido com o SDK Lite, detalhando as interações entre o Cliente comerciante, Servidor do comerciante, o Yuno Server e o Yuno SDK. Ele descreve as etapas desde o início de um checkout e o uso de um método de pagamento pré-armazenado até a criação e a conclusão do pagamento.

Visão geral dos componentes

O fluxo de trabalho de pagamento token abobadado envolve vários componentes importantes que trabalham juntos para processar pagamentos com segurança. Veja a seguir como cada componente contribui para o processo:

Cliente comerciante

O Cliente comerciante representa seu aplicativo front-end que lida com a interface do usuário e o fluxo de pagamento. Suas principais responsabilidades incluem:

Iniciar o checkout
Renderizar métodos de pagamento
Iniciar o pagamento
Mostra os resultados do pagamento

Servidor do comerciante

O Servidor do comerciante representa seu aplicativo de back-end que coordena entre seu front-end e os serviços da Yuno. Suas principais responsabilidades incluem:

Criar a sessão de checkout
Solicitar método de pagamento disponível
Criar o pagamento
Receber o resultado do pagamento

Servidor da Yuno

O Yuno Server lida com todas as operações de back-end relacionadas ao processamento de pagamentos e à integração de provedores. Suas principais responsabilidades incluem:

Criar a sessão de checkout
Método de pagamento habilitado para devoluções
Criar o pagamento no provedor de pagamento
Fornece resultados de pagamento

Fluxo de trabalho completo

As etapas a seguir descrevem a sequência detalhada de interações entre os diferentes componentes do fluxo de trabalho de pagamento de token protegido:

Cliente comerciante: Inicia o Checkout --> Servidor do comerciante: Cria a sessão de checkout
Servidor do comerciante: Criar sessão de checkout --> Servidor Yuno: Cria sessão de Checkout
Cliente comerciante: Renderizar métodos de pagamento --> Servidor do comerciante: Solicitar método de pagamento disponível
Servidor do comerciante: Solicitar método de pagamento disponível --> Servidor Yuno: Retorna o método de pagamento habilitado
Cliente comerciante: Renderizar métodos de pagamento --> Cliente comerciante: Iniciar pagamento
Cliente comerciante: Iniciar o pagamento --> Servidor do comerciante: Criar pagamento
Servidor do comerciante: Criar pagamento --> Servidor da Yuno: Cria o pagamento no provedor de pagamento
Cliente comerciante: Mostra os resultados do pagamento --> Servidor do comerciante: Receber o resultado do pagamento
Servidor do comerciante: Recebe o resultado do pagamento --> Servidor Yuno: Fornece resultados de pagamento

Ao contrário do fluxo de trabalho Pagamento, para pagamentos que usam o token abobadado, você usará informações de um cliente existente que tenha se inscrito anteriormente no método de pagamento.

Esse fluxo de trabalho segue as mesmas etapas do fluxo de trabalho Pagamento, mas, em vez de coletar novos detalhes de pagamento, o SDK recupera o token armazenado no cofre. Para obter etapas de implementação detalhadas, consulte os guias específicos da plataforma acima.

Registrar um cartão de crédito durante o pagamento

Com o Lite SDKé possível salvar cartões de crédito ou débito para compras futuras na mesma solicitação de pagamento, sem integração de registro adicional.

Como obter um token abobadado

Você pode recuperar um token armazenado em um cofre de duas maneiras:

Via API: Conjunto vault_on_success = true ao usar o Criar o pagamento endpoint. A resposta retornará o vaulted_token para o cartão do cliente.
Por meio das configurações do SDK: Ativar cardSaveEnable = true nas configurações do SDK para Web, iOSou Android. O SDK exibirá uma caixa de seleção que permitirá aos usuários salvar o cartão.

Use apenas um método para registrar um cartão. Para registrar métodos de pagamento alternativos, consulte a página Lite SDK (Enrollment).

📘
Opções de registro de cartão
Você deve usar apenas uma opção para registrar um cartão. Para registrar métodos de pagamento alternativos, consulte a página Lite SDK (Enrollment).

Depois de se inscrever em um método de pagamento, você pode usar o token armazenado em cofre para realizar pagamentos. Para acessar informações sobre os métodos de pagamento inscritos por cada usuário, use um dos seguintes endpoints:

📘
Práticas recomendadas para o uso de Tokens protegidos por cofre
Mesmo que o usuário selecione um método de pagamento inscrito, a Yuno recomenda usar o SDK para tokenizar as informações em vez de usar diretamente o token protegido com a API da Yuno. Essa abordagem oferece vários benefícios:

Suporte ao 3DS: Segurança aprimorada para pagamentos on-line.

Triagem de fraudes: Melhor proteção contra transações fraudulentas.

Coletar informações necessárias: Reúna os campos adicionais exigidos pelo provedor, se necessário.

Para implementar isso, envie o vaultedToken ao montar o SDK. O SDK cuidará do resto. Se o método de pagamento exigir uma etapa extra (como um desafio 3DS), use a opção yuno.continuePayment() método. Esse método lida com todos os redirecionamentos necessários e funciona para métodos de pagamento registrados e regulares que precisam de ações adicionais do cliente.