> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://academy.zrupay.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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 - Conta`** se vai contra uma conexão direta (por exemplo `Adyen - Adyen` ou `Redsys - Bizum`), ou **`Orquestração - Nome`** se vai contra uma orquestração (por exemplo `Orquestraçã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](https://academy.zrupay.com/pt/article/gerir-temas-de-checkout-1nis3n4/).

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