Clique para pagar

O Click to Pay é uma solução de pagamento on-line projetada para simplificar e proteger as transações on-line. Ela se baseia no padrão de pagamento seguro EMVCo, um consórcio global que inclui as principais empresas de cartões, como Visa, MasterCard, American Express e Discover.

Redes disponíveis na Yuno: MasterCard

Principais recursos e benefícios

Facilidade de uso: permite que os consumidores façam compras on-line com um único clique, eliminando a necessidade de inserir manualmente os detalhes do cartão de crédito para cada compra.
Segurança aprimorada: Utiliza padrões modernos de autenticação para minimizar o risco de fraude. Isso pode incluir métodos como autenticação de dois fatores ou tokens de pagamento.
Consistente em vários sites: Oferece uma experiência de pagamento semelhante em todos os sites que suportam essa tecnologia, o que significa que os consumidores não precisam aprender processos diferentes para cada loja on-line.
Integração com marcas de cartão: Por ser apoiado pelas principais bandeiras de cartão, o "Click to Pay" é amplamente aceito e confiável.
Compatibilidade com dispositivos móveis e desktops: Projetado para funcionar em vários dispositivos, ele facilita as compras on-line tanto em desktops quanto em dispositivos móveis.

Esse recurso aprimora a experiência do cliente e se alinha às tendências modernas de pagamento digital, aumentando potencialmente as taxas de conversão e a fidelidade do cliente. Ao incorporar o "Click to Pay", você pode oferecer uma experiência de checkout perfeita, reduzindo o atrito e abordando as preocupações com a segurança nas transações on-line.

Integração

Para integrar e começar a oferecer o Click to Pay a seus clientes, siga estas três etapas simples:

Crie uma conexão no painel do Yuno usando suas credenciais do Click to Pay.
Defina a rota do método de pagamento na seção Routing para poder ativá-la no Checkout Builder.
Habilite o Click to Pay no construtor de checkout.
Definir a rota do cartão: Levando em consideração que o Click to Pay é uma carteira que armazena informações de cartão de crédito, a rota em que você precisará definir os provedores para cada cenário é a mesma do método de pagamento "Cartão".

Integração VTEX

Para os comerciantes da VTEX que usam o Click to Pay, a integração oferece criação automática de clientes e mapeamento de dados para simplificar a experiência de checkout.

Criação automática de clientes:

Quando os clientes escolhem Click to Pay nas lojas VTEX:

O cliente VTEX é criado automaticamente no Yuno durante a inicialização do pagamento (se ainda não existir)
Todos os dados do cliente do perfil VTEX são automaticamente mapeados para o Yuno e incluídos na sessão de checkout
As informações do cliente (CVV, email, endereço) são pré-preenchidas no SDK, eliminando a entrada de dados redundantes
O fluxo de checkout corresponde à experiência simplificada disponível para comerciantes que não são da VTEX

Esse recurso requer que o campo Criar cliente seja definido como Sim na configuração do provedor VTEX. Para obter mais detalhes, consulte Configurar a Yuno como provedor na documentação de integração da VTEX.

Integração de SDK (Click to Pay Passkey)

⚠️
Importante
Os fluxos de cartão Click to Pay padrão usam os retornos de chamada do SDK existentes, mas os usuários do Passkey devem incluir um callback_url que corresponda ao esquema de deeplink do aplicativo para que o comprador retorne ao aplicativo após a autenticação (no Android, isso deve corresponder ao esquema configurado em AndroidManifest.xml). Por exemplo:
{
  "callback_url": "myapp://pay/ctp"
}
Para transações Passkey, o token de uso único (OTT) nunca alcança os retornos de chamada habituais do SDK (incluindo callbackOTT no Android). Sempre leia-o nos parâmetros do deeplink antes de continuar o fluxo.

Os SDKs Yuno para iOS e Android suportam atualmente o Click to Pay por meio do fluxo Passkey. Em ambos os casos, o token de uso único (OTT) é retornado por meio de um URL de link profundo em vez dos retornos de chamada padrão do SDK, portanto, seu aplicativo deve analisar os parâmetros do link profundo antes de continuar o pagamento.

Fluxo de senhas do iOS

O SDK Yuno para iOS oferece suporte ao Click to Pay com Passkey. O fluxo difere dos pagamentos com cartão padrão porque o SDK retorna o resultado por deeplink em vez de por meio dos retornos de chamada delegados usuais.

Lidar com o token de uso único (OTT) e com o deeplink

Quando um comprador conclui o fluxo Click to Pay Passkey, o SDK envia o resultado por meio do URL do deeplink em vez do yunoCreatePayment(with token: String) método delegado.

1. Feche o navegador externo

Quando seu aplicativo receber o retorno de chamada do deeplink, chame imediatamente Yuno.receiveDeeplink para permitir que o SDK ignore o navegador externo que foi usado para a autenticação Passkey.

func application(_ app: UIApplication,
                 open url: URL,
                 options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    Yuno.receiveDeeplink(url: url)

    // Parse the URL to extract parameters

    return true
}

2. Processar o URL do deeplink

A string de consulta do deeplink inclui as informações de que você precisa para continuar:

has_error: Indica que ocorreu um erro durante a transação. Lide com esse cenário em seu aplicativo.
one_time_token: Presente quando a transação é bem-sucedida. Use-o para criar o pagamento.

3. Criar o pagamento

Se o deeplink contiver um one_time_token:

Extrair o one_time_token.
Use-o para criar o pagamento com o endpoint Create Payment.
Depois de criar o pagamento, chame continuePayment no SDK para finalizar o fluxo.

⚠️
Importante
A OTT nunca alcança yunoCreatePayment(with token: String) para Click to Pay Passkey. Sempre leia o token do URL do deeplink.

Fluxo de senha do Android

Para Android, inclua um callback_url que corresponda ao esquema de deeplink do seu aplicativo ao criar a sessão de checkout, adicione o intent-filter em AndroidManifest.xmle manipular o deeplink em ambos onCreate e onNewIntent. Quando o deeplink chegar:

Verificar has_error para gerenciar cancelamentos ou falhas.
Extrato one_time_token (e o opcional checkout_session) do URI.
Envie o OTT para seu backend para chamar o Criar endpoint de pagamentoe, em seguida, invoque continuePayment no SDK para retomar o fluxo.

Consulte os guias full SDK para obter exemplos detalhados: Android Full Checkout e iOS Full Checkout.