Onboarding contiene la revisión Know Your Customer de una Entity: información de la empresa, representantes legales, perfil transaccional, accionistas y documentos. Los campos dentro de data, y los espacios de documentos, dependen de type y del país de la Entity. 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. Los account holders chilenos devuelven company_basics, company_information, senior_management, transactional_profile y plaft. Los account holders mexicanos devuelven company_information y transactional_profile. Consulta Onboarding de account holder. |
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. |
legal_representatives | array | Representantes legales declarados para la Entity. Consulta el objeto OnboardingLegalRepresentative. |
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. |
type | string | Tipo de onboarding. Uno de account_holder (la Entity puede ser titular de objetos Account) o settlement_recipient (la Entity recibe su parte de los pagos divididos). |
Objeto Onboarding Legal Representative
El objetoOnboardingLegalRepresentative tiene estos atributos:
| Campo | Tipo | Descripción |
|---|---|---|
id | string | Identificador único del representante legal. |
object | string | Siempre onboarding_legal_representative. |
documents | array | Slots de documentos del representante: identification_front e identification_back en Chile, o identification y power_of_attorney en México. Consulta el objeto OnboardingDocument. |
email | string | Correo electrónico del representante legal. |
first_name | string | Nombre de pila del representante legal. |
identification_number | string | Número de identificación del representante legal: un Rol Único Tributario (RUT) de persona natural o un número de pasaporte en Chile, o la Clave Única de Registro de Población (CURP) en México. |
last_name | string | Apellido del representante legal. |
nationality | string | Código de país ISO 3166-1 alfa-2 de dos letras de la nacionalidad del representante legal, en minúsculas. |
phone | string | Teléfono de contacto en formato E.164. null si no se proporcionó. Solo está presente en onboardings de account holder chilenos. |
position | string | Cargo que ocupa el representante legal en la empresa. Puede ser null en onboardings de account holder chilenos. |
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. |
address | string | Dirección del accionista. Solo está presente en onboardings de account holder chilenos. |
document | object | Espacio del documento del accionista. Consulta el objeto OnboardingDocument. null cuando el país no exige documento por accionista, como en Chile. |
effective_controller | boolean | Si es true, el accionista es controlador efectivo de la empresa. Solo está presente en onboardings de account holder chilenos. |
fiscal_address | string | Domicilio tributario del accionista. Solo está presente en onboardings de account holder chilenos. |
holder_id | string | Identificador fiscal del accionista: el Rol Único Tributario (RUT) u otro número de identificación en Chile, o el Registro Federal de Contribuyentes (RFC) en México. 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 |
|---|---|---|
id | string | Identificador único del documento cargado. Solo está presente cuando status es uploaded. Envíalo a DELETE .../documents/{slot_key}/{document_id} para eliminar el archivo. |
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": {
"business_activity": "Servicios financieros",
"sector": "ecommerce"
}
},
"documents": [
{
"id": "onbdoc_3cpDyiBmvdBJ8a0aJc8Vo2gO",
"filename": "csf.pdf",
"slot_key": "tax_registration_certificate",
"status": "uploaded",
"uploaded_at": "2026-01-15T14:30:00Z"
}
],
"entity_id": "ent_8anBwgZktbZH6ydyHa6Tm0eM",
"legal_representatives": [
{
"id": "onblr_0ujsswThIGTUYm2K8FjOOfXtY1K",
"object": "onboarding_legal_representative",
"documents": [
{
"id": "onbdoc_4dqEzjCnweCK9b1bKd9Wp3hP",
"filename": "ine.pdf",
"slot_key": "identification",
"status": "uploaded",
"uploaded_at": "2026-01-15T14:30:00Z"
}
],
"email": "rep@example.com",
"first_name": "Test Customer 1",
"identification_number": "AAAA010101HDFAAA01",
"last_name": "Customer",
"nationality": "mx",
"position": "Director General"
}
],
"reviewed_at": null,
"shareholders": [
{
"id": "onbsh_0ujsswThIGTUYm2K8FjOOfXtY1K",
"object": "onboarding_shareholder",
"document": {
"id": "onbdoc_5erFakDoxfDL0c2cLe0Xq4iQ",
"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,
"type": "account_holder"
}