Personalize Links de Pagamento
Escolha a identidade visual, os módulos de checkout, os campos do cliente, os controles do link e a experiência de retorno usados pelos Links de Pagamento da DEUNA.
Nesta página
Use este guia para decidir o que personalizar e onde configurá-lo. Um Link de Pagamento combina padrões no nível do lojista, configurações em um link individual e as regras visuais suportadas por CustomStyle.
Escolha o controle correto#
| Objetivo | Configure em | Guia detalhado |
|---|---|---|
| Estabelecer logotipo, cor primária, localidade ou domínio hospedado | Configuração do lojista com seu TAM | Esta página |
| Habilitar login, informações do cliente, cobrança ou resumo do pedido | Padrões do lojista ou suportado checkout_modules no link | Configurações do Widget |
| Definir produtos, métodos de pagamento, expiração, limites de compra ou limites de tentativa | DEUNA Admin ou API de Link de Pagamento | Gerenciar links de pagamento ou Link de pagamento via API |
| Alterar cópia de checkout suportada e estilo visual | CustomStyle | Visão geral do CustomStyle |
| Enviar o cliente para uma página do lojista após um resultado | URLs de retorno suportadas no link | Link de pagamento via API |
| Confirmar o resultado de pagamento autoritativo | Recuperação no backend e webhooks | Webhooks |
Definir padrões do lojista#
Trabalhe com seu TAM para definir a experiência de base herdada pelos Links de Pagamento. Confirme cada configuração para o lojista e ambiente onde o link será executado.
Identidade visual, localidade e URL hospedada
A apresentação de base pode incluir:
- logotipo da empresa, alinhamento e tamanho;
- a cor de ação primária;
- o idioma padrão voltado ao cliente; e
- o domínio hospedado do Link de Pagamento atribuído ao lojista.
Mantenha contraste suficiente para botões e texto de status, use uma imagem que permaneça legível em telas estreitas e teste a localidade configurada com rótulos reais de produto e método de pagamento.
Módulos de checkout e dados do cliente
Os módulos determinam quais telas e informações o cliente encontra. Os mesmos módulos são documentados para a experiência de checkout mais ampla, portanto, suas regras de campo permanecem centralizadas em Configurações do Widget.
| Módulo | Finalidade do Payment Link |
|---|---|
LoginPattern | Reconhecer um comprador recorrente e iniciar o fluxo de senha única suportado. |
UserInfoPattern | Coletar os campos de identidade e contato do cliente exigidos pelo lojista. |
BillingPattern | Coletar informações de cobrança no checkout principal ou em uma visualização separada. |
OrderDetailPattern | Mostrar os produtos e a divisão de valores associados ao pedido. |
Para informações de cobrança mostradas diretamente no checkout principal, configure no máximo quatro campos. Se o pedido já contiver dados de cobrança, o cliente pode ver um resumo em vez de um formulário vazio. Coloque país antes de estado ou província e cidade quando esses campos dependentes forem coletados.
A coleta de documento de identidade faz parte da configuração de pagamento e dados do cliente. Use a referência de documento de identidade para revisar os rótulos de documento suportados antes de solicitá-lo.
Configurar um link individual#
Escolha o caminho de criação que possui o link:
Um link criado pela API pode incluir estes grupos de configurações:
| Grupo de configuração | O que controla |
|---|---|
| Pedido e itens | Nomes de produtos visíveis ao cliente, quantidades, preços, impostos, descontos e imagens. |
| Opções de pagamento | Os métodos de pagamento e processadores compatíveis oferecidos para aquele link. |
checkout_modules | Módulos suportados, como LoginPattern, UserInfoPatterne OrderDetailPattern. Os padrões do lojista se aplicam quando este campo é omitido. |
configuration | Nome do link, expiração, limite de compras concluídas e limite de tentativas de pagamento. |
redirect_urls | Destinos do cliente suportados para comportamento de sucesso, pendente, erro, fechamento ou fallback. |
Não use um retorno do navegador como prova de pagamento. Um cliente pode fechar a página, perder conectividade ou retornar enquanto o resultado do provedor ainda está pendente. Preserve o token do pedido e confirme o estado final por meio de recuperação no backend ou DEUNA.
Estilize a interface do usuário voltada ao cliente#
Uso CustomStyle para substituições visuais e de texto suportadas. Aplica-se às superfícies de checkout da DEUNA; não altera quais módulos estão habilitados ou quais campos a API de Payment Link aceita.
Abra o Visão geral do CustomStyle para selecionar uma área de checkout, visualizá-la e montar um objeto consolidado. Verifique cada guia focado para limitações do Payment Link; nem todo elemento exclusivo do widget aparece na experiência hospedada do Payment Link.
Verifique a experiência#
Antes de compartilhar um link de produção:
- Abra o link em desktop e em uma viewport móvel estreita.
- Confirme o logotipo, contraste, localidade, informações do produto, totais e métodos de pagamento habilitados.
- Complete os fluxos de cliente convidado e cliente recorrente quando o login estiver habilitado.
- Valide todos os campos obrigatórios de cliente, identidade e cobrança para o país de destino.
- Teste o comportamento de sucesso, pendência, rejeição, fechamento e link expirado.
- Confirme que cada destino do navegador funciona e que seu backend ainda recebe ou recupera o resultado de pagamento autoritativo.