Proteside Docs

Protección del pago

En cuatro pasos, indica quién puede recibir el dinero de la tienda, cómo debe reaccionar el SDK, qué es normal en el checkout y qué campos extra vigilar.

Ajustes → Protección del pago define cómo se comporta el SDK en el checkout de la tienda seleccionada. La pantalla está dividida en cuatro pasos numerados:

  1. Quién puede recibir tu dinero: los destinatarios confiables.
  2. Cómo debe reaccionar el SDK: monitorear o bloquear.
  3. Qué es normal en tu checkout: proveedores de pago, contenedores GTM y service workers esperados.
  4. Medios de pago detectados: lo que el SDK ya reconoció y los campos extra para vigilar.

Los cambios llegan a las páginas por la configuración remota del SDK, sin tocar el sitio, con una excepción: el canal de release. Los detalles técnicos están en Configuración del SDK.

Antes de empezar

  • Solo los propietarios y administradores modifican esta pantalla. Los demás roles ven todo, pero sin los botones de edición, y la franja de la parte superior avisa "Solo propietarios y administradores pueden modificar estos ajustes."
  • Los destinatarios (paso 1) se guardan al instante.
  • Los pasos 2, 3 y 4 se guardan por separado. Cada uno tiene su propio botón Guardar esta etapa y muestra Guardado o Modificado · sin guardar. Guarda un paso antes de salir de la pantalla.
  • Los cambios llegan al SDK en pocos minutos. Para probar un cambio, espera algunos minutos y recarga el checkout. Todo cambio guardado queda registrado en el Registro de auditoría.

Quién puede recibir tu dinero

Paso 1 de la pantalla Protección del pago con Cómo funciona la verificación, Destinatarios vistos en tu checkout con los botones Es de mi tienda y No lo reconozco, la tabla Destinatarios confiables y el formulario Registrar manualmente
Cómo funciona la verificación (1), destinatarios vistos (2), destinatarios confiables (3) y registro manual (4).

Los destinatarios confiables son las claves y cuentas que reciben los pagos de tu tienda. El SDK verifica el destinatario de cada Pix, boleto, QR o billetera que aparece en el checkout y alerta cuando aparece alguien fuera de la lista.

Sin ningún destinatario registrado, el SDK registra quién aparece en el checkout, pero no alerta sobre destinatarios desconocidos. Por eso este es el paso más importante de la pantalla.

Cómo funciona la verificación (1) abre un resumen de cómo se verifica el destinatario en cada tipo de código.

Confirma los destinatarios vistos en el checkout

La lista Destinatarios vistos en tu checkout (2) muestra los destinatarios que el SDK encontró en el checkout y que todavía no confirmaste. Para cada uno ves el método, el destinatario enmascarado, cuántas veces se vio y cuándo.

  • Haz clic en Es de mi tienda para incluirlo en la lista de destinatarios confiables.
  • Haz clic en No lo reconozco si el destinatario no es tuyo. Esto abre una alerta crítica Destinatario no reconocido en Alertas. Trátala como un incidente.

Si la lista está vacía, haz un pedido de prueba en el checkout: el destinatario aparece enseguida.

Pix generado por un proveedor de pago

Cuando el Pix de la tienda lo genera un proveedor (Mercado Pago, Pagar.me, PagBank y otros), la clave que usa el código no suele ser la que conoces. En ese caso, mejor confirma lo que aparece en Destinatarios vistos en tu checkout en lugar de registrar la clave a mano.

Destinatarios confiables

La tabla Destinatarios confiables (3) lista lo que ya está aprobado, con las columnas Método, Destinatario, Origen (Registro manual o Visto en el checkout), Etiqueta, Agregada el y Activa.

  • Usa el interruptor Activa para desactivar un destinatario sin borrarlo.
  • Para eliminarlo, haz clic en el icono del bote de basura y confirma con Eliminar en la misma fila, o haz clic en Cancelar.

Proteside no guarda la clave en claro. Por eso no es posible ver ni editar la clave después de guardarla. Para cambiarla, registra la nueva y elimina la anterior.

Registrar manualmente

Usa Registrar manualmente (4) cuando conoces la clave o la cuenta que recibe.

Elige el método

Haz clic en Registrar manualmente para abrir el formulario y elige el Método: Pix, Boleto, Billetera cripto, UPI (India), PayNow (Singapur), PromptPay (Tailandia), DuitNow (Malasia), QR Ph (Filipinas), HK FPS (Hong Kong) o Transferencias 3.0 (Argentina).

Ingresa la clave

El campo Clave muestra debajo el formato aceptado para el método elegido. Algunos ejemplos:

  • Pix: CPF, CNPJ, correo, teléfono (+55…) o clave aleatoria.
  • Boleto: pega la línea digitable de un boleto emitido por la tienda.
  • Billetera cripto: pega la dirección de la billetera. No hace falta elegir la moneda: la pantalla muestra Red detectada con la red reconocida por el formato de la dirección.
  • UPI: VPA con el formato nombre@banco.

Si quieres, completa una Etiqueta (hasta 80 caracteres), por ejemplo "cuenta principal".

Haz clic en Agregar

El destinatario se guarda al instante y aparece en la tabla con la clave enmascarada y el origen Registro manual.

También puedes llegar aquí con el botón Registrar de la pantalla Integridad de Pagos. En los métodos que aceptan registro manual, el formulario ya abre en el método correcto. En Pix, la pantalla te orienta a confirmar lo que aparece en Destinatarios vistos en tu checkout. Cómo funciona la verificación en el checkout está en Destinatarios confiables.

Cómo debe reaccionar el SDK

Paso 2 de la pantalla Protección del pago con las tarjetas Monitorear y Bloquear, la nota sobre las Reglas con el enlace Abrir Reglas, Opciones para el equipo técnico y el botón Guardar esta etapa
Modo de protección (1), nota de las Reglas (2), opciones para el equipo técnico (3) y Guardar esta etapa (4).

Elige una de las tarjetas (1). La tarjeta en uso muestra Estás aquí.

ModoQué ocurre
Monitorear (recomendado en las primeras semanas)El SDK detecta y genera alertas, sin tocar la página.
BloquearAdemás de alertar, el SDK reacciona solo y deshace la manipulación en la página, por ejemplo quitando un script desconocido inyectado o restaurando el código Pix original.

Algunas detecciones solo generan una alerta, en los dos modos. Consulta Modo monitoreo y modo bloqueo.

La nota debajo de las tarjetas (2) recuerda que las Reglas valen en los dos modos: un script con regla de bloqueo se detiene incluso en Monitorear. El modo solo decide las reacciones automáticas del SDK ante lo que no tiene regla. Abrir Reglas lleva a la pantalla de reglas.

Prueba antes de activar Bloquear

En el modo Bloquear, una regla incorrecta puede romper el checkout. Quédate algunas semanas en Monitorear, revisa las alertas y los scripts, y prueba Bloquear en una página de poco tráfico antes de activarlo.

Opciones para el equipo técnico

El bloque plegado Opciones para el equipo técnico (3) reúne dos ajustes de integración.

Modo desarrollador

El Modo desarrollador pausa el SDK: envía solo un registro de visita y no ejecuta ninguna protección. Úsalo durante las integraciones y las pruebas.

No olvides desactivarlo

Con el modo desarrollador activado, la tienda queda sin protección y la Salud del SDK muestra el SDK en pausa. Las reglas de bloqueo guardadas en el snippet siguen valiendo, pero sin generar ningún evento en el panel.

Canal de release del SDK

El Canal de release del SDK elige qué versión del SDK carga la tienda:

  • stable (predeterminado): versión validada.
  • latest: la publicación más reciente, para probar novedades antes.

Cambiar el canal exige volver a pegar el snippet

La pantalla dice que no es necesario reinstalar. Pero el canal está escrito en la dirección del SDK dentro del snippet: el snippet ya publicado sigue cargando el canal anterior. Después de cambiar el canal y guardar, copia el snippet de nuevo en Páginas y Dominios y publícalo.

Guardar el paso 2

Después de elegir el modo y ajustar las opciones, haz clic en Guardar esta etapa (4).

Qué es normal en tu checkout

Pasos 3 y 4 de la pantalla Protección del pago con Orígenes de iframe esperados y las sugerencias de proveedores, Contenedores GTM permitidos, Service workers permitidos, Medios de pago detectados, Campos extra para vigilar y los botones Guardar esta etapa
Orígenes de iframe y sugerencias (1), contenedores GTM (2), service workers (3), medios detectados (4), campos extra (5) y Guardar esta etapa (6).

En el paso 3, dile al SDK qué proveedores de pago y herramientas forman parte del checkout. Lo que aparezca fuera de las listas se convierte en alerta. Una lista vacía significa que no hay ninguna restricción para ese elemento. Al terminar, haz clic en Guardar esta etapa del paso 3.

Orígenes de iframe esperados

Hosts de los iframes de pago legítimos, como el de tu proveedor de pago y el de la autenticación 3DS (1). Con la lista completa, el SDK alerta sobre los iframes de proveedores que no están en ella dentro del checkout.

  • Escribe el host (por ejemplo checkout.psp.com) y haz clic en Agregar o presiona Enter. Si pegas una URL completa, solo se usa el host. Usa *. para incluir subdominios.
  • En Sugerencias (PSPs del catálogo), haz clic en un proveedor para incluirlo. Las sugerencias dan prioridad a los proveedores del país de la tienda, definido en Tienda. Usa la búsqueda o Ver todos para encontrar otros.
  • Hasta 50 hosts.

Contenedores GTM permitidos

IDs de Google Tag Manager autorizados, con el formato GTM-XXXXXXX (2). Con la lista completa, los contenedores que no están en ella se bloquean en el checkout. Hasta 20 contenedores.

La lista de GTM bloquea en los dos modos

La pantalla habla de bloqueo en el modo Bloquear, pero, con la lista completa, los contenedores que no están en ella también se detienen en Monitorear. Las etiquetas de Google Analytics 4 (G-…) y de Google Ads (AW-…) cargadas por JavaScript, incluso por el propio GTM, también se bloquean, y no hay forma de incluirlas en la lista. Antes de completarla, confirma con quien se encarga del marketing si la tienda usa esas etiquetas en el checkout. Recuerda también volver a pegar el snippet: guarda una copia de esta lista.

Service workers permitidos

Está en el bloque plegado Service workers permitidos (avanzado) (3). Ingresa las rutas de los service workers legítimos del sitio, como /sw.js. La ruta empieza con / y no tiene espacios. Con la lista completa, un service worker que no está en ella genera una alerta y, en el modo Bloquear, se quita. Hasta 20 rutas.

Medios de pago detectados

En el paso 4 no hay métodos para marcar: el SDK reconoce solo los medios de pago leyendo la página del checkout.

  • Medios de pago detectados (4) muestra cada medio como Visto en el checkout o Aún no visto. Es solo de lectura. Ver integridad de pago abre Integridad de Pagos.
  • Campos extra para vigilar (5): el SDK ya reconoce solo los campos de tarjeta, Pix y datos personales. Usa Selectores extra (opcional) solo para campos de tu tienda con nombres fuera del estándar, un selector CSS por línea. Lo que agregues se suma a la detección automática; nada se desactiva. Déjalo vacío si tus campos siguen el estándar.

Haz clic en Guardar esta etapa (6) para guardar los selectores.

Aviso de orden de instalación

El aviso de que el snippet no es el primer script del <head> no se configura en esta pantalla. Si tu plataforma no permite colocar el snippet arriba de todo, usa No avisar más en esta tienda en la propia alerta. Consulta Alertas.

Próximos pasos

En esta página