Criar e gerir os Checkouts
O que é um Checkout?
Um Checkout é o ecrã de pagamento que os seus clientes veem quando estão a ponto de pagar. Cada checkout pode:
- Mostrar diferentes métodos de pagamento (cartão, Bizum, PayPal, criptomoedas, etc.)
- Ser mostrado apenas a certos clientes segundo regras de segmentação (país, idioma, tipo de dispositivo, moeda...)
- Ter a sua própria aparência através de temas reutilizáveis
- Ligar-se a Conexões ou Orquestrações para processar o pagamento
A cadeia conceptual é:
Checkout → contém Métodos → cada método é atribuído a uma Conexão ou a uma Orquestração que decide como processar o pagamento.
Como localizar e gerir os seus Checkouts
No painel: menu lateral → bloco Otimização → Checkouts.
A lista
A lista tem dois separadores, Ativos e Desativados, e dois modos de visualização:
- Vista de grelha: cada checkout é mostrado como um cartão com uma pré-visualização real do ecrã de pagamento (mockup com o valor, os métodos e o formulário), o seu nome, os ícones dos métodos ativos e um badge com o seu condicionante de segmentação.
- Vista de lista: uma tabela com as colunas Nome, Métodos de pagamento, Mostrar para e Última modificação.
Criar um Checkout
Clique no botão "Criar Checkout" no canto superior direito. Abre-se diretamente o editor com um checkout novo em branco pronto a configurar.
O editor de Checkouts
Ao abrir um Checkout (ou ao criar um novo) abre-se o editor em split-view. O ecrã divide-se em três zonas:
- Cabeçalho superior: uma seta para voltar à lista, a data da última atualização, o nome do checkout com o seu menu e o botão Publicar.
- Barra lateral esquerda com quatro separadores verticais: Segmentação, Métodos, Aparência, Configuração.
- Painel da direita com uma pré-visualização em direto do checkout que se atualiza a cada alteração.
🧐 O checkout não se ativa nem se desativa a partir do cabeçalho. Isso faz-se no separador Configuração, com Ativar checkout.
Separador 1: Segmentação
Define a quem será mostrado este checkout. Útil quando tem vários checkouts e quer que cada um apareça em condições diferentes (por exemplo, um para Espanha e outro para a América Latina).
Como funciona
A secção chama-se Segmentação do checkout e, dentro dela, sob a etiqueta "Mostrar para:", adiciona as condições que se avaliam ao mostrar o checkout. Adicionam-se com Adicionar condição.
- Se for o checkout padrão, não o pode segmentar. O painel indica-o assim: "Os checkouts padrão não podem ser segmentados e são utilizados apenas quando não se cumprem os requisitos de segmentação dos checkouts personalizados".
- Se adicionar uma variável, o checkout só é mostrado quando essa variável se cumpre.
- Pode adicionar várias variáveis; todas se avaliam em AND.
Variáveis disponíveis (18)
Operação (9): Preço, Moeda, Tipo (Pagamento único / Subscrição / Autorização), Idioma, Apenas autorizar, MOTO, Aprovação parcial, POS, Terminal POS.
Cliente (9): Variável personalizada, Tipo de dispositivo, Sistema operativo, Browser, País IP, Região IP, País, Região, E-mail.
Separador 2: Métodos
Define que métodos de pagamento aparecem no checkout e em que ordem. O painel resume-o assim: "Selecione e ordene os métodos de pagamento que deseja que apareçam no seu checkout".
Quick Payments
Métodos rápidos baseados em wallets do browser ou do sistema operativo. Só se mostram se houver um método do tipo Cartão configurado no checkout:
- Apple Pay (toggle on/off)
- Google Pay (toggle on/off)
Métodos de pagamento
A lista dos métodos disponíveis. Cada linha lidera com o método, não com quem o processa. Para cada um verá:
- Pegas de arrasto para os reordenar arrastando.
- O logótipo e o nome do método em negrito (Cartão, Bizum, Pepper, Financiar...).
- Abaixo, em pequeno, a origem do método:
Fornecedor - Contase vai contra uma conexão direta (por exemploAdyen - AdyenouRedsys - Bizum), ouOrquestração - Nomese vai contra uma orquestração (por exemploOrquestração - Bizum). - Um toggle para ativar ou desativar o método.
- O ícone
|||que abre a configuração por método.
Pode adicionar métodos com os botões "Adicionar cartão" e "Adicionar método".
🧐 Além das orquestrações de cartão, aqui pode usar orquestrações de Financiamento e de Método alternativo. Na lista identificam-se pelo seu método, pelo que uma linha lhe diz o que o checkout oferece, não quem o liquida.
Configuração por método (ícone |||)
Ao clicar no ícone ||| abre-se a janela "Configuração de método de pagamento", com dois separadores e uma área de Pré-visualização na parte superior, que reflete as alterações no momento.
Em baixo da janela tem Eliminar, para retirar o método do checkout, além de Cancelar e Guardar. Dentro do separador Aparência há também um link Restabelecer valores padrão.
Separador Aparência
Personalize o aspeto do método no checkout. As opções variam conforme o método:
- Cartão: Texto no seletor e Ícone no seletor (tamanho recomendado 70x70px). Não tem modo botão porque é sempre renderizado com o seu formulário integrado.
- Os restantes métodos, incluindo os de financiamento e os de método alternativo: o mesmo que Cartão, mais o toggle Seletor / Botão, Cor de fundo do botão e Logo no botão.
Separador Condicionantes
Define a quem se mostra este método individualmente dentro do checkout. Isto cria um modelo de duplo nível de segmentação:
- A nível de checkout (separador Segmentação): decide a quem mostrar o checkout completo.
- A nível de método (este separador): decide que métodos aparecem dentro do checkout para cada cliente.
Toggle de lógica:
- Mostrar se → o método aparece só se a condição se cumprir.
- Não mostrar se → o método é ocultado se a condição se cumprir.
As variáveis disponíveis são as mesmas que em Segmentação: Operação (9) + Cliente (9).
Casos de uso típicos:
- Mostrar Bizum só se
País IP = ES. - Mostrar Pepper só se
Preço > 60 EUR.
Separador 3: Aparência
Gestão de Temas reutilizáveis entre checkouts.
- Botão "Novo tema" para criar um de zero.
- Uma galeria dos temas existentes com pré-visualização visual, cada um etiquetado pelo seu âmbito: Empresa ou Ambiente.
- Cada tema tem um radio button para o aplicar a este checkout e um menu "..." para o editar.
🧐 Os temas são globais: se modificar um tema, a alteração aplica-se automaticamente a todos os checkouts que o usam. Pode saber mais sobre a gestão de temas neste guia.
Separador 4: Configuração avançada
Definições técnicas do checkout:
- Ativar checkout: permite desativá-lo. O checkout padrão não pode ser desativado.
- Forçar opção MOTO: aplica a opção MOTO a todas as operações processadas por este checkout.
- Ignorar erro de SCA necessário: ignora o erro de autenticação reforçada se o banco o exigir.
- Forçar em caso de erro 3DS: força a tentativa de pagamento mesmo que a autenticação 3DS falhe por versão obsoleta.
- Orquestração para cobranças recorrentes: permite usar uma orquestração diferente para as cobranças recorrentes geradas a partir de pagamentos neste checkout.
Pré-visualização em direto
O painel da direita mostra uma pré-visualização funcional do checkout em tempo real. Pode controlá-la com três eixos:
- Tipo de operação: Pagamento único, Subscrição ou Autorização.
- Viewport: Desktop 🖥️ ou Mobile 📱.
- Modo: Redirecionamento (vista completa com o resumo da encomenda) ou iFrame (apenas o formulário, sem resumo, para quando o integra na sua própria página).
Tem também um seletor de zoom no canto superior direito.
Publicar alterações
Uma vez configurado o checkout, clique em Publicar no canto superior direito. Enquanto não publicar, as alterações não se aplicam ao checkout em produção.
Casos de uso práticos
Checkouts por moeda
- Checkout EUR → Segmentação: Moeda Igual a EUR → métodos espanhóis (Bizum, Cartão via Redsys).
- Checkout USD → Segmentação: Moeda Igual a USD → métodos internacionais (Cartão via Stripe, PayPal).
Checkout com tema unificado
- No separador Aparência, crie um tema com a sua marca.
- Aplique o mesmo tema a todos os checkouts do comércio.
- Se atualizar o tema, todos os checkouts herdam as alterações automaticamente.
Actualizado em: 01/09/2026
Obrigado!
