Saltar al contenido principal

Integracion con Iframe

La forma mas simple de integrar Trusty es embebiendo un iframe en tu pagina.

URL del widget​

https://trusty.sh/verify?public_token=TR_PUB_xxx&lang=es&metadata=...

Parametros​

ParametroRequeridoDescripcion
public_tokenSiTu token de cliente (TR_PUB_xxx)
langNoIdioma del widget: es o en. Default: en
metadataNoJSON con datos que quieres que pasen al webhook (ej: {"userId":"123"})

Ejemplo HTML​

<iframe
  src="https://trusty.sh/verify?public_token=TR_PUB_xxx&lang=es&metadata=%7B%22userId%22%3A%22123%22%7D"
  style="width:100%;max-width:420px;height:640px;border:0"
  allow="camera">
</iframe>

Atributos del iframe​

  • allow="camera" — obligatorio para acceder a la camara
  • Dimensiones recomendadas: 420px ancho x 640px alto
  • Sin borde (border:0) para integracion limpia

Metadata​

La metadata viaja intacta desde el iframe hasta el webhook. Puedes enviar cualquier JSON:

{"userId": "123", "session_id": "abc456", "plan": "premium"}

La metadata se guarda en la verificacion y se devuelve en el webhook y en la API de consulta.

Cross-device (QR)​

Si el usuario abre el widget en desktop sin camara, Trusty muestra un codigo QR. El usuario lo escanea con su telefono y la verificacion continua ahi. El desktop se actualiza automaticamente cada 2 segundos via polling.

No necesitas hacer nada extra — el flujo QR es automatico.