Integraciones / APIs
APIs y Webhooks
ActivoLos contratos que conectan Compliance con Binkio e Incode. Las credenciales viven como variables de entorno del servidor.
Endpoints
Toda comunicación externa se ejecuta en el servidor; el navegador nunca ve las llaves
| Método | Endpoint | Descripción | Estado |
|---|---|---|---|
| GET | /binkio/identities/:query | Consulta de identidad verificada por Binkio ID, correo o teléfono | Activo |
| GET | /binkio/accounts/:id/transactions | Movimientos de una cuenta Binkio conectada | Activo |
| POST | /incode/sessions | Inicia sesión de verificación KYC / KYB / UBO | Activo |
| GET | /incode/sessions/:id | Resultado y referencia de la verificación | Activo |
| POST | /transactions | Alta manual de operaciones (otros bancos, efectivo, otros medios) | Activo |
| POST | /ubo/:companyId/nodes | Alta de accionistas y cálculo de control efectivo | Activo |
| POST | /risk/score | Score de riesgo por cliente y operación | Próximamente |
| POST | /alerts | Generación de alertas y casos | Próximamente |
Webhooks
Eventos entrantes con verificación de firma
| Evento | Descripción |
|---|---|
| identity.verified | Incode concluyó una verificación con resultado aprobado |
| identity.review | La verificación requiere revisión manual |
| account.transaction.created | Nuevo movimiento en una cuenta Binkio conectada |
| ubo.updated | Cambió la estructura societaria de una empresa |
Variables de entorno requeridas
| Variable | Uso |
|---|---|
| BINKIO_API_URL | Base de la API de Binkio |
| BINKIO_API_KEY | Autenticación de consultas de identidad y cuentas |
| INCODE_API_URL | Base de la API de Incode |
| INCODE_API_KEY | Autenticación de sesiones de verificación |
| INCODE_FLOW_ID | Flujo configurado para KYC / KYB / UBO |
Sin credenciales configuradas, los módulos operan en modo demostración con datos simulados y lo indican en pantalla.