Full SDK

Com o Yuno Full SDK, você pode integrar perfeitamente a Yuno ao seu sistema. Essa abordagem simplifica a integração, a manutenção e as operações sem exigir trabalho adicional de conformidade.

Principais recursos

Experiência do usuário: A Yuno gerencia todo o processo de checkout.
Personalização: Configure métodos de pagamento e elementos da interface do usuário diretamente no painel da Yuno.
Flexibilidade: Adicione novos métodos e recursos de pagamento sem desenvolvimento adicional.
Integração única: Ofereça suporte a vários métodos de pagamento por meio de uma única implementação, independentemente do método escolhido pelo cliente.

O que você pode fazer com o full SDK

Processar pagamentos sem problemas.
Registrar um cartão de crédito durante o processamento de um pagamento.
Usar um token protegido de um método de pagamento registrado.

Siga os guias passo a passo abaixo para integrar o Full SDK:

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 Full SDK oferece uma experiência de pagamento unificada, permitindo que os clientes concluam transações usando vários métodos de pagamento em uma única integração. O diagrama abaixo ilustra o processo completo:

Fluxo de integração Full SDK

Esse diagrama ilustra o fluxo de integração abrangente para o Full SDK, detalhando as interações entre o Cliente comerciante, Servidor do comerciante, o Yuno Server e o Yuno SDK. Ele abrange toda a jornada de pagamento, desde o início de um checkout até a exibição do resultado final 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 o checkout
Iniciar o SDK com a sessão de checkout
Receber um token de uso único
Iniciar o pagamento
Iniciar o SDK para continuar o fluxo de pagamento
Mostra a tela para o usuário concluir o pagamento
Exibir o resultado do pagamento (opcional)

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 a sessão de checkout
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
Criar a sessão de checkout
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:

Receber a sessão de checkout
Listar os métodos de pagamento
O usuário selecionar os métodos de pagamento
Retorno com o token de uso único
Continuar com o fluxo de pagamento
Exibir tela para que o usuário conclua o pagamento
Exibir o resultado do pagamento (opcional)

Fluxo

As etapas a seguir descrevem o fluxo completo de interação entre todos os componentes da integração do Full SDK, detalhando como cada solicitação e resposta passa 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 --> Servidor Yuno: Cria sessão de Checkout
Cliente comerciante: Inicie o Checkout --> Inicie o SDK para continuar o fluxo de pagamento
Cliente comerciante: Iniciar o SDK para continuar o fluxo de pagamento --> Yuno SDK: Receber sessão de checkout
Yuno SDK: Receber sessão de checkout --> Listar métodos de pagamento
Yuno SDK: Listar métodos de pagamento --> O usuário seleciona os métodos de pagamento
Yuno SDK: O usuário seleciona os métodos de pagamento --> Retorno com o token de uso único
Yuno SDK: Retorno com o token de uso único --> Cliente comerciante: Receber token de uso único (uso único)
Cliente comerciante: Receber token de uso único --> Iniciar pagamento
Cliente comerciante: Iniciar pagamento --> 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 --> Mostrar tela para o usuário concluir o pagamento
Yuno SDK: Mostrar tela para o usuário concluir o pagamento --> Exibir resultado do pagamento (opcional)
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

Configuração do SDK específico da plataforma

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

Web

iOS

Android

Fluxo de trabalho de pagamento usando um token protegido por cofre

Se um cliente tiver um método de pagamento registrado, ele poderá usar um token protegido do processo de registro para concluir transações sem inserir novamente os detalhes do pagamento.

Diagrama completo do Token Protegido

Esse diagrama ilustra o processo de manuseio de tokens protegidos por cofre dentro do fluxo de pagamento completo, mostrando as interações entre o Cliente comerciante, Servidor do comerciante, o Servidor Yuno e o SDK Yuno. Ele se concentra no uso de credenciais de pagamento pré-armazenadas para transações simplificadas.

Cliente comerciante

O cliente comerciante representa o aplicativo front-end que interage com os clientes. Ele lida com as seguintes responsabilidades principais:

Iniciar checkout
Iniciar o SDK com a sessão de checkout
Iniciar o pagamento
Mostrar o resultado do pagamento

Servidor do comerciante

O servidor do comerciante lida com as operações de back-end e se comunica com o cliente e com os serviços da Yuno. Suas principais responsabilidades incluem:

Criar o cliente
Criar o pagamento
Receber o resultado do pagamento

Servidor da Yuno

O servidor da Yuno lida com a funcionalidade principal de processamento de pagamentos e gerencia os dados do cliente. Suas principais responsabilidades incluem:

Criar o cliente
Criar o pagamento no provedor de pagamento
Fornecer o resultado do pagamento

Yuno SDK

O Yuno SDK lida com a interface do usuário e com o processo de seleção do método de pagamento. Suas principais responsabilidades incluem:

Receber a sessão de checkout
Listar os métodos de pagamento
O usuário selecionar os métodos de pagamento
Retorno com o token de uso único

Fluxo:

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 do comerciante: Iniciar checkout --> Servidor do comerciante: Criar cliente
Servidor do comerciante: Criar cliente --> Servidor da Yuno: Criar cliente
Cliente comerciante: Iniciar o SDK com a sessão de checkout --> Yuno SDK: Receber a sessão de checkout
Yuno SDK: Receber sessão de checkout --> Listar métodos de pagamento
Yuno SDK: Listar métodos de pagamento --> O usuário seleciona os métodos de pagamento
Yuno SDK: O usuário seleciona o método de pagamento --> Retorno com o token de uso único
Yuno SDK: Retorno com o token de uso único --> Cliente comerciante: Iniciar 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
Cliente comerciante: Exibir resultado do pagamento --> Servidor do comerciante: Receber resultado do pagamento
Servidor do comerciante: Recebe o resultado do pagamento --> Servidor da Yuno: Fornece o resultado do pagamento

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

Com o Full SDK, você pode salvar cartões de crédito/débito para compras futuras com a mesma solicitação de pagamento sem a integração do registro. Você pode obter o token protegido de duas maneiras:

Via API: Conjunto vault_on_success = true ao usar o Criar o pagamento endpoint. Você receberá o vaulted_token que corresponde ao cartão usado pelo cliente pagador na resposta.
Por meio das configurações do SDK: Conjunto cardSaveEnable = true nos recursos complementares do SDK (Web, iOSe Android. O SDK exibirá uma caixa de seleção para que os usuários selecionem se desejam salvar o cartão para compras futuras. Se o usuário marcar a caixa, você receberá a mensagem vaulted_token.

📘
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, é necessário usar o Lite SDK.

Depois de registrar 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:

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