Proteside Docs

Verificar la instalación

Confirma en el dashboard y en la consola del navegador que el SDK está activo en el checkout.

Después de publicar el snippet, abre la página de checkout de la tienda en un navegador. En pocos segundos el SDK empieza a reportar. Usa los tres puntos de abajo para confirmar que todo está bien.

En el dashboard

Indicador superior

En la parte superior del dashboard (en la versión para computadora) hay un indicador de estado del SDK:

  • Proteside Activo (verde): la tienda tiene tráfico real reciente del SDK.
  • Proteside no detectado (rojo): no hay tráfico real reciente.

El indicador es un enlace a Ajustes → Páginas y Dominios. Ahí, la sección Páginas detectadas lista cada página que ya envió eventos, agrupada por dominio, con la insignia SDK activo (actividad en las últimas 24 horas) o No detectado.

Salud del SDK

La página Salud del SDK muestra si el SDK está reportando tráfico real de clientes, separado de la verificación sintética.

Página Salud del SDK con la franja de estado, los dominios con tráfico real, las métricas de 48 horas, el gráfico de eventos por hora, las versiones del SDK y la configuración
EstadoSignificado
SDK activoSesiones reales de clientes reportaron en las últimas 24 horas.
SDK no detectadoTodavía no se recibió ningún evento.
Solo verificación sintéticaSolo el verificador sintético de Proteside envió eventos. Todavía ningún cliente real pasó por el checkout con el SDK.
SDK silenciosoHay historial, pero ninguna sesión de cliente en las últimas 24 horas. Verifica si el snippet sigue publicado.
SDK en pausa (modo desarrollador)El modo desarrollador está activado y el SDK no ejecuta protecciones.

La página también muestra los Dominios con tráfico real, los totales de las últimas 48 horas, el gráfico Eventos por hora, las Versiones del SDK vistas en los últimos 7 días y la configuración actual (canal, modo desarrollador y modo de protección). Los datos se agregan por hora: recarga la página para actualizarla.

Más detalles en Salud del SDK.

En el navegador

Abre el checkout, abre las herramientas para desarrolladores (F12) y usa la pestaña Consola (Console).

Estado del SDK

Proteside.getStatus()

Respuesta esperada, unos segundos después de la carga:

{
  initialized: true,          // el SDK terminó de iniciar
  mode: 'monitor',            // o 'block'
  paused: false,              // true = modo desarrollador, suscripción inactiva o pausa local
  channel: 'stable',
  calibrating: true,          // true en los primeros 30 s (calibración)
  activeThreats: 0,
  paymentMethodsMonitored: ['pix', 'card'],
  version: '1.1.1',
  installationOrderValid: true, // false = hay un script antes del bootstrapper
  overlayCheckIntervalMs: 2000,
  rulesApplied: false,
  recipientsPinned: 1,        // n.º de destinatarios confiables recibidos
  cardCheckoutOpen: false,
  cardCheckoutProvider: null
}
ResultadoQué significa
Proteside is not definedEl shield.js no cargó. Revisa si el snippet está publicado, si la CSP permite cdn.proteside.com y si un bloqueador de anuncios no interfirió.
initialized: false durante más de unos segundosFalta el data-key, la clave tiene un formato inválido o el shield.js se cargó como type="module".
paused: trueModo desarrollador activado, suscripción inactiva o tienda suspendida.
installationOrderValid: falseHay algún script antes del bootstrapper. Consulta Solución de problemas.

Bootstrapper presente

El estado no indica si el bootstrapper está en la página. Si solo se pegó el shield.js, el SDK funciona con cobertura reducida e installationOrderValid sigue en true. Para comprobarlo:

typeof window.__PROTE_BOOT_TS__ === 'number' // true = el bootstrapper se ejecutó

Solicitudes de red

En la pestaña Red (Network), filtra por proteside:

SolicitudRespuesta esperada
GET cdn.proteside.com/v1/shield.js200
GET app.proteside.com/api/sdk/config?key=pk_live_…200
POST app.proteside.com/api/sdk/events202, unos segundos después de la carga

Un 401 en /config o /events indica una clave inválida o cambiada hace más de 24 horas. En ese caso el SDK sigue funcionando con los valores predeterminados locales, pero ningún evento llega al dashboard.

Qué esperar en los primeros minutos

  1. Primeros segundos: initialized: true en la consola y el primer POST /events.
  2. Hasta 30 segundos: recarga el dashboard. El indicador superior pasa a Proteside Activo y la página aparece en Páginas detectadas.
  3. Primeros minutos: los scripts de la página aparecen en Scripts con el estado Requiere revisión. Revisa y autoriza los legítimos; consulta Scripts.
  4. Cuando un cliente pague: las tarjetas de Integridad de Pagos pasan de ESPERANDO a INTACTO a medida que se valida cada método. Consulta Integridad de pagos y Pix.

El gráfico de Salud del SDK se agrega por hora. Un evento recién enviado puede tardar unos minutos en aparecer ahí, aunque el indicador superior ya esté en verde.

Próximos pasos

En esta página