1

Integraciones / APIs

APIs y Webhooks

Activo

Los 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étodoEndpointDescripciónEstado
GET/binkio/identities/:queryConsulta de identidad verificada por Binkio ID, correo o teléfonoActivo
GET/binkio/accounts/:id/transactionsMovimientos de una cuenta Binkio conectadaActivo
POST/incode/sessionsInicia sesión de verificación KYC / KYB / UBOActivo
GET/incode/sessions/:idResultado y referencia de la verificaciónActivo
POST/transactionsAlta manual de operaciones (otros bancos, efectivo, otros medios)Activo
POST/ubo/:companyId/nodesAlta de accionistas y cálculo de control efectivoActivo
POST/risk/scoreScore de riesgo por cliente y operaciónPróximamente
POST/alertsGeneración de alertas y casosPróximamente

Webhooks

Eventos entrantes con verificación de firma

EventoDescripción
identity.verifiedIncode concluyó una verificación con resultado aprobado
identity.reviewLa verificación requiere revisión manual
account.transaction.createdNuevo movimiento en una cuenta Binkio conectada
ubo.updatedCambió la estructura societaria de una empresa

Variables de entorno requeridas

VariableUso
BINKIO_API_URLBase de la API de Binkio
BINKIO_API_KEYAutenticación de consultas de identidad y cuentas
INCODE_API_URLBase de la API de Incode
INCODE_API_KEYAutenticación de sesiones de verificación
INCODE_FLOW_IDFlujo configurado para KYC / KYB / UBO
Sin credenciales configuradas, los módulos operan en modo demostración con datos simulados y lo indican en pantalla.