Accounts
Las cuentas y su compliance — el punto de entrada de cada persona y empresa.
Ámbito: Plataforma — disponible para todo tenant del API.
Toda relación con el dinero empieza en una cuenta. Accounts es el dominio donde nacen las cuentas de tus usuarios — personas y empresas — y donde se declara qué tan verificadas están.
Hoy
- Cuentas — crear, listar, obtener y resolver un destinatario por alias o teléfono.
- Compliance — declarar la verificación (KYC): un hecho fechado con fuente, no un switch de permisos.
La regla de la plataforma es una sola y no tiene excepciones: una cuenta sin verificar recibe pero no envía. El dinero entrante nunca se rechaza por papeles; el saliente siempre los exige.
Qué significa cada estado, por qué una cuenta puede quedar retenida y qué haces con ella: verificación y cumplimiento.
El titular que el cumplimiento exige
Detrás de una cuenta hay un titular, y el screening de cumplimiento no puede trabajar con un nombre pegado. Desde el 9-sep-2026 el dominio Accounts compone y expone, sobre la cuenta, cuatro datos que antes no daba:
| Dato | Qué es |
|---|---|
nombres | Los nombres de pila, separados del apellido |
apellidos | Los apellidos, separados del nombre |
paisResidencia | ISO del país donde vive — se evalúa contra la lista de países prohibidos |
paisNacimiento | ISO del país donde nació — se evalúa contra la lista GAFI |
Los cuatro pueden venir en null, y null no es un bug. Nunca se derivan:
los nombres no salen de partir el nombre legal por los espacios, porque "Ana María
Pérez Gómez" puede ser dos nombres y dos apellidos o uno y tres, y un screening
contra el nombre equivocado devuelve "limpio" sobre otra persona — que parece
un screening hecho. Un dato que no se puede afirmar viaja null, el cumplimiento
lo lee como "no sé" y retiene. Retener a alguien de quien no sabemos lo suficiente
cuesta una revisión; aprobarlo con un dato adivinado cuesta un sancionado adentro.
La lectura de una cuenta nunca falla por esto: si la fuente de identidad no
contesta, los cuatro campos van en null y el resto de la cuenta responde igual.
Superficie interna, por ahora. Estos cuatro campos viven en el servicio de cuentas de la plataforma, no en
api.tikin.is: no están en la referencia de arriba ni en elAccountque devuelve obtener una cuenta. Se documentan acá porque son el contrato del dominio Accounts y quien integra dentro del dominio los consume. El día que lleguen al API de tenants se anuncian en el changelog, como cualquier otro cambio de contrato.
Lo que viene
Verificación con más niveles que verified, y el compliance de empresas (KYB)
como recurso propio (roadmap).