Saltar al contenido principal
Un documento contiene los datos declarados (tipo y número). Una prueba es el archivo que los respalda. Esta guía muestra cómo agregar documentos a una entidad, cargar sus archivos uno por uno, reemplazar o eliminar archivos y verificar que todos los documentos estén cubiertos para que la entidad esté lista para su revisión.

Requisitos previos

  • Una entidad creada con Crear una entidad y el documentId de cada uno de sus documentos.
  • Archivos en formato JPG, PNG o PDF, de hasta 10 MB cada uno.

Archivos por documento

Un documento contiene tantos archivos como necesites. Cada archivo tiene un tipo: Un archivo APPROVED no se puede reemplazar (409 PROOF_APPROVED). Un archivo subido por error se puede eliminar con Eliminar una prueba mientras no esté aprobado.

Paso a paso

  1. Declara el documento si la entidad aún no lo tiene, con Agregar un documento. Conserva su documentId.
  2. Sube el archivo con Subir una prueba: POST /api/entity/v1/documents/{docId}/proofs?proofType=FRONT como multipart/form-data, con una parte llamada file.
  3. Comprueba la carga: la respuesta 201 debe mostrar sizeBytes mayor que cero y el mimeType esperado.
  4. Repite para el reverso (proofType=BACK) y la selfie (proofType=SELFIE) del documento de identidad, y para cada uno de los demás documentos.
  5. Comprueba la cobertura con Obtener el estado KYC. documentationStatus debe ser COMPLETE para que la entidad esté lista para su revisión.

Subir un archivo

Request
Response
En Python, comprueba el tamaño del archivo almacenado y gestiona los errores de carga:

Comprobar cobertura

Estado de KYC una vez que ambos archivos estén en su lugar:

Leer archivos de vuelta

Obtener una prueba devuelve los metadatos y un downloadUrl válido durante 10 minutos. Descargar el archivo de una prueba redirige directamente a él. Ambos se auditan con el usuario de tu token de acceso.
El downloadUrl firmado otorga acceso al archivo hasta que caduque. No lo guardes ni lo compartas con terceros. Solicita uno nuevo cuando vuelvas a necesitar el archivo.

Reemplazar un archivo rechazado

Cuando Cumplimiento rechaza una prueba, el documento pasa a REJECTED y verificationReason explica el motivo:
Una vez que la entidad vuelva a PENDING_KYC, sube un nuevo archivo con el mismo proofType. La prueba rechazada se reemplaza y el documento vuelve a PENDING. Cuando las correcciones estén hechas, llama de nuevo a Solicitar verificación.

Editar un documento

Actualizar un documento modifica el país emisor, las fechas y los metadatos. Cualquier cambio restablece a PENDING las pruebas aprobadas del documento. El tipo y el número son inmutables: en su lugar, agrega un nuevo documento y elimina el anterior. El documento principal no se puede eliminar.

Errores comunes

Próximos pasos

Realiza el seguimiento de las revisiones y corrige los rechazos.

Sigue las instrucciones de la revisión y corrige lo que te pida Localpayment.

Tipos de documentos y comprobantes

Tipos de documentos y pruebas aceptados, y restricciones de archivo.
Última modificación el 10 de noviembre de 2026