O que é uma conexão na Zru?

A Zru é um agregador de métodos de pagamento. Mas, além de conectar com processadores de pagamento, também permite conectar com outras ferramentas: antifraude, gestão de chargebacks, 3DS Agnóstico, Network Token, etc.

Por isso a secção se chama Conexões e não simplesmente "métodos de pagamento": podes utilizá-la para adicionar tanto processadores como ferramentas de gestão de pagamentos, tudo com alguns cliques a partir do painel.

Ao longo deste guia usaremos o termo "fornecedor" para nos referirmos tanto a métodos de pagamento como a ferramentas.

Diferença entre Conexão e Método de pagamento

No painel diferenciamos o que é uma conexão e um método de pagamento para que a gestão seja mais simples. Tudo se agrupa por fornecedor.

Alguns pontos-chave:

• Uma conexão pode englobar um ou vários métodos de pagamento.
• Existem conexões sem métodos de pagamento, como 3DS Agnóstico, que é um fornecedor de serviços e não de pagamento.
• Os métodos de pagamento vivem sempre dentro de uma conexão.
• As credenciais introduzem-se uma única vez na conexão, não em cada método de pagamento separadamente.

Alguns exemplos:

• Redsys é uma conexão com três métodos de pagamento: Cartão, Bizum e Cartão Redireção.
• dLocal é uma conexão com vários métodos de pagamento: Cartão, dLocal Redireção, 7-eleven, etc.
• Inespay é uma conexão com um único método de pagamento: Transferência.
• 3DS Agnóstico é uma conexão sem métodos de pagamento.

Antes de adicionar uma conexão

A Zru é uma plataforma tecnológica: liga-te ao fornecedor, mas primeiro precisas de ter uma conta com ele.

• Em alguns casos temos acordos com o fornecedor e podemos pôr-te em contacto diretamente. Vê-lo-ás ao adicionar a conexão: aparecerá a etiqueta "Partner".
• Noutros casos tratamos nós e não precisas de conta em nenhum fornecedor externo, como acontece com o 3DS Agnóstico ou o Network Token.

Assim que tiveres conta com o fornecedor, ele dar-te-á umas credenciais que introduzirás no painel para configurar a conexão.

✋ Tem em conta que, consoante a região ou o país onde está a tua empresa, poderás ou não utilizar alguns fornecedores, já que cada um dá serviço em determinados países.

A lista de Conexões

Vai à secção Conexões do menu vertical da esquerda. Verás dois separadores: Ativas e Desativadas.

Podes pesquisar por nome de conexão ou de método, e filtrar com Todas as categorias e Todas as moedas. O botão Exportar CSV descarrega a lista.

As colunas da lista são:

• Conexão: o nome do fornecedor.
• Categoria: o tipo de conexão (Processador, Banca, BNPL, Marketplace, Segurança, etc.).
• Métodos de pagamento: métodos ativos dentro dessa conexão.
• Utilização: dois ícones que indicam se a conexão está a ser usada em orquestrações e/ou Checkouts. Ao passar o rato sobre cada ícone aparece um tooltip com os nomes concretos.
• Data de conexão: quando foi adicionada.

Como adicionar uma conexão?

A criação de uma conexão faz-se numa vista dedicada passo a passo.

Passo 1 — Seleciona a conexão

• Vai à secção Conexões do menu vertical da esquerda.
• Clica em "Nova conexão".
• Procura a conexão que te interessa por nome, ou filtra por moeda e categoria.
• Cada cartão mostra o fornecedor, uma descrição breve, a sua categoria e os métodos de pagamento que suporta. Se tivermos acordo com o fornecedor, verás a etiqueta "Partner".
• Clica na conexão que quiseres.

Passo 2 — Configura as credenciais

Abrir-se-á um painel lateral com a configuração da conexão.

• Escreve o nome com que a conexão aparecerá no checkout.
• No bloco Credenciais de [fornecedor], preenche as credenciais que te foram fornecidas.

✋ Se estás num ambiente de teste, introduz as credenciais de teste. Se é um ambiente de produção, as de produção.

Em ambientes de teste, se o processador for compatível, poderás escolher entre duas opções:

• As minhas credenciais: usa as tuas próprias credenciais de teste do processador. Seleciona-a se já tens uma conta ativa com ele.
• Credenciais da Zru: a Zru fornece-te as credenciais de sandbox. Útil para começar a testar sem precisares de conta própria no processador.

Consoante o fornecedor verás campos e opções específicas (por exemplo, ativar ou forçar 3DS). Se quiseres atribuir um identificador próprio à conexão, expande Configuração avançada e preenche o campo Código interno.

• Clica em "Continuar".

Passo 3 — Adiciona os métodos de pagamento

No painel lateral Adicionar métodos de pagamento:

• Seleciona os métodos que queres ativar, ou usa "Selecionar todos".
• Clica em "Adicionar métodos".

A conexão é criada ativa por defeito. Verás um aviso que te convida a começar a operar adicionando a conexão às tuas Orquestrações ou Checkouts.

O detalhe de uma conexão

Ao clicar numa conexão verás o seu detalhe. No cabeçalho mostram-se a Conexão (fornecedor), a Categoria, a Utilização em orquestrações e Checkouts, a Data de conexão e o seu estado.

Por baixo está a secção Métodos de pagamento, com a sua própria pesquisa e filtros (Todos os estados, Todas as moedas). Para cada método podes consultar:

• Utilização: em quantas orquestrações e Checkouts está a ser usado.
• Pagamentos / Aceitação: o número de pagamentos processados e a sua taxa de aceitação.
• Moedas: as moedas em que o método opera.
• Última modificação: quando foi atualizado pela última vez.
• Estado: ativa ou desativa o método com o toggle, sem sair da tabela.

A partir daqui também podes eliminar um método com o ícone de caixote do lixo.

🧐 Se uma conexão não tiver nenhum método ativo, o painel avisa-te para adicionares um e a conexão poder começar a operar.

Configuração avançada de uma conexão

Dentro do detalhe de uma conexão, clica em "Configuração" no canto superior direito. Abrir-se-á um painel com o acordeão Configuração avançada, que inclui o campo Código interno.

🧐 O código interno é enviado na notificação dentro de _gateway, no campo internal_code. É útil se precisares de identificar de que conexão provém um pagamento nos teus sistemas.

Também podes preencher este campo durante a criação da conexão, no passo das credenciais.

Como ativar ou desativar uma conexão?

Para desativar uma conexão

• Vai à secção Conexões do menu vertical da esquerda.
• Clica na conexão que queres desativar, dentro do separador Ativas.
• Clica em "Configuração" no canto superior direito e desativa "Estado da conexão" no final do módulo.
• Clica em "Atualizar".

A conexão passará para o separador Desativadas.

Para ativar uma conexão

• Vai à secção Conexões do menu vertical da esquerda.
• Clica no separador Desativadas.
• Clica na conexão que queres ativar.
• Clica em "Configuração" no canto superior direito e ativa "Estado da conexão" no final do módulo.
• Clica em "Atualizar".

✋ Tem em conta que ativar a conexão não ativa automaticamente os métodos incluídos. Tens de entrar na conexão e ativar os métodos que desejares com o toggle de Estado.

Como modificar uma conexão?

• Vai à secção Conexões do menu vertical da esquerda.
• Clica na conexão que queres modificar.
• Clica em "Configuração" no canto superior direito.
• Altera os parâmetros que precisares.
• Clica em "Atualizar" para guardar as alterações.

Posso apagar uma conexão?

Atualmente não é possível apagar uma conexão. Se já não precisas dela, mantém-na desativada. Podes sempre reativá-la quando quiseres.

Onde posso usar as conexões?

Os métodos de pagamento de cada conexão (ou a própria conexão, se não for um processador de pagamento) estarão disponíveis como opção ao configurar as tuas Orquestrações e os teus Checkouts.

Actualizado em: 30/06/2026