Proteside Docs

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

ParteTamaño sin compresiónTamaño con gzipCómo se carga
Bootstrapper4,3 KB~1,9 KBInline en el HTML, síncrono.
SDK shield.js60 KB~19,6 KBArchivo 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 con async y 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

SolicitudCuándoObservación
GET cdn.proteside.com/v1/shield.js1 vezPor lo general viene de la caché.
GET app.proteside.com/api/sdk/config1 vezPuede venir de la caché durante 60 segundos.
GET de la propia página1 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áginahasta 20, con un límite total de 1,5 sPara calcular el hash del contenido. Usa la caché del navegador siempre que es posible.
POST app.proteside.com/api/sdk/eventsaproximadamente cada 5 s, mientras haya eventosLotes 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.

NavegadorVersión mínima
Chrome80
Edge80
Firefox78
Safari14

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.

Próximos pasos

En esta página