Proteside Docs

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:

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

Passo 1 da tela Proteção do pagamento com Como a verificação funciona, Recebedores vistos no seu checkout com os botões É da minha loja e Não reconheço, a tabela Recebedores confiáveis e o formulário Cadastrar manualmente
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. 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

Passo 2 da tela Proteção do pagamento com os cartões Monitorar e Bloquear, a nota sobre as Regras com o link Abrir Regras, Opções para a equipe técnica e o botão Salvar esta etapa
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.

ModoO que acontece
Monitorar (recomendado nas primeiras semanas)O SDK detecta e gera alertas, sem mexer na página.
BloquearAlé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

Passos 3 e 4 da tela Proteção do pagamento com Origens de iframe esperadas e as sugestões de provedores, Containers GTM permitidos, Service workers permitidos, Meios de pagamento detectados, Campos extras para vigiar e os botões Salvar esta etapa
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. 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.

Próximos passos

Nesta página