Saltar al contenido principal
POST
Subir una prueba
Sube el archivo que respalda un documento declarado (imagen de un documento de identidad, PDF de un comprobante de domicilio, escritura de constitución). La prueba se crea con verificationStatus: PENDING y se almacena cifrada; Localpayment la revisa. Cuando se hayan subido todos los archivos, llame a Request Verification.
  • Archivos por documento. Un documento admite tantas pruebas como necesite: el anverso, el reverso y la selfie de un documento de identidad, las páginas de un contrato, un recibo. No hay límite en el número de archivos por id de documento.
  • Reemplazo. FRONT, BACK y SELFIE tienen un archivo vigente cada uno: al subir de nuevo el mismo tipo, este reemplaza al anterior, que pasa a SUPERSEDED. DOCUMENT y OTHER se acumulan: cada carga agrega un archivo (páginas de un contrato, varios recibos).
  • Los archivos aprobados se conservan. Reemplazar un FRONT, BACK o SELFIE APPROVED devuelve 409 PROOF_APPROVED.
  • Durante una revisión. Mientras la entidad está IN_REVIEW, no se puede subir, reemplazar ni eliminar ningún archivo (409 ENTITY_IN_REVIEW).
  • Comprueba que sizeBytes > 0 en la respuesta: una solicitud multipart sin parte de archivo almacena una prueba vacía.
  • Los archivos nunca se devuelven en línea; descárguelos mediante Get a Proof o Download a Proof File.
Los errores usan application/problem+json con un code estable. Catálogo completo: Entity Statuses and Error Codes.

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Encabezados

Authorization
string
requerido

Token de acceso Bearer para la autenticación. Este token se obtiene de los endpoints Get Access Token o Refresh Access Token. Tu cuenta de comerciante y el usuario que actúa se determinan a partir de él.

Ejemplo:

"Bearer <your_access_token>"

X-Correlation-ID
string

Identificador de seguimiento (UUID). Se incluye en la respuesta; Localpayment lo genera si no está presente.

Ejemplo:

"0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10"

Parámetros de ruta

docId
string<uuid>
requerido

documentId del documento al que pertenece el archivo.

Ejemplo:

"e0ea9515-442e-4bc5-bc82-b8d278255c37"

Parámetros de consulta

proofType
enum<string>
requerido

FRONT, BACK, SELFIE, DOCUMENT, OTHER.

Opciones disponibles:
FRONT,
BACK,
SELFIE,
DOCUMENT,
OTHER
Ejemplo:

"FRONT"

metadata
string

Objeto JSON codificado en URL con metadatos de formato libre, por ejemplo %7B%22issuer%22%3A%22utility%22%7D.

Cuerpo

multipart/form-data
file
file
requerido

JPG, PNG o PDF de hasta 10 MB. Parte multipart denominada file.

Respuesta

Creado.

id
string

Identificador de prueba (proofId).

Ejemplo:

"2c4c2f74-7179-4113-83fb-f11dbce9e07d"

documentId
string<uuid>

Documento al que da soporte el archivo.

Ejemplo:

"2e16d844-4fa9-4295-9a21-83ec32ef241a"

proofType
enum<string>

FRONT, BACK, SELFIE, DOCUMENT, OTHER.

Opciones disponibles:
FRONT,
BACK,
SELFIE,
DOCUMENT,
OTHER
Ejemplo:

"FRONT"

fileName
string

Metadatos del archivo tal como se cargaron. Verifica que sizeBytes > 0 después de una carga.

Ejemplo:

"id_front.jpg"

mimeType
string

Metadatos del archivo tal como se cargaron. Verifica que sizeBytes > 0 después de una carga.

Ejemplo:

"image/jpeg"

sizeBytes
integer

Metadatos del archivo tal como se cargaron. Verifica que sizeBytes > 0 después de una carga.

Ejemplo:

102400

verificationStatus
enum<string>

PENDING, IN_REVIEW, APPROVED, REJECTED. Establecido por Localpayment Compliance.

Opciones disponibles:
PENDING,
IN_REVIEW,
APPROVED,
REJECTED
Ejemplo:

"PENDING"

verifiedBy
string | null

Resultado de la verificación. verificationReason se completa en caso de rechazo.

verifiedAt
string<date-time> | null

Resultado de la verificación. verificationReason se completa en caso de rechazo.

verificationReason
string | null

Resultado de la verificación. verificationReason se completa en caso de rechazo.

uploadedBy
string

Usuario de tu cuenta que subió el archivo (desde el token de acceso) y hora de subida.

Ejemplo:

"12345"

uploadedAt
string<date-time>

Usuario de tu cuenta que subió el archivo (desde el token de acceso) y hora de subida.

Ejemplo:

"2024-01-15T17:03:13Z"

status
enum<string>

Ciclo de vida de la prueba: CURRENT (activa), SUPERSEDED (reemplazada por una carga más reciente del mismo proofType) o DELETED. Independiente de verificationStatus.

Opciones disponibles:
CURRENT,
SUPERSEDED,
DELETED
Ejemplo:

"CURRENT"

supersededAt
string<date-time> | null

Establecido cuando se reemplazó la prueba.

supersededBy
string | null

Establecido cuando se reemplazó la prueba.

replacedByProofId
string<uuid> | null

Establecido cuando se reemplazó la prueba.

deletedAt
string<date-time> | null

Establecido cuando se eliminó la prueba.

deletedBy
string | null

Establecido cuando se eliminó la prueba.

inVerification
boolean

verdadero mientras la prueba sea parte de una revisión en curso (entidad IN_REVIEW); no se puede reemplazar ni eliminar entonces.

Ejemplo:

false

Última modificación el 10 de noviembre de 2026