Onboarding de account holder

account_holder es el tipo de onboarding para abrir la Entity de un cliente como titular de cuenta. Una vez que Fintoc aprueba la revisión, la Entity puede ser titular de objetos Account. Esta página documenta, para cada país, el esquema que envías en data al crear un onboarding account_holder y los slots de documentos que abre el onboarding. Para el flujo completo, desde crear la Entity hasta enviarla a revisión, sigue Onboarding de una entidad por API. Esta página cubre solo lo que es específico del tipo account_holder.

Disponibilidadaccount_holder admite empresas en Chile y México. El country_code de la Entity selecciona el esquema: revisa Chile o México. Crear un onboarding account_holder para una Entity de cualquier otro país devuelve 422 Unprocessable Entity con el código country_not_supported. Una Entity cuyo holder_id identifica a una persona natural devuelve 422 Unprocessable Entity con el código holder_type_not_supported.

La estructura de la solicitud

Envía type y data en el primer nivel de la solicitud de creación. Las claves dentro de data dependen del país, y todas son obligatorias:

{
  "type": "account_holder",
  "data": {
    "company_basics": { },
    "company_information": { },
    "senior_management": { "senior_management": [ ] },
    "legal_representatives": [ ],
    "shareholders": [ ],
    "transactional_profile": { },
    "plaft": { }
  }
}

{
  "type": "account_holder",
  "data": {
    "company_information": { },
    "legal_representatives": [ ],
    "transactional_profile": { },
    "shareholders": [ ]
  }
}

La referencia de la API describe data como un objeto de forma libre, porque su estructura depende de type y del país; esta página es el esquema de account_holder.

Errores de validación

Una solicitud con datos inválidos devuelve 400 Bad Request con un solo error, aunque fallen varios campos. Corrige el campo reportado y reenvía para encontrar el siguiente. param indica el campo que falla con su ruta completa, con un punto por cada clave anidada y corchetes por cada índice de arreglo, por ejemplo legal_representatives[0].email. Algunos errores llevan un code:

`code`	Causa
`invalid_enum`	Un valor fuera de la lista aceptada. El error lista los valores aceptados.
`invalid_rut`	Un Rol Único Tributario (RUT) chileno que no pasa la validación. Solo en Chile.
`invalid_shareholder_structure`	Un árbol de accionistas que rompe una regla de estructura. El campo `reason` indica la regla.
`missing_parameter`	Un campo obligatorio que la solicitud omite.

Otros errores de validación, como un arreglo legal_representatives vacío, devuelven 400 Bad Request con param en el campo que falla y sin code.

Chile

Un onboarding account_holder chileno envía siete bloques en data: company_basics, company_information, senior_management, legal_representatives, shareholders, transactional_profile y plaft. El equipo de cumplimiento de Fintoc revisa los documentos y las respuestas descritos en los requisitos Know Your Customer (KYC) en Chile.

company_basics

Cómo se constituyó la empresa y el nombre con el que opera:

Campo	Tipo	Obligatorio	Descripción
`fantasy_name`	string	Opcional	Nombre de fantasía de la empresa. Acepta `null`. En modo `test`, este campo también selecciona el resultado de la revisión simulada. Revisa Forzar el resultado de la revisión.
`incorporation_type`	string	Obligatorio	Forma de constitución. Uno de `one_day_company` (registrada en Empresa en un Día) o `traditional` (constituida ante notario). Selecciona los slots de documentos de la empresa.

Cuando incorporation_type es one_day_company, Fintoc verifica al enviar el onboarding que el RUT de la empresa esté registrado como Empresa en un Día. Si la empresa no lo está, el envío devuelve 422 Unprocessable Entity con el código not_one_day_company.

company_information

La actividad, la estructura legal y las direcciones de la empresa. Todos los campos son obligatorios:

Campo	Tipo	Obligatorio	Descripción
`activities_start_date`	string	Obligatorio	Fecha de inicio de actividades de la empresa ante el Servicio de Impuestos Internos (SII), como fecha ISO 8601, por ejemplo `2019-03-01`.
`business_activity_code`	string	Obligatorio	Código de actividad económica de seis dígitos del catálogo del SII, por ejemplo `620200`. Un código fuera del catálogo devuelve `invalid_enum`.
`business_address`	string	Obligatorio	Dirección física donde opera la empresa.
`company_type`	string	Obligatorio	Tipo societario de la empresa. Uno de `colectiva` (Sociedad Colectiva), `eirl` (Empresa Individual de Responsabilidad Limitada), `en_comandita` (Sociedad en Comandita), `ltda` (Sociedad de Responsabilidad Limitada), `sa` (Sociedad Anónima) o `spa` (Sociedad por Acciones).
`fiscal_address`	string	Obligatorio	Domicilio tributario registrado ante el SII.

senior_management

La alta gerencia de la empresa. senior_management es un objeto con una sola clave, también llamada senior_management, que contiene un arreglo de miembros. Declara al menos un miembro. Todos los campos son obligatorios en cada miembro:

Campo	Tipo	Obligatorio	Descripción
`identification_number`	string	Obligatorio	Número de identificación del miembro. Debe ser un RUT válido cuando `nationality` es `cl`; si no, devuelve `invalid_rut`.
`name`	string	Obligatorio	Nombre completo del miembro.
`nationality`	string	Obligatorio	Código de país ISO 3166-1 alfa-2 de dos letras de la nacionalidad del miembro, en mayúsculas o minúsculas. La respuesta devuelve el valor en minúsculas.
`position`	string	Obligatorio	Cargo que ocupa el miembro en la empresa, por ejemplo `Gerente General`.

Un arreglo vacío devuelve 400 Bad Request con param en senior_management.senior_management.

legal_representatives

Las personas autorizadas para actuar en nombre de la empresa. Declara al menos una. Fintoc no impone un máximo:

Campo	Tipo	Obligatorio	Descripción
`email`	string	Obligatorio	Correo electrónico del representante legal, en formato RFC 5322.
`first_name`	string	Obligatorio	Nombre de pila del representante legal.
`identification_number`	string	Obligatorio	RUT de persona natural para un chileno, o número de pasaporte para un extranjero. Un RUT de empresa devuelve `invalid_rut` cuando `nationality` es `cl`. Debe ser único dentro del onboarding.
`last_name`	string	Obligatorio	Apellido del representante legal.
`nationality`	string	Obligatorio	Código de país ISO 3166-1 alfa-2 de dos letras de la nacionalidad del representante, en mayúsculas o minúsculas. La respuesta devuelve el valor en minúsculas.
`phone`	string	Opcional	Teléfono de contacto en formato E.164, por ejemplo `+56911111111`. Acepta `null`.
`position`	string	Opcional	Cargo que ocupa el representante legal en la empresa. La respuesta devuelve `null` cuando lo omites.

Un arreglo vacío devuelve 400 Bad Request con param en legal_representatives. Dos representantes legales con el mismo identification_number devuelven 400 Bad Request con param en la segunda entrada, por ejemplo legal_representatives[1].identification_number.

shareholders

El árbol de propiedad de la empresa. Declara al menos un accionista; un arreglo vacío devuelve invalid_shareholder_structure con reason en shareholders_required. Cada nodo del árbol, en la raíz y a cualquier profundidad, acepta estos campos:

Campo	Tipo	Obligatorio	Descripción
`address`	string	Obligatorio	Dirección del accionista.
`children`	arreglo de accionistas	Opcional, solo `legal_entity`	Accionistas que son dueños de este accionista. Envía esto solo cuando `type` es `legal_entity`.
`effective_controller`	boolean	Obligatorio	Si es `true`, el accionista es controlador efectivo de la empresa. Envía un boolean JSON.
`fiscal_address`	string	Obligatorio	Domicilio tributario del accionista registrado ante el SII.
`holder_id`	string	Obligatorio	Número de identificación del accionista. Debe ser un RUT válido cuando `nationality` es `cl`; si no, devuelve `invalid_rut`.
`last_name`	string	Opcional, solo `natural_person`	Apellido del accionista. Envía esto solo cuando `type` es `natural_person`. Enviarlo para un `legal_entity` devuelve `invalid_shareholder_structure` con `reason` en `invalid_name`.
`name`	string	Obligatorio	Nombre de pila cuando `type` es `natural_person`, o razón social cuando `type` es `legal_entity`.
`nationality`	string	Obligatorio	Código de país ISO 3166-1 alfa-2 de dos letras de la nacionalidad del accionista.
`percentage`	number	Obligatorio	Participación que tiene el accionista, de `0` a `100`. Envía un número JSON; la API rechaza un número como string.
`type`	string	Obligatorio	Tipo de accionista. Uno de `natural_person` o `legal_entity`.

Cuatro reglas restringen el árbol. Cada error de estructura devuelve el código invalid_shareholder_structure, con reason en el valor entre paréntesis:

Cada nivel suma 100 o menos. Chile no fija una suma mínima. Un nivel por encima de 100 falla (shareholder_participation_exceeded).
Solo un legal_entity anida. Un natural_person que lleve children falla (only_legal_entity_can_nest). Fintoc no impone un límite de profundidad de anidamiento.
Cada holder_id es único dentro de su nivel. Dos accionistas en la raíz, o bajo el mismo padre, con el mismo holder_id fallan (duplicate_shareholder). El mismo holder_id puede aparecer en niveles distintos.
Al menos un controlador efectivo. Fintoc revisa esta regla al enviar el onboarding, no al crearlo. Si ningún accionista tiene effective_controller: true, el envío devuelve 422 Unprocessable Entity con el código effective_controller_required.

transactional_profile

El origen del patrimonio y de los fondos de la empresa, y cómo usa Fintoc. Todos los campos son obligatorios, y cada uno es un arreglo que recibe al menos un valor:

Campo	Tipo	Obligatorio	Descripción
`business_relationship_purposes`	arreglo de string	Obligatorio	Formas en que la empresa usa Fintoc. Valores en la tabla siguiente.
`equity_origins`	arreglo de string	Obligatorio	Origen del patrimonio de la empresa. Valores en la tabla siguiente.
`resource_origins`	arreglo de string	Obligatorio	Origen de los fondos que la empresa mueve con Fintoc. Valores en la tabla siguiente.

business_relationship_purposes acepta estos valores:

Valor de `business_relationship_purposes`	Propósito
`customer_collections`	Recaudar pagos de clientes.
`customer_payouts`	Pagar fondos a clientes.
`payroll_payments`	Pagar remuneraciones.
`supplier_payments`	Pagar a proveedores.
`tax_payments`	Pagar impuestos.
`treasury_management`	Gestionar la tesorería de la empresa.

equity_origins acepta estos valores:

Valor de `equity_origins`	Origen del patrimonio
`asset_sales`	Producto de la venta de activos.
`capital_contributions`	Aportes de capital de los socios.
`external_financing`	Financiamiento bancario o de terceros.
`inheritance_or_donations`	Herencias o donaciones.
`investment_returns`	Rentas de inversiones.
`retained_earnings`	Utilidades retenidas.

resource_origins acepta estos valores:

Valor de `resource_origins`	Origen de los fondos
`asset_sales`	Producto de la venta de activos.
`capital_contributions`	Aportes de capital.
`donations_or_subsidies`	Donaciones o subsidios.
`external_financing`	Financiamiento bancario o de terceros.
`investment_returns`	Rentas de inversiones.
`operating_income`	Ingresos operacionales de la empresa.

Un valor fuera de estas listas, incluido un valor mexicano como trusts, devuelve invalid_enum.

plaft

La declaración de la empresa sobre prevención del lavado de activos y del financiamiento del terrorismo (PLAFT):

Campo	Tipo	Obligatorio	Descripción
`uaf_obligated`	boolean	Obligatorio	Si es `true`, la empresa debe reportar a la Unidad de Análisis Financiero (UAF), y el onboarding exige los slots `uaf_registration_certificate` y `plaft_manual_and_policies`.

Slots de documentos chilenos

Crear el onboarding abre cada slot de la empresa que selecciona company_basics.incorporation_type, y cada uno reporta missing hasta que subes un archivo. El tamaño máximo es 20 MB en todos los slots. Fintoc lee el tipo de contenido de un slot de la empresa a partir de los bytes del archivo, y cada slot de la empresa acepta solo application/pdf. El arreglo documents del primer nivel lista estos slots de la empresa:

`slot_key`	Se abre cuando	Obligatorio para enviar	Archivos	Documento
`activities_start_certificate`	`incorporation_type` es `traditional`	Sí	Uno	Certificado de inicio de actividades del SII.
`current_shareholders_certificate`	`incorporation_type` es `one_day_company`	Sí	Uno	Certificado de accionistas vigentes del Registro de Empresas y Sociedades.
`e_rut`	Siempre	Sí	Uno	Cédula RUT electrónica (e-RUT) de la empresa emitida por el SII.
`good_standing_certificate`	`incorporation_type` es `traditional`	Sí	Uno	Certificado de vigencia con anotaciones marginales, emitido en los últimos 90 días.
`incorporation_amendments`	Siempre	No	Varios	Escrituras de modificación y sus publicaciones en el Diario Oficial.
`incorporation_deed`	Siempre	Sí	Uno	Escritura pública de constitución.
`plaft_manual_and_policies`	Siempre	Si `uaf_obligated` es `true`	Varios	Manual y políticas de prevención del lavado de activos.
`power_of_attorney`	Siempre	No	Uno	Personería que acredita los poderes de los representantes legales.
`uaf_registration_certificate`	Siempre	Si `uaf_obligated` es `true`	Uno	Certificado de registro ante la UAF.

Cada representante legal tiene su propio arreglo documents con dos slots. Fintoc revisa el Content-Type que declara la parte en estos slots, así que envíalo como uno de los tipos aceptados:

`slot_key`	Tipos de contenido aceptados
`identification_back`	`application/pdf`, `image/jpeg`, `image/png`
`identification_front`	`application/pdf`, `image/jpeg`, `image/png`

Los accionistas chilenos no tienen slot de documento. Cada accionista devuelve document en null. Una empresa traditional con uaf_obligated en false y un representante legal necesita seis archivos para enviar: e_rut, activities_start_certificate, good_standing_certificate, incorporation_deed y los dos lados de la identificación.

Ejemplo chileno

Este payload declara un representante legal, un miembro de la alta gerencia y dos accionistas en la raíz. Uno de los accionistas de la raíz anida un tercer accionista. Todos los valores son datos de prueba que no corresponden a ninguna empresa ni persona real.

{
  "type": "account_holder",
  "data": {
    "company_basics": {
      "incorporation_type": "traditional",
      "fantasy_name": "Test Company"
    },
    "company_information": {
      "activities_start_date": "2019-03-01",
      "business_activity_code": "620200",
      "company_type": "spa",
      "business_address": "Av. Apoquindo 100, Santiago",
      "fiscal_address": "Av. Apoquindo 100, Santiago"
    },
    "senior_management": {
      "senior_management": [
        {
          "name": "Test Customer 1",
          "nationality": "cl",
          "identification_number": "11.111.111-1",
          "position": "Gerente General"
        }
      ]
    },
    "legal_representatives": [
      {
        "first_name": "Test Customer 1",
        "last_name": "Customer",
        "email": "jon@snow.com",
        "nationality": "cl",
        "identification_number": "11.111.111-1",
        "position": "Representante legal",
        "phone": "+56911111111"
      }
    ],
    "shareholders": [
      {
        "type": "natural_person",
        "name": "Test Customer 1",
        "last_name": "Customer",
        "holder_id": "11.111.111-1",
        "nationality": "cl",
        "percentage": 60,
        "address": "Av. Apoquindo 100, Santiago",
        "fiscal_address": "Av. Apoquindo 100, Santiago",
        "effective_controller": true
      },
      {
        "type": "legal_entity",
        "name": "Test Entity 2",
        "holder_id": "88.888.888-8",
        "nationality": "cl",
        "percentage": 40,
        "address": "Av. Apoquindo 100, Santiago",
        "fiscal_address": "Av. Apoquindo 100, Santiago",
        "effective_controller": false,
        "children": [
          {
            "type": "natural_person",
            "name": "Test Customer 2",
            "last_name": "Customer",
            "holder_id": "22.222.222-2",
            "nationality": "cl",
            "percentage": 100,
            "address": "Av. Apoquindo 100, Santiago",
            "fiscal_address": "Av. Apoquindo 100, Santiago",
            "effective_controller": false
          }
        ]
      }
    ],
    "transactional_profile": {
      "equity_origins": ["capital_contributions"],
      "business_relationship_purposes": ["customer_collections", "supplier_payments"],
      "resource_origins": ["operating_income"]
    },
    "plaft": {
      "uaf_obligated": false
    }
  }
}

México

Un onboarding account_holder mexicano envía cuatro bloques en data: company_information, legal_representatives, transactional_profile y shareholders. El equipo de cumplimiento de Fintoc revisa los documentos y las respuestas descritos en Requisitos de KYC en México.

company_information

La identidad de la empresa y sus datos de liquidación. Todos los campos son obligatorios:

Campo	Tipo	Obligatorio	Descripción
`business_activity`	string	Obligatorio	Actividad económica principal de la empresa. En modo `test`, este campo también selecciona el resultado de la revisión simulada. Revisa Forzar el resultado de la revisión.
`business_address`	string	Obligatorio	Dirección física donde opera la empresa.
`fiscal_address`	string	Obligatorio	Dirección registrada ante la autoridad fiscal mexicana.
`incorporation_date`	string	Obligatorio	Fecha de constitución de la empresa, como fecha ISO 8601. La respuesta devuelve este valor como fecha y hora en UTC (ISO 8601).
`phone`	string	Obligatorio	Teléfono de contacto en formato E.164: un `+` inicial seguido de entre 8 y 15 dígitos, y el primero no puede ser `0`.
`sector`	string	Obligatorio	Industria en la que opera la empresa. Valores en la tabla siguiente.
`settlement_account`	string	Obligatorio	Cuenta que recibe las liquidaciones, como Clave Bancaria Estandarizada (CLABE) de 18 dígitos.

sector acepta estos valores:

Valor de `sector`	Industria
`betting_gaming`	Apuestas y juegos de azar.
`cross_border_payments`	Pagos transfronterizos.
`direct_sales`	Venta directa.
`ecommerce`	Comercio electrónico.
`education`	Educación.
`insurance`	Seguros.
`lending`	Préstamos.
`other`	Cualquier otra industria.
`property_management`	Administración de propiedades.
`psps`	Proveedores de servicios de pago.
`subscription_businesses`	Negocios de suscripción.
`telecommunications`	Telecomunicaciones.
`ticketing`	Venta de entradas.
`utilities`	Servicios básicos.
`wallets_neobanks`	Billeteras digitales y neobancos.

La validación de la CLABE cambia según el modosettlement_account debe tener 18 dígitos. Fintoc acepta el valor cuando los primeros tres dígitos corresponden a una institución mexicana soportada y el dígito de control de la CLABE es correcto. Fintoc también acepta sus propias CLABEs y en esos casos omite el dígito de control. En modo test, esto aplica a los códigos de banco de sandbox. En modo live, aplica al código de banco propio de Fintoc. Una CLABE de una institución mexicana soportada se comporta igual en ambos modos. Una CLABE de sandbox que funciona en test devuelve un error en live. Un valor inválido devuelve 400 Bad Request con param en company_information.settlement_account.

legal_representatives

Las personas autorizadas para actuar en nombre de la empresa. Declara al menos una. Fintoc no impone un máximo, y todos los campos son obligatorios en cada entrada:

Campo	Tipo	Obligatorio	Descripción
`email`	string	Obligatorio	Correo electrónico del representante legal, en formato RFC 5322.
`first_name`	string	Obligatorio	Nombre de pila del representante legal.
`identification_number`	string	Obligatorio	Clave Única de Registro de Población (CURP) del representante legal.
`last_name`	string	Obligatorio	Apellido del representante legal.
`nationality`	string	Obligatorio	Código de país ISO 3166-1 alfa-2 de dos letras de la nacionalidad del representante, en mayúsculas o minúsculas. La respuesta devuelve el valor en minúsculas.
`position`	string	Obligatorio	Cargo que ocupa el representante legal en la empresa, por ejemplo `Director General`.

Un arreglo vacío devuelve 400 Bad Request con param en legal_representatives. Una entrada inválida devuelve param con el índice de la entrada que falla, por ejemplo legal_representatives[0].email.

transactional_profile

El volumen, el origen y el propósito del dinero que la Entity espera mover:

Campo	Tipo	Obligatorio	Descripción
`account_purpose`	string	Obligatorio	Uso principal de la cuenta. Valores en la tabla siguiente.
`account_purpose_details`	string	Obligatorio si `account_purpose` es `other`	Descripción de cómo usa la cuenta la empresa. Omitirlo cuando `account_purpose` es `other` devuelve `400 Bad Request` con `param` en `transactional_profile.account_purpose_details`.
`monthly_amount_range`	string	Obligatorio	Monto mensual esperado, en pesos mexicanos (MXN). Uno de `1_2000000` para hasta 2.000.000, `2000001_10000000` para 2.000.001 a 10.000.000, o `gt_10000000` para más de 10.000.000.
`monthly_operations_range`	string	Obligatorio	Cantidad mensual esperada de operaciones. Uno de `1_15000` para 1 a 15.000, `15001_50000` para 15.001 a 50.000, o `gte_50001` para 50.001 o más.
`resource_origins`	arreglo de string	Obligatorio	De dónde proviene el dinero que mueve la `Entity`. Envía al menos un valor de la lista siguiente.

Valores anteriores de monthly_amount_rangeFintoc todavía acepta los valores anteriores 1_500000, 500001_1000000 y gt_1000000, que contaban montos en dólares estadounidenses. Fintoc convierte 1_500000 a 2000001_10000000; convierte tanto 500001_1000000 como gt_1000000 a gt_10000000. La respuesta devuelve el valor convertido. Envía los valores en MXN en las integraciones nuevas.

account_purpose acepta estos valores:

Valor de `account_purpose`	Uso principal de la cuenta
`betting_gaming`	Operar un negocio de juegos con apuestas, sorteos, loterías o similares.
`collection_and_dispersion`	Cobrar pagos por tus propios productos o servicios, y pagar a proveedores, colaboradores o nómina.
`marketplace`	Cobrar a compradores y liquidar a vendedores o prestadores de servicio, como marketplace o plataforma.
`other`	Cualquier otro uso. Descríbelo en `account_purpose_details`.
`own_sales_collection`	Cobrar pagos por tus propios productos o servicios.
`psp_aggregator`	Procesar pagos por cuenta de otros comercios, como agregador, proveedor de servicios de pago o pasarela de pagos.
`third_party_dispersion`	Dispersar fondos de terceros a personas o empresas, como créditos, premios, comisiones o reembolsos.

resource_origins acepta estos valores:

Valor de `resource_origins`	Origen de los fondos
`asset_sales`	Producto de la venta de activos.
`budget_allocations`	Presupuesto asignado por otra organización.
`donations`	Donaciones recibidas.
`investments`	Rendimientos de inversiones.
`profits`	Utilidades operativas de la empresa.
`royalties`	Pagos por regalías.
`sales_income`	Ventas o ingresos por la actividad.
`trusts`	Distribuciones de un fideicomiso.

La respuesta repite transactional_profile con declaration_accepted en true, que Fintoc agrega al crear el onboarding. No envíes declaration_accepted; la API lo ignora.

shareholders

Campo	Tipo	Obligatorio	Descripción
`children`	arreglo de accionistas	Opcional, solo `legal_entity`	Accionistas que son dueños de este accionista. Envía esto solo cuando `type` es `legal_entity`.
`holder_id`	string	Obligatorio	RFC (identificador fiscal mexicano) del accionista.
`last_name`	string	Opcional, solo `natural_person`	Apellido del accionista. Envía esto solo cuando `type` es `natural_person`. Enviarlo para un `legal_entity` devuelve `invalid_shareholder_structure` con `reason` en `invalid_name`.
`name`	string	Obligatorio	Nombre de pila cuando `type` es `natural_person`, o razón social cuando `type` es `legal_entity`.
`nationality`	string	Obligatorio	Código de país ISO 3166-1 alfa-2 de dos letras de la nacionalidad del accionista, en mayúsculas o minúsculas.
`percentage`	number	Obligatorio	Participación que tiene el accionista, de `0` a `100`. Envía un número JSON; la API rechaza un número como string.
`type`	string	Obligatorio	Tipo de accionista. Uno de `natural_person` o `legal_entity`.

Dos reglas restringen el árbol. Cada error de estructura devuelve el código invalid_shareholder_structure, con reason en el valor entre paréntesis:

La raíz suma entre 76 y 100. Los porcentajes de la raíz deben sumar al menos 76 (participation_below_threshold) y como máximo 100 (shareholder_participation_exceeded). Cada arreglo children debe sumar 100 o menos, sin mínimo.
Solo un legal_entity anida. Un natural_person que lleve children falla (only_legal_entity_can_nest). Un legal_entity sin children es válido. Fintoc no impone un límite de profundidad de anidamiento.

Slots de documentos mexicanos

Crear el onboarding abre todos los slots que el tipo requiere, y cada uno reporta missing hasta que subes un archivo. Todos los slots son obligatorios antes de que puedas enviar el onboarding. El tamaño máximo es 20 MB en todos los slots. En los slots de la empresa y en los documentos de los accionistas, Fintoc lee el tipo de contenido a partir de los bytes del archivo. El tipo de contenido que declara tu carga no importa. Los dos slots del representante legal revisan ambos valores. Envía el Content-Type de la parte como uno de los tipos aceptados de ese slot, porque Fintoc rechaza la carga antes de inspeccionar los bytes. El onboarding abre cinco slots de la empresa, listados en el arreglo documents del primer nivel:

`slot_key`	Tipos de contenido aceptados
`articles_of_incorporation`	`application/pdf`
`proof_of_address`	`application/pdf`, `image/jpeg`, `image/png`
`settlement_bank_statement`	`application/pdf`
`shareholder_structure`	`application/pdf`
`tax_registration_certificate`	`application/pdf`

Cada representante legal tiene su propio arreglo documents con dos slots:

`slot_key`	Tipos de contenido aceptados
`identification`	`application/pdf`, `image/jpeg`, `image/png`
`power_of_attorney`	`application/pdf`

Cada accionista tiene un único objeto document en lugar de un arreglo, porque un accionista tiene exactamente un documento. Fintoc elige el slot a partir del type del accionista, así que la ruta de carga no lleva slot_key:

`type` del accionista	`slot_key`	Tipos de contenido aceptados
`legal_entity`	`articles_of_incorporation`	`application/pdf`, `image/jpeg`, `image/png`
`natural_person`	`identification`	`application/pdf`, `image/jpeg`, `image/png`

Una empresa con un representante legal y tres accionistas abre entonces diez slots: cinco de la empresa, dos del representante y uno por accionista. Cada slot de un account_holder mexicano acepta un solo archivo, así que volver a subir con PUT reemplaza el archivo existente. Cada entrada subida del arreglo documents de primer nivel lleva un id que puedes enviar a DELETE .../documents/{slot_key}/{document_id} para eliminar el archivo. Revisa Administrar los archivos de un slot.

Ejemplo mexicano

Este payload declara un representante legal y dos accionistas en la raíz. Uno de los accionistas de la raíz anida un tercer accionista. Todos los valores son datos de prueba que no corresponden a ninguna empresa ni persona real. El settlement_account es una CLABE de prueba documentada. Fintoc la acepta porque su código de banco y su dígito de control son válidos. Una CLABE de puros ceros devuelve 400 Bad Request, porque 000 no es un código de banco soportado.

{
  "type": "account_holder",
  "data": {
    "company_information": {
      "business_activity": "Servicios financieros",
      "sector": "ecommerce",
      "business_address": "Av. Insurgentes 456, CDMX",
      "fiscal_address": "Av. Reforma 123, CDMX",
      "incorporation_date": "2020-01-15",
      "phone": "+521111111111",
      "settlement_account": "646969000000000000"
    },
    "legal_representatives": [
      {
        "first_name": "Test Customer 1",
        "last_name": "Customer",
        "email": "rep@example.com",
        "nationality": "mx",
        "identification_number": "AAAA010101HDFAAA01",
        "position": "Director General"
      }
    ],
    "transactional_profile": {
      "resource_origins": ["trusts", "investments"],
      "monthly_amount_range": "1_2000000",
      "monthly_operations_range": "1_15000",
      "account_purpose": "own_sales_collection"
    },
    "shareholders": [
      {
        "type": "natural_person",
        "name": "Test Customer 2",
        "last_name": "Customer",
        "holder_id": "AAAA010101AAA",
        "nationality": "mx",
        "percentage": 60
      },
      {
        "type": "legal_entity",
        "name": "Test Entity 2",
        "holder_id": "AAA010101AAA",
        "nationality": "mx",
        "percentage": 40,
        "children": [
          {
            "type": "natural_person",
            "name": "Test Customer 3",
            "last_name": "Customer",
            "holder_id": "AAAA010101AAA",
            "nationality": "mx",
            "percentage": 80
          }
        ]
      }
    ]
  }
}

Qué sigue

Onboarding de una entidad por API para el flujo completo, incluidas las cargas, el envío y la revisión.
Requisitos de KYC en Chile y Requisitos de KYC en México para los documentos que revisa el equipo de cumplimiento de Fintoc.
El objeto Onboarding para los atributos de la respuesta.

Inicio

Recursos

Pagos

Business Accounts

Movimientos

Skeleton group medium 9

Onboarding de account holder

La estructura de la solicitud

Errores de validación

Chile

company_basics

company_information

senior_management

legal_representatives

shareholders

transactional_profile

plaft

Slots de documentos chilenos

Ejemplo chileno

México

company_information

legal_representatives

transactional_profile

shareholders

Slots de documentos mexicanos

Ejemplo mexicano

Qué sigue

Inicio

Recursos

Pagos

Business Accounts

Movimientos

Skeleton group medium 9

​La estructura de la solicitud

​Errores de validación

​Chile

​company_basics

​company_information

​senior_management

​legal_representatives

​shareholders

​transactional_profile

​plaft

​Slots de documentos chilenos

​Ejemplo chileno

​México

​company_information

​legal_representatives

​transactional_profile

​shareholders

​Slots de documentos mexicanos

​Ejemplo mexicano

​Qué sigue

La estructura de la solicitud

Errores de validación

Chile

company_basics

company_information

senior_management

legal_representatives

shareholders

transactional_profile

plaft

Slots de documentos chilenos

Ejemplo chileno

México

company_information

legal_representatives

transactional_profile

shareholders

Slots de documentos mexicanos

Ejemplo mexicano

Qué sigue