Personalización del certificado (V2)

Cada Validación completa de INE (V2) genera un Certificado de Verificación en PDF con el resultado de la validación. Con el parámetro custom_branding puedes adaptarlo a la imagen de tu empresa: sus colores y tu logo en la portada.

Qué puedes personalizar

custom_branding es un objeto con tres campos. Todos son opcionales: manda solo los que quieras cambiar y el resto se queda con el diseño estándar.

Campo	Tipo	Qué cambia en el certificado	Formato
primary_color	`String`	Títulos, líneas divisorias y encabezados de sección.	Color hexadecimal de 3 o 6 dígitos: `#0A58CA` o `#FFF`. El `#` es opcional.
secondary_color	`String`	Fondo de la cabecera de las tablas.	Igual que `primary_color`.
logo	`String`	Logo en el encabezado de la primera página.	Una URL pública `https://` o una imagen en base64 (máximo 256 KB). Ver abajo.

Formato del logo

Puedes mandar el logo de dos formas:

URL pública https://, por ejemplo https://cdn.mi-empresa.com/logo.png. Tiene que ser https: las URLs http:// se rechazan. Debe poder descargarse desde internet; no se aceptan URLs que apunten a redes internas o privadas.
Imagen en base64, como data URI (data:image/png;base64,iVBORw0...) o solo la cadena base64. El texto base64 completo no puede pasar de 256 KB.

Cómo usarlo

Agrega custom_branding al cuerpo de la solicitud a la V2:

{
    "ine_front": "data:image/png;base64,iVBORw0KGgoAAAANS....",
    "ine_back": "data:image/png;base64,iVBORw0KGgoAAAANS....",
    "selfie": "data:image/png;base64,iVBORw0KGgoAAAANS....",
    "custom_branding": {
        "primary_color": "#F54927",
        "secondary_color": "#8C2511",
        "logo": "https://cdn.mi-empresa.com/logo.png"
    }
}

curl -X POST https://api.verificamex.com/identity/v2/validations/basic \
  -H "Authorization: Bearer {TU_TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "ine_front": "data:image/png;base64,...",
    "ine_back": "data:image/png;base64,...",
    "selfie": "data:image/png;base64,...",
    "custom_branding": {
      "primary_color": "#F54927",
      "secondary_color": "#8C2511",
      "logo": "https://cdn.mi-empresa.com/logo.png"
    }
  }'

{
    "ine_front": "data:image/png;base64,iVBORw0KGgoAAAANS....",
    "ine_back": "data:image/png;base64,iVBORw0KGgoAAAANS....",
    "custom_branding": {
        "primary_color": "0A58CA"
    }
}

La personalización se aplica a esa validación. No se guarda como configuración de tu cuenta, así que si quieres que todos tus certificados salgan con tu marca, manda custom_branding en cada solicitud.

Errores de validación

Si algún campo de custom_branding no cumple el formato, la solicitud se rechaza con 422 antes de procesar las imágenes, así que no se consumen tokens. El mensaje indica qué campo corregir.

{
    "message": "The given data was invalid.",
    "errors": {
        "custom_branding.primary_color": [
            "El color primario debe estar en formato hexadecimal (ej. #0A58CA o #FFF)."
        ]
    }
}

{
    "message": "The given data was invalid.",
    "errors": {
        "custom_branding.logo": [
            "El logo debe ser una URL https válida o una imagen en Base64."
        ]
    }
}

{
    "message": "The given data was invalid.",
    "errors": {
        "custom_branding.logo": [
            "El logo en Base64 excede el máximo de 256 KB. Usa una imagen más ligera o una URL https."
        ]
    }
}

Mensaje	Motivo
El color primario debe estar en formato hexadecimal (ej. #0A58CA o #FFF).	`primary_color` no es un color hexadecimal de 3 o 6 dígitos.
El color secundario debe estar en formato hexadecimal (ej. #F5F5F5 o #FFF).	`secondary_color` no es un color hexadecimal de 3 o 6 dígitos.
El logo debe ser una URL https válida o una imagen en Base64.	El logo es una URL `http://`, una URL mal formada o un base64 inválido.
El logo en data URI debe ir en Base64 (ej. data:image/png;base64,…).	Mandaste un data URI que no está codificado en base64.
El logo en Base64 excede el máximo de 256 KB. Usa una imagen más ligera o una URL https.	La imagen en base64 pasa del límite.

Solo en la V2

/v2/validations/basic: no está disponible en la V1 (síncrona ni asíncrona).

Sin costo extra

Personalizar el certificado no consume tokens adicionales.

Por validación

Se aplica solo a la validación en la que lo mandas; no se guarda en tu cuenta.

Todo es opcional

Manda solo los campos que quieras cambiar; el resto queda con el diseño estándar.