Onboarding contiene la revisión Know Your Customer de una Entity: información de la empresa, representante legal, perfil transaccional, accionistas y documentos. Creas un onboarding por cada Entity, completas cada paso y documento, y envías el onboarding para que Fintoc lo revise.
El objeto Onboarding tiene estos atributos:
| Campo | Tipo | Descripción |
|---|---|---|
id | string | Identificador único del onboarding. |
object | string | El tipo del objeto, que siempre es onboarding. |
data | object | Datos revisados de cada paso completado, indexados por la clave del paso. |
documents | array | Espacios de documentos a lo largo de cada paso, con su estado de carga. Consulta el objeto OnboardingDocument. |
entity_id | string | Identificador de la Entity a la que pertenece este onboarding. null si el onboarding no está asociado a una Entity. |
reviewed_at | string | Fecha y hora en UTC (ISO 8601) en que Fintoc revisó el onboarding. null hasta que Fintoc revise el onboarding. |
shareholders | array | Accionistas declarados para la Entity. Consulta el objeto OnboardingShareholder. |
source | string | Canal por el que se completó el onboarding. Uno de api o dashboard. |
status | string | Estado actual del onboarding. Uno de pending, in_progress, submitted, approved, rejected o cancelled. |
submittable | boolean | Indica si el onboarding tiene todos los pasos y documentos requeridos completados. |
submitted_at | string | Fecha y hora en UTC (ISO 8601) en que enviaste el onboarding para revisión. null hasta que envíes el onboarding. |
Objeto Onboarding Shareholder
El objetoOnboardingShareholder tiene estos atributos:
| Campo | Tipo | Descripción |
|---|---|---|
id | string | Identificador único del accionista. |
object | string | El tipo del objeto, que siempre es onboarding_shareholder. |
document | object | Espacio del documento de identificación del accionista. Consulta el objeto OnboardingDocument. |
holder_id | string | RFC mexicano del accionista. null si no se proporcionó. |
last_name | string | Apellido. Solo está presente cuando type es natural_person. |
name | string | Nombre de pila de una persona física, o razón social de una persona moral. |
parent_id | string | Identificador del accionista padre cuando está anidado. null para accionistas raíz. |
percentage | number | Porcentaje de participación del accionista, de 0 a 100. |
type | string | Tipo de accionista. Uno de natural_person o legal_entity. |
Objeto Onboarding Document
El objetoOnboardingDocument tiene estos atributos:
| Campo | Tipo | Descripción |
|---|---|---|
filename | string | Nombre original del documento cargado. Solo está presente cuando status es uploaded. |
slot_key | string | Clave que identifica el espacio del documento. |
status | string | Estado del espacio del documento. Uno de uploaded o missing. |
uploaded_at | string | Fecha y hora en UTC (ISO 8601) en que cargaste el documento. Solo está presente cuando status es uploaded. |
Onboarding object
{
"id": "onbprc_0ujsswThIGTUYm2K8FjOOfXtY1K",
"object": "onboarding",
"data": {
"company_information": {
"legal_name": "Test Company 1"
}
},
"documents": [
{
"filename": "csf.pdf",
"slot_key": "tax_registration_certificate",
"status": "uploaded",
"uploaded_at": "2026-01-15T14:30:00Z"
}
],
"entity_id": "ent_8anBwgZktbZH6ydyHa6Tm0eM",
"reviewed_at": null,
"shareholders": [
{
"id": "onbsh_0ujsswThIGTUYm2K8FjOOfXtY1K",
"object": "onboarding_shareholder",
"document": {
"filename": "ine.pdf",
"slot_key": "identification",
"status": "uploaded",
"uploaded_at": "2026-01-15T14:30:00Z"
},
"holder_id": "AAAA010101AAA",
"last_name": "Customer",
"name": "Test Customer 1",
"parent_id": null,
"percentage": 76,
"type": "natural_person"
}
],
"source": "api",
"status": "in_progress",
"submittable": false,
"submitted_at": null
}