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

| Estado | Significado |
|---|---|
| SDK activo | Sesiones reales de clientes reportaron recientemente. |
| SDK no detectado | Todavía no se recibió ningún evento. |
| Solo verificación sintética | Solo el verificador sintético de Proteside envió eventos. Todavía ningún cliente real pasó por el checkout con el SDK. |
| SDK silencioso | Hay historial, pero ninguna sesión de cliente reciente. 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
version: '1.2.0',
installationOrderValid: true // false = hay un script antes del snippet
}| Resultado | Qué significa |
|---|---|
Proteside is not defined | El 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 segundos | Falta el data-key, la clave tiene un formato inválido o el shield.js se cargó como type="module". |
installationOrderValid: false | Hay algún script antes del snippet. Consulta Solución de problemas. |
Si el modo desarrollador está activado, la Salud del SDK muestra SDK en pausa (modo desarrollador).
Snippet completo
Abre el código fuente de la página publicada (Ctrl+U) y comprueba que el bloque entre <!-- Proteside Start --> y
<!-- Proteside End --> sea el primer elemento del <head> y tenga las dos etiquetas: el <script> inline del
bootstrapper y la etiqueta del shield.js.
Solicitudes de red
En la pestaña Red (Network), filtra por proteside:
| Solicitud | Respuesta esperada |
|---|---|
shield.js desde cdn.proteside.com | 200 |
Solicitudes a app.proteside.com | éxito (2xx), unos segundos después de la carga |
Un error 4xx indica un problema de clave o de cuenta: revisa la Salud del SDK. Si cambiaste la clave, copia el snippet actual en Páginas y Dominios.
Qué esperar en los primeros minutos
- Primeros segundos:
initialized: trueen la consola y las primeras solicitudes aapp.proteside.com. - Hasta 30 segundos: recarga el dashboard. El indicador superior pasa a Proteside activo y la página aparece en Páginas detectadas.
- 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.
- 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.