# Proteção do pagamento

> Em quatro passos, diga quem pode receber o dinheiro da loja, como o SDK deve reagir, o que é normal no checkout e quais campos extras vigiar.

URL: https://docs.proteside.com/pt-BR/docs/guide/settings/payment-protection

**Configurações → Proteção do pagamento** define como o SDK se comporta no checkout da loja selecionada. A tela é
dividida em quatro passos numerados:

1. **Quem pode receber o seu dinheiro**: os recebedores confiáveis.
2. **Como o SDK deve reagir**: monitorar ou bloquear.
3. **O que é normal no seu checkout**: provedores de pagamento, containers GTM e service workers esperados.
4. **Meios de pagamento detectados**: o que o SDK já reconheceu e os campos extras para vigiar.

As mudanças chegam às páginas pela configuração remota do SDK, sem mexer no site, com uma exceção: o
[canal de release](#canal-de-release-do-sdk). Os detalhes técnicos estão em
[Configuração do SDK](https://docs.proteside.com/pt-BR/docs/integration/configuration).

## Antes de começar
* Só **proprietários** e **administradores** alteram esta tela. Os demais papéis veem tudo, mas sem os botões de
  edição, e a faixa do topo avisa "Somente proprietários e administradores podem alterar estas configurações."
* **Recebedores** (passo 1) são salvos na hora.
* Os passos 2, 3 e 4 são salvos separadamente. Cada um tem o próprio botão **Salvar esta etapa** e mostra **Salvo** ou
  **Alterado · não salvo**. Salve um passo antes de sair da tela.
* As alterações chegam ao SDK em poucos minutos. Para testar uma mudança, aguarde alguns minutos e recarregue o
  checkout. Toda alteração salva fica registrada na [Auditoria](https://docs.proteside.com/pt-BR/docs/guide/settings/audit-log).

## Quem pode receber o seu dinheiro
*Imagem: Como a verificação funciona (1), recebedores vistos (2), recebedores confiáveis (3) e cadastro manual (4).*

Recebedores confiáveis são as chaves e contas que recebem os pagamentos da sua loja. O SDK confere o recebedor de cada
Pix, boleto, QR ou carteira exibido no checkout e alerta quando aparece alguém fora da lista.

Sem nenhum recebedor cadastrado, o SDK registra quem aparece no checkout, mas não alerta sobre recebedores
desconhecidos. Por isso, este é o passo mais importante da tela.

**Como a verificação funciona** (1) abre um resumo de como o recebedor é conferido em cada tipo de código.

### Confirme os recebedores vistos no checkout
A lista **Recebedores vistos no seu checkout** (2) mostra os recebedores que o SDK encontrou no checkout e que você
ainda não confirmou. Para cada um, você vê o método, o recebedor mascarado, quantas vezes foi visto e quando.

* Clique em **É da minha loja** para incluí-lo na lista de recebedores confiáveis.
* Clique em **Não reconheço** se o recebedor não é seu. Isso abre um alerta crítico **Recebedor não reconhecido** em
  [Alertas](https://docs.proteside.com/pt-BR/docs/guide/alerts). Trate como incidente.

Se a lista estiver vazia, faça um pedido de teste no checkout: o recebedor aparece em seguida.

> **Pix gerado por um provedor de pagamento**
>
> Quando o Pix da loja é gerado por um provedor (Mercado Pago, Pagar.me, PagBank e outros), a chave usada no código
> costuma não ser a que você conhece. Nesse caso, prefira confirmar o que aparece em **Recebedores vistos no seu
> checkout** a cadastrar a chave à mão.

### Recebedores confiáveis
A tabela **Recebedores confiáveis** (3) lista o que já está aprovado, com as colunas **Método**, **Recebedor**,
**Origem** (**Cadastro manual** ou **Visto no checkout**), **Rótulo**, **Adicionada em** e **Ativa**.

* Use a chave **Ativa** para desligar um recebedor sem apagá-lo.
* Para remover, clique no ícone de lixeira e confirme em **Remover** na própria linha, ou clique em **Cancelar**.

O Proteside não guarda a chave em claro. Por isso não é possível ver ou editar a chave depois de salva. Para trocá-la,
cadastre a nova e remova a antiga.

### Cadastrar manualmente
Use **Cadastrar manualmente** (4) quando você sabe a chave ou a conta que recebe.

#### Escolha o método
Clique em **Cadastrar manualmente** para abrir o formulário e escolha o **Método**: **Pix**, **Boleto**, **Carteira
cripto**, **UPI (Índia)**, **PayNow (Singapura)**, **PromptPay (Tailândia)**, **DuitNow (Malásia)**, **QR Ph
(Filipinas)**, **HK FPS (Hong Kong)** ou **Transferencias 3.0 (Argentina)**.

#### Informe a chave
O campo **Chave** mostra, embaixo, o formato aceito para o método escolhido. Alguns exemplos:

* **Pix:** CPF, CNPJ, e-mail, telefone (`+55…`) ou chave aleatória.
* **Boleto:** cole a linha digitável de um boleto emitido pela loja.
* **Carteira cripto:** cole o endereço da carteira. Não é preciso escolher a moeda: a tela mostra **Rede detectada**
  com a rede reconhecida pelo formato do endereço.
* **UPI:** VPA no formato `nome@banco`.

Se quiser, preencha um **Rótulo** (até 80 caracteres), por exemplo "conta principal".

#### Clique em Adicionar
O recebedor é salvo na hora e aparece na tabela com a chave mascarada e a origem **Cadastro manual**.

Também dá para chegar aqui pelo botão **Cadastrar** da tela [Integridade de pagamento](https://docs.proteside.com/pt-BR/docs/guide/payment-integrity). Nos
métodos que aceitam cadastro manual, o formulário já abre no método certo. No Pix, a tela orienta a confirmar o que
aparece em **Recebedores vistos no seu checkout**. Como a verificação funciona no checkout está em
[Recebedores confiáveis](https://docs.proteside.com/pt-BR/docs/integration/payment-integrity#recebedores-confi%C3%A1veis-pix-key-pinning).

## Como o SDK deve reagir
*Imagem: Modo de proteção (1), nota das Regras (2), opções para a equipe técnica (3) e Salvar esta etapa (4).*

Escolha um dos cartões (1). O cartão em uso mostra **Você está aqui**.

| Modo                                              | O que acontece                                                                                                                                                     |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Monitorar** (recomendado nas primeiras semanas) | O SDK detecta e gera alertas, sem mexer na página.                                                                                                                 |
| **Bloquear**                                      | Além de alertar, o SDK reage sozinho e desfaz a adulteração na página, por exemplo removendo um script desconhecido injetado ou restaurando o código Pix original. |

Algumas detecções geram só alerta, nos dois modos. Veja
[Modo monitor e modo bloqueio](https://docs.proteside.com/pt-BR/docs/integration/configuration#modo-monitor-e-modo-bloqueio).

A nota abaixo dos cartões (2) lembra que as [Regras](https://docs.proteside.com/pt-BR/docs/guide/rules) valem nos dois modos: um script com regra de
bloqueio é barrado mesmo em **Monitorar**. O modo decide só as reações automáticas do SDK ao que não tem regra.
**Abrir Regras** leva à tela de regras.

> **Teste antes de ativar o Bloquear**
>
> No modo **Bloquear**, uma regra errada pode quebrar o checkout. Fique algumas semanas em **Monitorar**, revise os
> alertas e os scripts, e teste o **Bloquear** em uma página de pouco tráfego antes de ativar.

### Opções para a equipe técnica
O bloco recolhido **Opções para a equipe técnica** (3) reúne dois ajustes de integração.

#### Modo desenvolvedor
O **Modo desenvolvedor** pausa o SDK: ele envia só um registro de visita e não executa nenhuma proteção. Use durante
integrações e testes.

> **Não esqueça de desligar**
>
> Com o modo desenvolvedor ligado, a loja fica **sem proteção** e a [Saúde do SDK](https://docs.proteside.com/pt-BR/docs/guide/sdk-health) mostra o SDK como
> pausado. As regras de bloqueio gravadas no snippet continuam valendo, mas sem gerar nenhum evento no painel.

#### Canal de release do SDK
O **Canal de release do SDK** escolhe qual versão do SDK a loja carrega:

* `stable` (padrão): versão validada.
* `latest`: a publicação mais recente, para testar novidades antes.

> **Trocar o canal exige recolar o snippet**
>
> A tela diz que não é preciso reinstalar. Mas o canal está escrito no endereço do SDK dentro do snippet: o snippet já
> publicado continua carregando o canal antigo. Depois de trocar o canal e salvar, copie o snippet de novo em
> [Páginas e Domínios](https://docs.proteside.com/pt-BR/docs/guide/settings/pages#copiar-o-snippet) e publique.

### Salvar o passo 2
Depois de escolher o modo e ajustar as opções, clique em **Salvar esta etapa** (4).

## O que é normal no seu checkout
*Imagem: Origens de iframe e sugestões (1), containers GTM (2), service workers (3), meios detectados (4), campos extras (5) e Salvar esta etapa (6).*

No passo 3, diga ao SDK quais provedores de pagamento e ferramentas fazem parte do checkout. O que aparecer fora das
listas vira alerta. **Lista vazia significa nenhuma restrição** para aquele item. Ao terminar, clique em **Salvar esta
etapa** do passo 3.

### Origens de iframe esperadas
Hosts dos iframes de pagamento legítimos, como o do seu provedor de pagamento e o da autenticação 3DS (1). Com a
lista preenchida, o SDK alerta iframes de provedores fora dela dentro do checkout.

* Digite o host (por exemplo `checkout.psp.com`) e clique em **Adicionar** ou tecle Enter. Se você colar uma URL
  inteira, só o host é aproveitado. Use `*.` para incluir subdomínios.
* Em **Sugestões (PSPs do catálogo)**, clique em um provedor para incluí-lo. As sugestões priorizam provedores do país
  da loja, definido em [Loja](https://docs.proteside.com/pt-BR/docs/guide/settings/store#pa%C3%ADs-e-fuso-hor%C3%A1rio). Use a busca ou **Ver todos** para encontrar outros.
* Até 50 hosts.

### Containers GTM permitidos
IDs do Google Tag Manager autorizados, no formato `GTM-XXXXXXX` (2). Com a lista preenchida, containers fora dela são
bloqueados no checkout. Até 20 containers.

> **A lista de GTM bloqueia nos dois modos**
>
> A tela fala em bloqueio no modo **Bloquear**, mas, com a lista preenchida, containers fora dela são barrados também
> em **Monitorar**. Tags do Google Analytics 4 (`G-…`) e do Google Ads (`AW-…`) carregadas por JavaScript, inclusive
> pelo próprio GTM, também são bloqueadas, e não há como incluí-las na lista. Antes de preencher, confirme com quem
> cuida do marketing se a loja usa essas tags no checkout. Lembre-se também de recolar o snippet: ele guarda uma cópia
> desta lista.

### Service workers permitidos
Fica no bloco recolhido **Service workers permitidos (avançado)** (3). Informe os caminhos dos service workers
legítimos do site, como `/sw.js`. O caminho começa com `/` e não tem espaços. Com a lista preenchida, um service
worker fora dela gera alerta e, no modo **Bloquear**, é removido. Até 20 caminhos.

## Meios de pagamento detectados
No passo 4 não há métodos para marcar: o SDK reconhece sozinho os meios de pagamento lendo a página do checkout.

* **Meios de pagamento detectados** (4) mostra cada meio como **Visto no checkout** ou **Ainda não visto**. É só
  leitura. **Ver integridade de pagamento** abre [Integridade de pagamento](https://docs.proteside.com/pt-BR/docs/guide/payment-integrity).
* **Campos extras para vigiar** (5): o SDK já reconhece sozinho os campos de cartão, Pix e dados pessoais. Use
  **Seletores extras (opcional)** só para campos da sua loja com nome fora do padrão, um seletor CSS por linha. O que
  você adicionar **soma** à detecção automática; nada é desligado. Deixe vazio se os seus campos seguem o padrão.

Clique em **Salvar esta etapa** (6) para gravar os seletores.

## Aviso de ordem de instalação
O aviso de que o snippet não é o primeiro script do `<head>` não é configurado nesta tela. Se a sua plataforma não
permite colocar o snippet no topo, use **Não avisar mais nesta loja** no próprio alerta. Veja
[Alertas](https://docs.proteside.com/pt-BR/docs/guide/alerts#parar-o-aviso-de-ordem-de-instala%C3%A7%C3%A3o).

## Próximos passos
- [Configuração do SDK](https://docs.proteside.com/pt-BR/docs/integration/configuration): O efeito de cada ajuste no navegador, em detalhe.
- [Integridade de pagamento e Pix](https://docs.proteside.com/pt-BR/docs/integration/payment-integrity): Como o SDK valida códigos Pix, boletos e endereços cripto.
