> For the complete documentation index, see [llms.txt](https://ola.meajuda.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ola.meajuda.cc/delivery-salao/integracoes/rede.md).

# Rede

Receba pagamentos automáticos via Pix ou cartão de crédito com a integração Rede.

Receba pagamentos automáticos via Pix ou cartão de crédito na loja online com a integração Rede.

## Como funciona

Com a Rede ativa, o cliente paga diretamente no checkout da loja online por Pix ou cartão de crédito à vista, sem ser redirecionado para uma página de pagamento. A integração usa a API e.Rede (REST), não um checkout hospedado ou link de pagamento. Não aceita cartão de débito nem carteiras digitais, como Apple Pay e Google Pay.

As bandeiras aceitas são Visa, Mastercard, Amex, Elo, Diners e Hipercard. No extrato do cartão, aparece o nome da loja.

O Pix fica disponível por 10 minutos. Se o cliente não pagar nesse prazo, o código expira e é necessário fazer um novo pedido.

{% hint style="success" %}
**Exemplo prático**

Se o cliente gerar um Pix e não pagar em 10 minutos, o código expira. Ele precisa iniciar um novo pedido para gerar outro Pix.
{% endhint %}

## Antes de começar

Solicite à Rede uma filiação de **e-commerce**. Se você já usa uma maquininha, peça a duplicação do PV para e-commerce. **Não use o PV da maquininha.**

O PV de e-commerce precisa estar habilitado para **cartão de crédito com captura automática** e **Pix por QR Code**.

Tenha em mãos estes dois dados do portal [Use Rede](https://www.userede.com.br/):

1. **PV:** número de filiação do e-commerce.
2. **Chave de integração:** gerada em **Para vender → e-commerce → chave de integração**.

{% hint style="info" %}
**Observações importantes**

* A chave de integração é sigilosa. Não publique nem compartilhe em mensagens ou canais de atendimento.
* Para configurar a integração, basta informar o PV de e-commerce e a chave de integração. Não é necessário um client\_id separado, URL de webhook ou identificador de carteira.
* O cartão de crédito é sempre à vista. Cartão de débito e carteiras digitais não fazem parte desta integração.
  {% endhint %}

## Como ativar a integração

1. Acesse **Integrações → Pagamento online - Rede** e ative a integração.

<div data-with-frame="true"><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FbEMm34k1mHR66yC8KUBI%2Frede-menu.png?alt=media" alt="Selecione Pagamento online - Rede"></div>

2. Informe o **PV de e-commerce**, não o da maquininha, e a **chave de integração** gerada para essa filiação no Use Rede.
3. Ative **Cartão de crédito**, **Pix** ou ambos.
4. Clique em **Salvar**.

<div data-with-frame="true"><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FhYPEKoJYNtVxMdHOqlAT%2Frede-configuracao.png?alt=media" alt="Tela de configuração da integração Rede"></div>

O PV e a chave são validados na hora. Se algum dado estiver incorreto, a integração não será ativada e aparecerá o aviso: “PV ou chave de integração da Rede inválidos, verifique os dados e tente novamente.”

{% hint style="info" %}
**Observações importantes**

* A aprovação do Pix e a conclusão do estorno são atualizadas automaticamente no painel.
* Só é possível usar uma integração de pagamento online por vez. Se outra integração estiver ativa, desative-o antes de ativar a Rede.
* Ao ativar o Pix pela Rede, o Pix manual deixa de aparecer na loja, para evitar duas cobranças de Pix.
* Ao desativar a integração, a chave é apagada. Informe-a novamente para reativar.
* Consulte repasses, taxas e extrato da adquirente no portal Use Rede.
  {% endhint %}

## Proteção com 3DS

O 3DS adiciona uma etapa de autenticação aos pagamentos com cartão de crédito. A criação do PV e da chave de integração **não habilita o 3DS automaticamente**.

Para usar a proteção:

1. Solicite à Rede a habilitação do **3DS 2.0 no mesmo PV de e-commerce** usado na integração.
2. Aguarde a confirmação da Rede antes de ligar a proteção no painel.
3. Acesse **Formas de pagamento** e ative a proteção com 3DS.
4. Defina o valor mínimo e se a proteção deve valer apenas para o primeiro pedido. Salve a configuração.

{% hint style="info" %}
**Observações importantes**

* Ative a proteção no painel somente depois de confirmar a habilitação do 3DS 2.0 na Rede. Sem essa habilitação, os pagamentos com cartão de crédito da loja deixam de aprovar quando a proteção está ligada.
* A configuração vale somente para a loja que ativar a proteção e para pagamentos com cartão de crédito.
* Pix não usa 3DS.
* A habilitação de carteiras digitais não é necessária: elas não são usadas nesta integração.
  {% endhint %}

## O que o cliente vê

### Cartão de crédito

1. No checkout, o cliente escolhe cartão de crédito.
2. Informa número, validade, código de segurança e nome impresso no cartão.
3. A Rede aprova ou recusa o pagamento na hora. Se recusar, o pedido não é pago e o cliente pode tentar novamente.

### Pix

1. No checkout, o cliente escolhe Pix.
2. A tela mostra o QR Code e o código para copiar e colar.
3. O cliente tem 10 minutos para pagar.
4. Quando a Rede confirma o pagamento, o pedido aparece como pago no painel.

## Estorno de pagamentos

Faça o estorno na tela de **Pedidos**, no painel. O valor devolvido corresponde ao total cobrado naquela transação.

* **Estornado:** o valor foi devolvido ao cliente e o pedido foi cancelado.
* **Estorno em processamento:** a Rede ainda está devolvendo o valor. Aguarde e confira novamente mais tarde. O status é atualizado automaticamente.
* **Estorno não confirmado:** a Rede não aprovou a devolução e o pagamento continua aprovado. Nesse caso, trate o estorno no portal Use Rede.

## Problemas comuns

**PV ou chave inválidos.** Confirme se o PV é da filiação de e-commerce, não da maquininha. Gere ou copie novamente a chave em **Para vender → e-commerce → chave de integração**, no Use Rede. Espaços no começo ou no fim do campo também podem invalidar o dado.

**Não consigo ativar porque há outro pagamento online.** Desative a integração ativa e salve a Rede em seguida.

**O Pix expirou.** O código dura 10 minutos. O cliente precisa fazer um novo pedido para gerar outro Pix.

**O cartão foi recusado.** A recusa é informada pela Rede e pode estar relacionada ao saldo, aos dados do cartão ou à bandeira. Confira se a bandeira é aceita e se a compra é à vista.

**O estorno está em processamento.** Aguarde e abra o pedido novamente. Se continuar pendente, conclua o estorno pelo portal Use Rede.

**O cartão deixou de aprovar depois que ativei o 3DS.** Confirme com a Rede se o 3DS 2.0 está habilitado no mesmo PV de e-commerce usado na integração. Gerar o PV e a chave não ativa o 3DS. A proteção no painel só deve ser ligada depois dessa confirmação.
