Upload Identity Document

Subí la documentación de identidad de una persona humana usando su person_id y las imágenes del documento.

Antes de empezar

Creá primero la persona y guardá el person_id.
Prepará las imágenes del documento en base64.
Verificá que las capturas estén completas, legibles y sin reflejos.
Usá este endpoint para adjuntar la documentación de identidad antes de continuar otros flujos de validación.

Cómo subir la documentación de identidad

POST /api/accounts/persons/identity-document
Content-Type: application/json

Body parameters

Campo	Tipo	Requerido	Descripción
`person_id`	string	Sí	Identificador de la persona humana vinculada a la documentación.
`front`	string	Sí	Frente del documento codificado en base64.
`back`	string	Sí	Dorso del documento codificado en base64.
`face`	string	Sí	Fotografía del rostro codificada en base64.

Ejemplo de request

{
  "person_id": "F-8d567d64-3043-47de-8aa8-5d1d39f56c9e",
  "face": "<base64_face>",
  "front": "<base64_front>",
  "back": "<base64_back>"
}

Qué devuelve este endpoint

Este endpoint se usa para registrar la documentación de identidad de la persona asociada.

Recomendaciones para la carga

Enviá imágenes nítidas y completas.
Evitá sombras, reflejos y recortes.
Verificá que front, back y face correspondan a la misma persona.
Confirmá que cada archivo esté correctamente codificado en base64 antes de enviar la solicitud.

Errores frecuentes

422 Validation Error: falta alguno de los campos obligatorios o el body tiene un formato inválido.
Error de procesamiento: revisá que las imágenes estén correctamente codificadas en base64 y que sean legibles.
Error por person_id inexistente: verificá que la persona haya sido creada previamente.

Siguiente paso

Después de cargar la documentación, consultala con GET /api/accounts/persons/identity-document/{person_id} o continuá con los flujos de validación y onboarding que dependan de esta documentación.