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.
Configurações → Proteção do pagamento define como o SDK se comporta no checkout da loja selecionada. A tela é dividida em quatro passos numerados:
- Quem pode receber o seu dinheiro: os recebedores confiáveis.
- Como o SDK deve reagir: monitorar ou bloquear.
- O que é normal no seu checkout: provedores de pagamento, containers GTM e service workers esperados.
- 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. Os detalhes técnicos estão em Configuração do SDK.
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.
Quem pode receber o seu dinheiro

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. 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. 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.
Como o SDK deve reagir

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.
A nota abaixo dos cartões (2) lembra que as Regras 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 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 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

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