Guía para desarrolladores de e-KYC Now

Tipos de flujo

Flujo básico

Diseñado para escenarios de incorporación de bajo riesgo en los que la velocidad es una prioridad.
Este flujo verifica la autenticidad de los documentos de identidad emitidos por el gobierno utilizando bases de datos globales.

Premium Flow (el más seguro)

Nuestro flujo de verificación más seguro.
Combina la verificación de documentos con la detección biométrica de la vitalidad y la detección de AML para mejorar el cumplimiento y la prevención del fraude.

Una vez creado el flujo, se generará un ID de flujo para los flujos Básico y Premium.

Este ID de flujo es obligatorio para la integración de la API y debe pasarse a los encabezados de la solicitud al invocar las API de KYC.

‍

Generar clave de API

• Navegue hasta la sección Guía para desarrolladores de la consola y haga clic en Generar clave de API.
• Copie y almacene de forma segura la clave de API generada, ya que será necesaria para todas las solicitudes de API.
• Mantenga la confidencialidad de la clave de API en todo momento; si queda expuesta, perdida o comprometida, genere inmediatamente una nueva clave.
• Tenga en cuenta que solo se permite una clave de API activa a la vez, y la generación de una nueva clave invalidará automáticamente la anterior.

Uso de Trial Flow

Para realizar pruebas, puede utilizar la función Trial Flow disponible en la consola.

• Para empezar, copia la clave de API de prueba de la sección Guía para desarrolladores.

Navegue hasta la página Administrar flujos y haga clic en el icono «+» del flujo deseado.

• Complete los detalles requeridos y haga clic en Generar. Tras la generación correcta, se proporcionará una URL de redireccionamiento de KYC.

Nota: La URL generada es válida solo durante 30 minutos y debe usarse exclusivamente con fines de prueba. No compartas esta URL, ya que es de un solo uso y tiene un límite de tiempo. Solo tiene cinco (5) intentos de prueba gratuitos permitidos. Cada vez que se genera una URL de prueba, se consume un intento de prueba.

Ejemplo de URL de prueba

https://ekyc-staging.messagecentral.com/kyc/flow/aEzRTHuaJcwda4WtETc119_S-ljpyGpeo0aLzz4705w

Nota: Las URL de prueba de ejemplo se generan con un ID de flujo predefinido.

No modifique ni sustituya este ID de flujo por otro flujo, ya que puede provocar errores inesperados y un consumo innecesario de créditos de prueba.

Generar URL desde la API

Punto final

PUBLICAR https://ekyc.messagecentral.com/ekyc/api/v1/redirection/generate-url

Autenticación, encabezados y cuerpo

Debes pasar los siguientes encabezados y cuerpos con cada solicitud:

Ejemplo de encabezados y cuerpo

flow_id: hfbiyufq 9o9aauftbmkri9khpXLstafflbvg64jzim

api_key: Portador <YOUR API KEY>

nombre_empresa: <YOUR COMPANY NAME>

Tipo de contenido: application/json

Ejemplo de cURL

curl --location 'https://ekyc.messagecentral.com/ekyc/api/v1/redirection/generate-url' \

--header flow_id: FLOW_ID \

--header api_key: Bearer YOUR_API_KEY \

--form company_name="YOUR_COMPANY_NAME"

Nota: Los flow_id y api_key que se muestran en este ejemplo son solo para fines de demostración. Debes reemplazarlos por tus propios valores generados desde la consola. Nunca expongas tu clave de API en aplicaciones del lado del cliente.

Respuesta

Respuesta exitosa (200 OK)

{

 "url": "https://ekyc.messagecentral.com/kyc/flow HfBIyufQ-9O9AauFtBMKRi9kHPXlStAfFlbvg64JzIM",

 "token": "HfBIyufQ-9O9AauFtBMKRi9kHPXlStAfFlbvg64JzIM",

 "journey_id": "M17682023316961BQG_SE",

 "expires_in_minutes": 30,

 "message": "Embed this URL in your application for KYC verification"

}

Explicación de los campos de respuesta

Nota: La URL generada caduca tras el tiempo especificado. Debe volver a generarla después de que caduque.

Respuestas de error (401 no autorizadas)

1. Falta el nombre de la empresa

{
 "detail": "Missing company name in Header"
}

Asegúrese de que company_name esté presente en el cuerpo de la solicitud.

2. Formato de clave de API no válido

{

 "detail": "API Key must be 'Bearer '"

}

Asegúrese de que la clave de API tenga el prefijo Bearer.

3. Falta el ID de flujo

{

 "detail": "Missing flow_id header/query."

}

Asegúrese de que flow_id se envíe en los encabezados de la solicitud.

Pautas de seguridad y uso (importante)

Esta API se debe llamar exclusivamente desde tu servidor backend.

NO llame a esta API desde aplicaciones frontend

No llame a esta API directamente desde:

• Navegador (React, Angular, Vue, etc.)
• Aplicaciones móviles (Android/iOS)
• JavaScript del lado del cliente

Exponer esta API en la interfaz puede filtra tu clave de API, lo que puede dar lugar a un acceso no autorizado y a un uso indebido.

Mejores prácticas de seguridad

Guarda siempre tu api_key en:

• Variables de entorno
• Administradores secretos (AWS Secrets Manager, Vault, etc.)

Rote las claves de API periódicamente

Regenere las URL solo cuando sea necesario (las URL tienen un límite de tiempo)

Nota de limitación o abuso de velocidad

Nota: Las solicitudes excesivas o abusivas pueden tener una velocidad limitada para garantizar la estabilidad de la plataforma.

Si tiene preguntas e inquietudes, ¡comuníquese con nosotros!

support@messagecentral.com

https://www.messagecentral.com/

Preguntas frecuentes