Crear Persona

POST

/fidix/v1/persons

Crea una nueva persona, que puede ser de tipo NATURAL (persona física) o LEGAL (persona jurídica/empresa).

Tipos de Persona:

NATURAL: Requiere first_name, last_name, document_type, document_number

LEGAL: Requiere company_name, tax_id (RUT de la empresa)

Campos comunes:

email: Correo electrónico (requerido)

phone: Teléfono (requerido)

person_type: NATURAL o LEGAL (requerido)

El ID de la persona creada se guardará en ${person_id} para uso posterior. También puedes usar ${owner_id} si esta persona será propietaria de una cuenta.

Solicitud

Autorización

JWT Bearer

Agregar el parámetro

Authorization

a Encabezados

Ejemplo:

Authorization: ********************

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢201

application/json

Persona creada exitosamente. El ID está en data.id.

Importante: Guarda el valor de data.id en las variables ${person_id} y/o ${owner_id}.

Body

🟠400

🟠401

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

cURL

Persona NaturalPersona Legal

curl --location --request POST 'https://api-preview.fidi.money/fidix/v1/persons' \
--header 'X-Organization-ID: 00000000-0000-0000-0000-000000000001' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "person_type": "NATURAL",
    "email": "cliente1@fidi.cl",
    "phone": "+56912345678",
    "document_type": "RUT",
    "document_number": "11223344-5",
    "first_name": "Ana",
    "last_name": "Gómez",
    "date_of_birth": "1990-05-15",
    "gender": "FEMALE",
    "occupation": "Ingeniera"
}'

Ejemplo de Respuesta

201 - Persona natural creada

{
    "data": {
        "id": "2g9h7e60-4d9c-6f4c-c4g3-1f1c8d5h3c45",
        "organization_id": "00000000-0000-0000-0000-000000000001",
        "parent_person_id": null,
        "person_type": "NATURAL",
        "email": "cliente1@fidi.cl",
        "phone": "+56912345678",
        "document_type": "RUT",
        "document_number": "11223344-5",
        "status": "active",
        "first_name": "Ana",
        "last_name": "Gómez",
        "date_of_birth": "1990-05-15",
        "gender": "FEMALE",
        "occupation": "Ingeniera",
        "created_at": "2025-01-10T12:00:00Z",
        "updated_at": "2025-01-10T12:00:00Z"
    },
    "metadata": {
        "trace_id": "",
        "timestamp": ""
    }
}

Modificado en 2026-01-10 20:33:00

Obtener Balance de Cuenta

Listar Personas