Headless SDK (pagamento)

O Headless SDK da Yuno oferece controle total sobre a experiência do usuário e a interface do usuário do checkout sem exigir conformidade com o PCI. Com o Headless SDK, você pode fazer pagamentos com cartão ou registrar informações de cartão nas contas de seus clientes. Acesse o Headless SDK (Enrollment) para obter mais informações. Esta página aborda a operação de pagamento. Abaixo, você pode conferir os guias disponíveis.

Workflow de pagamento

O diagrama abaixo ilustra o fluxo de trabalho completo do pagamento. Cada etapa é explicada em detalhes nas seções a seguir. Para obter detalhes de implementação específicos da plataforma, consulte o guia correspondente:

Web

iOS

Android

Fluxo de pagamento Headless do SDK

Esse diagrama ilustra o processo de pagamento headless usando o SDK, detalhando as interações entre o cliente comerciante, o servidor comerciante, o servidor Yuno e o SDK Yuno. Ele descreve as etapas desde o início de um checkout e a solicitação de métodos de pagamento até a criação e o recebimento do resultado do pagamento.

Cliente comerciante

O cliente comerciante representa seu aplicativo front-end que interage com o servidor back-end e o SDK da Yuno. Ele lida com os aspectos do fluxo de pagamento voltados para o usuário, incluindo:

Iniciar 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

Servidor do comerciante

O servidor do comerciante representa seu aplicativo de back-end que lida com operações do lado do servidor e se comunica com os servidores da Yuno. Suas principais responsabilidades incluem:

Criar o cliente
Criar 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 servidor Yuno lida com todas as operações de back-end relacionadas ao gerenciamento de clientes, sessões de checkout e processamento de pagamento. Suas principais responsabilidades incluem:

Criar os clientes
Cria uma 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 SDK da Yuno lida com a interface do usuário e o fluxo de pagamento no lado do cliente, gerenciando a seleção do método de pagamento, a geração de token e a conclusão 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

Fluxo

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

Servidor do comerciante: Criar cliente --> Servidor Yuno: Cria cliente
Cliente comerciante: Iniciar checkout --> Servidor do comerciante: Criar sessão de checkout
Servidor do comerciante: Criar sessão de checkout --> Yuno Server: Cria sessão de checkout
Cliente comerciante: Listar 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 disponível
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: Obtém token (uso único)
Cliente comerciante: obtém token (uso único) --> Cliente comerciante: inicia o 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
Servidor do comerciante: Receber resultado de pagamento via webhook --> Servidor Yuno: Receber resultados de pagamento do provedor de pagamento

📘
Escolha sua integração
O Headless SDK foi projetado para aceitar pagamentos somente com cartões. Se você precisar realizar um pagamento usando outro método de pagamento, será necessário escolher outra integração Yuno:

Full SDK

Lite SDK

Fluxo direto

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

Com o Headless SDK, você pode salvar cartões de crédito/débito para compras futuras na mesma solicitação de pagamento sem o registro integração. Você pode obter o token abobadado durante a execução do apiClientPayment.generateToken função em Etapa 4.

Forneça uma caixa de seleção no checkout para que os usuários escolham se desejam salvar o cartão para uso futuro. Se o usuário selecionar essa opção, defina payment_method.card.save = true ao chamar o apiClientPayment.generateToken função. Você receberá o vaulted_token na resposta da função.

📘
Métodos de pagamento alternativos
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, você pode usar um dos seguintes endpoints:

🚧
Usando um token protegido
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.