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

# Adicionar e gerir as Conexões

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