Todos los productos
Search
Centro de documentos

ID Verification:Web SDK - H5 UI custom configuration instructions

Última actualización: Sep 05, 2026

El Web SDK - H5 admite la personalización del estilo de la interfaz. Puede personalizar los colores, los íconos y los estilos de los marcos en la página de guía, la página de captura de documentos, la página de edición de resultados de OCR y la página de detección de vida.

Importante

La personalización de la interfaz para el Web SDK - H5 solo está disponible en el modo de integración móvil. Para personalizar la PC, consulte Web SDK - PC UI Custom Configuration Instructions.

Método de configuración

Pase una cadena JSON con sus estilos personalizados al campo StyleConfig del método Initialize del lado del servidor.

Reglas y recomendaciones de configuración:

  • Herencia predeterminada: si no se especifica un elemento de configuración o su propiedad de estilo, el sistema utiliza el valor predeterminado.

  • Configuración incremental: para reducir el tamaño del cuerpo de la solicitud, pase únicamente los elementos de configuración que necesite modificar. Los elementos no especificados conservan sus valores predeterminados.

Nota

La cadena JSON no debe contener caracteres especiales de expresiones regulares.

Página de guía (guidePage)

La página de guía es la primera página que ven los usuarios y muestra los pasos e instrucciones de verificación. Esta página solo está disponible en el flujo del Web SDK.

Property

Type

Default

Description

backgroundColor

Color CSS

"white"

Color de fondo de la página

btnBgColor

Color CSS

"#fb5d01"

Color de fondo del botón

btnTextColor

Color CSS

"white"

Color del texto del botón

btnShadow

CSS box-shadow

"0 16px 32px 0 rgba(251, 115, 38, 0.3)"

Sombra del botón

circle1Img

URL de imagen

""

Ícono del paso 1 en la página de guía de eKYC (60 x 60 px)

circle2Img

URL de imagen

""

Ícono del paso 2 en la página de guía de eKYC (60 x 60 px)

leftBorderImg

URL de imagen

""

Barra conectora de pasos en el lado izquierdo de la página de guía de eKYC (6 x 414 px)

faceImg

URL de imagen

""

Ilustración de reconocimiento facial (393 x 393 px)

ocrImg

URL de imagen

""

Ilustración de escaneo de documentos (396 x 393 px)

shelterFromImg

URL de imagen

""

Ilustración para evitar oclusiones (210 x 210 px)

lightImg

URL de imagen

""

Ilustración de iluminación adecuada (210 x 210 px)

phoneImg

URL de imagen

""

Ilustración de posicionamiento del celular (210 x 210 px)

Página de captura de documentos (ocrPage)

En esta página, los usuarios fotografían sus documentos de identidad (credenciales, pasaportes y documentos similares). Puede personalizar el fondo, la superposición, el marco del visor y los íconos.

Property

Type

Default

Description

ocrBgColor

CSS rgba

"rgba(2, 2, 2, 0.8)"

Color de fondo y opacidad de la página

tipColor

Color CSS

"white"

Color del texto sobre la superposición

maskColor

CSS rgba

"rgba(2, 2, 2, 0.7)"

Color y opacidad de la superposición

backIconImg

URL de imagen

""

Ícono para salir (30 x 54 px)

submitIconImg

URL de imagen

""

Ícono para enviar (240 x 240 px)

ocrPhotoBorderImg

URL de imagen

""

Marco del visor de documentos (996 x 594 px). Reemplace este valor para adaptar el marco a distintas formas y colores de credenciales y pasaportes.

albumIconImg

URL de imagen

""

Ícono del álbum (144 x 144 px)

Página de edición de resultados de OCR (ocrResultPage)

Esta página muestra los datos extraídos del documento y permite a los usuarios revisar y corregir los resultados.

Property

Type

Default

Description

backgroundColor

Color CSS

"white"

Color de fondo de la página

topTipBgColor

Color CSS

"white"

Color de fondo de la sugerencia superior

topTipTextColor

Color CSS

"black"

Color del texto de la sugerencia superior

ocrTextColor

Color CSS

"#333333"

Color del texto de la información de OCR

inputBgColor

Color CSS

"#f7f7f7"

Color de fondo del campo de entrada

btnBgColor

Color CSS

"#fb5d01"

Color de fondo del botón

btnTextColor

Color CSS

"white"

Color del texto del botón

maskColor

CSS rgba

"rgba(2, 2, 2, 0.7)"

Color y opacidad de la superposición

backIconImg

URL de imagen

""

Ícono para salir (30 x 54 px)

Página de detección de vida (facePage)

La página de detección de vida guía a los usuarios durante el proceso de verificación facial.

Property

Type

Default

Description

backgroundColor

Color CSS

"white"

Color de fondo de la página

topTipColor

Color CSS

"#333333"

Color del texto del título (para el mensaje de instrucción, como "Tome su celular y parpadee")

processBarColor

Arreglo de 3 colores CSS

["#FFA500", "#FF8C00", "rgba(237,119,49,1)"]

Colores de la barra de progreso alrededor del visor, de claro a oscuro

maskColor

CSS rgba

"rgba(0, 0, 0, 0.6)"

Color y opacidad de la superposición

maskTipColor

Color CSS

"white"

Color del texto sobre la superposición

backIconImg

URL de imagen

""

Ícono para salir (30 x 54 px)

Especificaciones de los recursos de imagen

Todas las propiedades de imagen aceptan URL de acceso público. Las imágenes de reemplazo deben coincidir con las dimensiones que se indican a continuación.

Property

Page

Dimensions (px)

Description

circle1Img

Guía

60 x 60

Ícono del paso 1

circle2Img

Guía

60 x 60

Ícono del paso 2

leftBorderImg

Guía

6 x 414

Barra conectora de pasos

faceImg

Guía

393 x 393

Ilustración de reconocimiento facial

ocrImg

Guía

396 x 393

Ilustración de escaneo de documentos

shelterFromImg

Guía

210 x 210

Ilustración para evitar oclusiones

lightImg

Guía

210 x 210

Ilustración de iluminación adecuada

phoneImg

Guía

210 x 210

Ilustración de posicionamiento del celular

ocrPhotoBorderImg

Captura de documentos

996 x 594

Marco del visor de documentos

albumIconImg

Captura de documentos

144 x 144

Ícono del álbum

submitIconImg

Captura de documentos

240 x 240

Ícono para enviar

backIconImg

Captura de documentos, edición de resultados de OCR, detección de vida

30 x 54

Ícono para salir

Plantilla de configuración

Copie la siguiente plantilla y modifique únicamente las propiedades que desee personalizar.

const styleConfig = {
  guidePage: {
    backgroundColor: "white",
    btnBgColor: "#fb5d01",
    btnTextColor: "white",
    btnShadow: "0 16px 32px 0 rgba(251, 115, 38, 0.3)",
    circle1Img: "",
    circle2Img: "",
    leftBorderImg: "",
    faceImg: "",
    ocrImg: "",
    shelterFromImg: "",
    lightImg: "",
    phoneImg: ""
  },
  ocrPage: {
    ocrBgColor: "rgba(2, 2, 2, 0.8)",
    tipColor: "white",
    maskColor: "rgba(2, 2, 2, 0.7)",
    backIconImg: "",
    submitIconImg: "",
    ocrPhotoBorderImg: "",
    albumIconImg: ""
  },
  ocrResultPage: {
    backgroundColor: "white",
    topTipBgColor: "white",
    topTipTextColor: "black",
    ocrTextColor: "#333333",
    inputBgColor: "#f7f7f7",
    btnBgColor: "#fb5d01",
    btnTextColor: "white",
    maskColor: "rgba(2, 2, 2, 0.7)",
    backIconImg: ""
  },
  facePage: {
    backgroundColor: "white",
    topTipColor: "#333333",
    processBarColor: ["#FFA500", "#FF8C00", "rgba(237,119,49,1)"],
    maskColor: "rgba(0, 0, 0, 0.6)",
    maskTipColor: "white",
    backIconImg: ""
  }
};
{
  "guidePage": {
    "backgroundColor": "white",
    "btnBgColor": "#fb5d01",
    "btnTextColor": "white",
    "btnShadow": "0 16px 32px 0 rgba(251, 115, 38, 0.3)",
    "circle1Img": "",
    "circle2Img": "",
    "leftBorderImg": "",
    "faceImg": "",
    "ocrImg": "",
    "shelterFromImg": "",
    "lightImg": "",
    "phoneImg": ""
  },
  "ocrPage": {
    "ocrBgColor": "rgba(2, 2, 2, 0.8)",
    "tipColor": "white",
    "maskColor": "rgba(2, 2, 2, 0.7)",
    "backIconImg": "",
    "submitIconImg": "",
    "ocrPhotoBorderImg": "",
    "albumIconImg": ""
  },
  "ocrResultPage": {
    "backgroundColor": "white",
    "topTipBgColor": "white",
    "topTipTextColor": "black",
    "ocrTextColor": "#333333",
    "inputBgColor": "#f7f7f7",
    "btnBgColor": "#fb5d01",
    "btnTextColor": "white",
    "maskColor": "rgba(2, 2, 2, 0.7)",
    "backIconImg": ""
  },
  "facePage": {
    "backgroundColor": "white",
    "topTipColor": "#333333",
    "processBarColor": [
      "#FFA500",
      "#FF8C00",
      "rgba(237,119,49,1)"
    ],
    "maskColor": "rgba(0, 0, 0, 0.6)",
    "maskTipColor": "white",
    "backIconImg": ""
  }
}