Requisitos previos
- Una entidad creada con Crear una entidad y el
documentIdde 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
- Declara el documento si la entidad aún no lo tiene, con Agregar un documento. Conserva su
documentId. - Sube el archivo con Subir una prueba:
POST /api/entity/v1/documents/{docId}/proofs?proofType=FRONTcomomultipart/form-data, con una parte llamadafile. - Comprueba la carga: la respuesta 201 debe mostrar
sizeBytesmayor que cero y elmimeTypeesperado. - Repite para el reverso (
proofType=BACK) y la selfie (proofType=SELFIE) del documento de identidad, y para cada uno de los demás documentos. - Comprueba la cobertura con Obtener el estado KYC.
documentationStatusdebe serCOMPLETEpara que la entidad esté lista para su revisión.
Subir un archivo
Request
Response
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 undownloadUrl 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.
Reemplazar un archivo rechazado
Cuando Cumplimiento rechaza una prueba, el documento pasa aREJECTED y verificationReason explica el motivo:
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 aPENDING 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.

