Guías prácticas para integrar con confianza.
Referencia de la API
REST · OpenAPI 3.1 · X-API-Key
OpenAPI / Swagger
Explore el contrato sin ejecutar llamadas.
API KYC: de la identificación al resultado
Comprenda la integración KYC, el recorrido alojado, los eventos y las responsabilidades de su sistema.
Integre su primer recorrido KYC
Cree una transacción desde su servidor, derive al recorrido alojado y consulte el resultado con ejemplos de la API KYC.
Integre KYC con su agente de IA
Prepare su integración KYC con prompts, contexto público, ocho lenguajes y documentación por MCP.
Autenticación y protección de las claves de API
Utilice X-API-Key desde el backend, aísle el Tenant y el entorno y prepare la rotación de credenciales KYC.
Entornos y configuración de la integración KYC
Separe credenciales, URLs, callbacks y datos por entorno sin confundir ejemplos locales con servicios operativos.
Cree una transacción de verificación de identidad
Conozca los campos de creación, los identificadores de correlación y la respuesta 201 de la API KYC.
Derive a la persona al recorrido alojado
Utilice los enlaces devueltos por la API KYC, proteja la privacidad y acompañe el recorrido desde su backend.
Interprete resultados, decisiones y estados KYC
Distinga la etapa operativa de la decisión y trate pendientes, aprobación, rechazo, vencimiento y revisión manual.
Idempotencia: repita la creación sin duplicar la transacción
Utilice Idempotency-Key para repetir el mismo POST y trate los conflictos sin duplicar transacciones.
Reciba webhooks y acompañe los eventos KYC
Configure el callback, valide la firma, deduplique por event_id y consulte el estado actual de la transacción.
Valide la firma HMAC de los webhooks
Valide timestamp y HMAC SHA-256 sobre los bytes originales con ejemplos TypeScript y Python y comparación segura.
Reentrega, duplicados y conciliación de eventos
Diseñe un consumidor tolerante a fallos con event_id, persistencia duradera y consulta del estado actual mediante GET.
Descarga autorizada de documentos, assets y evidencias
Consulte los cuatro endpoints de archivos KYC, el permiso document_download, la autorización por IP y la protección de datos.
Errores y diagnóstico de la integración KYC
Identifique fallos de validación, autenticación, permisos, transacción e idempotencia sin exponer datos personales.
Límites del contrato y buenas prácticas de integración
Aplique límites documentados de campos, timeouts, concurrencia controlada y minimización de datos en su integración KYC.
Lista para llevar su integración KYC a producción
Revise acceso, seguridad de webhooks, decisiones, recuperación y protección de datos antes de liberar su integración.
Historial y evolución del contrato público KYC
Acompañe la versión del contrato público y revise ejemplos, consumidores y cambios antes de actualizar su integración.
Ejemplos de API y descargas para integrar KYC
Descargue OpenAPI y Postman y consulte ejemplos de creación en Node.js, TypeScript y Python sin credenciales reales.
Explore el simulador local de KYC
Aprenda a interpretar escenarios KYC sintéticos en el navegador, sin credenciales, cargas ni llamadas a la API real.