Rendimiento y compatibilidad
Tamaño del SDK, forma de carga, solicitudes extra, impacto en el checkout y navegadores compatibles.
El SDK está hecho para no retrasar el checkout: la parte síncrona es pequeña y no usa la red, y el resto se carga de forma asíncrona. Esta página muestra los números reales y lo que hace el SDK en cada carga.
Tamaño
| Parte | Tamaño sin compresión | Tamaño con gzip | Cómo se carga |
|---|---|---|---|
| Bootstrapper | 4,3 KB | ~1,9 KB | Inline en el HTML, síncrono. |
SDK shield.js | 60 KB | ~19,6 KB | Archivo de la CDN, con async. La CDN lo entrega con Brotli (~17 KB). |
El bootstrapper aumenta el HTML de cada página en unos 4,3 KB antes de la compresión de tu servidor. El shield.js
queda en caché en el navegador y en la CDN (1 hora en el canal stable, 5 minutos en latest).
Carga
- Bootstrapper: se ejecuta en menos de 1 ms y no hace ninguna solicitud. Solo instala los puntos de observación.
shield.js: se carga conasyncy no bloquea el parser ni el renderizado de la página.- Inicialización: el SDK espera la configuración remota como máximo 2 segundos antes de iniciar las detecciones. El checkout no espera al SDK.
El SDK está construido para nunca romper la página: todo el código se ejecuta protegido contra errores, y los envíos de telemetría no bloquean nada.
Solicitudes por carga de página
| Solicitud | Cuándo | Observación |
|---|---|---|
GET cdn.proteside.com/v1/shield.js | 1 vez | Por lo general viene de la caché. |
GET app.proteside.com/api/sdk/config | 1 vez | Puede venir de la caché durante 60 segundos. |
GET de la propia página | 1 vez, y en cada pageChanged() | Lee los headers de seguridad. Consulta el aviso en CSP y headers. |
GET de los scripts externos de la página | hasta 20, con un límite total de 1,5 s | Para calcular el hash del contenido. Usa la caché del navegador siempre que es posible. |
POST app.proteside.com/api/sdk/events | aproximadamente cada 5 s, mientras haya eventos | Lotes de hasta 50 eventos; un último envío cuando el cliente sale de la página. |
Procesamiento continuo
Mientras la página está abierta, el SDK:
- verifica las superposiciones sobre los campos de pago cada 2 segundos (ajustable en Verificación de overlay (ms), mínimo de 500 ms);
- comprueba los códigos de pago mostrados en el mismo intervalo;
- busca códigos de pago en el texto de la página cada 2 segundos durante el primer minuto;
- observa los cambios en la página para detectar scripts y códigos de pago nuevos.
En páginas con muchos elementos, un intervalo de overlay mayor reduce el trabajo periódico. Mantén el valor predeterminado si no tienes un motivo para cambiarlo.
Navegadores compatibles
| Navegador | Versión mínima |
|---|---|
| Chrome | 80 |
| Edge | 80 |
| Firefox | 78 |
| Safari | 14 |
Usa HTTPS en el checkout
El cálculo de hashes depende de una API del navegador que solo existe en páginas HTTPS. En HTTP, el SDK sigue funcionando, pero sin hash del contenido de los scripts, sin verificación de destinatarios confiables y sin lectura de los headers de seguridad.