> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sube 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](https://docs.localpayment.com/es/reference/entity-statuses-and-error-codes.md).


## OpenAPI

````yaml openapi/es/localpayment.json POST /api/entity/v1/documents/{docId}/proofs
openapi: 3.1.0
info:
  version: '1.0'
  title: Localpayment
  contact:
    name: Support
    url: mailto:support@localpayment.com
servers:
  - url: https://api.stage.localpayment.com
    description: Stage
security:
  - token: []
paths:
  /api/entity/v1/documents/{docId}/proofs:
    post:
      summary: Subir una prueba
      operationId: upload-proof
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acceso Bearer para la autenticación. Este token se obtiene
            de los endpoints [Get Access Token](/es/reference/get-token) o
            [Refresh Access Token](/es/reference/refresh-token). Tu cuenta de
            comerciante y el usuario que actúa se determinan a partir de él.
          required: true
          schema:
            type: string
            examples:
              - Bearer <your_access_token>
        - name: X-Correlation-ID
          in: header
          description: >-
            Identificador de seguimiento (UUID). Se incluye en la respuesta;
            Localpayment lo genera si no está presente.
          required: false
          schema:
            type: string
            examples:
              - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
        - name: docId
          in: path
          description: documentId del documento al que pertenece el archivo.
          required: true
          schema:
            type: string
            format: uuid
            examples:
              - e0ea9515-442e-4bc5-bc82-b8d278255c37
        - name: proofType
          in: query
          description: FRONT, BACK, SELFIE, DOCUMENT, OTHER.
          required: true
          schema:
            type: string
            examples:
              - FRONT
            enum:
              - FRONT
              - BACK
              - SELFIE
              - DOCUMENT
              - OTHER
        - name: metadata
          in: query
          description: >-
            Objeto JSON codificado en URL con metadatos de formato libre, por
            ejemplo %7B%22issuer%22%3A%22utility%22%7D.
          required: false
          schema:
            type: string
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              required:
                - file
              properties:
                file:
                  type: string
                  format: binary
                  description: >-
                    JPG, PNG o PDF de hasta 10 MB. Parte multipart denominada
                    file.
                  examples:
                    - id_front.jpg
      responses:
        '201':
          description: Creado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    examples:
                      - 2c4c2f74-7179-4113-83fb-f11dbce9e07d
                    description: Identificador de prueba (proofId).
                  documentId:
                    type: string
                    examples:
                      - 2e16d844-4fa9-4295-9a21-83ec32ef241a
                    format: uuid
                    description: Documento al que da soporte el archivo.
                  proofType:
                    type: string
                    examples:
                      - FRONT
                    enum:
                      - FRONT
                      - BACK
                      - SELFIE
                      - DOCUMENT
                      - OTHER
                    description: FRONT, BACK, SELFIE, DOCUMENT, OTHER.
                  fileName:
                    type: string
                    examples:
                      - id_front.jpg
                    description: >-
                      Metadatos del archivo tal como se cargaron. Verifica que
                      sizeBytes > 0 después de una carga.
                  mimeType:
                    type: string
                    examples:
                      - image/jpeg
                    description: >-
                      Metadatos del archivo tal como se cargaron. Verifica que
                      sizeBytes > 0 después de una carga.
                  sizeBytes:
                    type: integer
                    examples:
                      - 102400
                    description: >-
                      Metadatos del archivo tal como se cargaron. Verifica que
                      sizeBytes > 0 después de una carga.
                  verificationStatus:
                    type: string
                    examples:
                      - PENDING
                    enum:
                      - PENDING
                      - IN_REVIEW
                      - APPROVED
                      - REJECTED
                    description: >-
                      PENDING, IN_REVIEW, APPROVED, REJECTED. Establecido por
                      Localpayment Compliance.
                  verifiedBy:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Resultado de la verificación. verificationReason se
                      completa en caso de rechazo.
                  verifiedAt:
                    type:
                      - string
                      - 'null'
                    format: date-time
                    description: >-
                      Resultado de la verificación. verificationReason se
                      completa en caso de rechazo.
                  verificationReason:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Resultado de la verificación. verificationReason se
                      completa en caso de rechazo.
                  uploadedBy:
                    type: string
                    examples:
                      - '12345'
                    description: >-
                      Usuario de tu cuenta que subió el archivo (desde el token
                      de acceso) y hora de subida.
                  uploadedAt:
                    type: string
                    examples:
                      - '2024-01-15T17:03:13Z'
                    format: date-time
                    description: >-
                      Usuario de tu cuenta que subió el archivo (desde el token
                      de acceso) y hora de subida.
                  status:
                    type: string
                    examples:
                      - CURRENT
                    enum:
                      - CURRENT
                      - SUPERSEDED
                      - DELETED
                    description: >-
                      Ciclo de vida de la prueba: CURRENT (activa), SUPERSEDED
                      (reemplazada por una carga más reciente del mismo
                      proofType) o DELETED. Independiente de verificationStatus.
                  supersededAt:
                    type:
                      - string
                      - 'null'
                    format: date-time
                    description: Establecido cuando se reemplazó la prueba.
                  supersededBy:
                    type:
                      - string
                      - 'null'
                    description: Establecido cuando se reemplazó la prueba.
                  replacedByProofId:
                    type:
                      - string
                      - 'null'
                    format: uuid
                    description: Establecido cuando se reemplazó la prueba.
                  deletedAt:
                    type:
                      - string
                      - 'null'
                    format: date-time
                    description: Establecido cuando se eliminó la prueba.
                  deletedBy:
                    type:
                      - string
                      - 'null'
                    description: Establecido cuando se eliminó la prueba.
                  inVerification:
                    type: boolean
                    examples:
                      - false
                    description: >-
                      verdadero mientras la prueba sea parte de una revisión en
                      curso (entidad IN_REVIEW); no se puede reemplazar ni
                      eliminar entonces.
              examples:
                Example 1:
                  value:
                    id: 2c4c2f74-7179-4113-83fb-f11dbce9e07d
                    documentId: 2e16d844-4fa9-4295-9a21-83ec32ef241a
                    proofType: FRONT
                    fileName: id_front.jpg
                    mimeType: image/jpeg
                    sizeBytes: 102400
                    verificationStatus: PENDING
                    verifiedBy: null
                    verifiedAt: null
                    verificationReason: null
                    uploadedBy: '12345'
                    uploadedAt: '2024-01-15T17:03:13Z'
                    status: CURRENT
                    supersededAt: null
                    supersededBy: null
                    replacedByProofId: null
                    deletedAt: null
                    deletedBy: null
                    inVerification: false
                Example 2 - PDF upload with metadata:
                  value:
                    id: 20d6aa56-73ce-4a52-95e2-903bc9971d08
                    documentId: 396809f2-f4b1-486a-a636-7cd7ad16073c
                    proofType: DOCUMENT
                    fileName: proof_of_address.pdf
                    mimeType: application/pdf
                    sizeBytes: 51200
                    verificationStatus: PENDING
                    verifiedBy: null
                    verifiedAt: null
                    verificationReason: null
                    uploadedBy: '12345'
                    uploadedAt: '2024-01-15T17:19:44Z'
                    status: CURRENT
                    supersededAt: null
                    supersededBy: null
                    replacedByProofId: null
                    deletedAt: null
                    deletedBy: null
                    inVerification: false
        '400':
          description: >-
            Solicitud incorrecta. VALIDATION_ERROR: Falta un campo, encabezado,
            ruta o parámetro de consulta, es desconocido o no válido. details[]
            muestra el campo y el problema.
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalles del problema según RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumen del problema.
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  detail:
                    type: string
                    description: Explicación comprensible para el ser humano.
                  instance:
                    type: string
                    description: Ruta de solicitud.
                  code:
                    type: string
                    description: >-
                      Código de error estable legible por máquina. Basa tu
                      lógica de ramificación en este valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador de la solicitud. Indícalo cuando te pongas
                      en contacto con el servicio de asistencia.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, cuando corresponda.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - VALIDATION_ERROR:
                  value:
                    type: about:blank
                    title: Validation error
                    status: 400
                    detail: >-
                      A field, header, path or query parameter is missing,
                      unknown or invalid. details[] lists field and issue.
                    instance: >-
                      /api/entity/v1/documents/e0ea9515-442e-4bc5-bc82-b8d278255c37/proofs
                    code: VALIDATION_ERROR
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details:
                      - field: externalId
                        issue: REQUIRED
        '401':
          description: >-
            No autorizado. UNAUTHORIZED: Falta el token de acceso o no es
            válido.
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalles del problema según RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumen del problema.
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  detail:
                    type: string
                    description: Explicación comprensible para el ser humano.
                  instance:
                    type: string
                    description: Ruta de solicitud.
                  code:
                    type: string
                    description: >-
                      Código de error estable legible por máquina. Basa tu
                      lógica de ramificación en este valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador de la solicitud. Indícalo cuando te pongas
                      en contacto con el servicio de asistencia.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, cuando corresponda.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - UNAUTHORIZED:
                  value:
                    type: about:blank
                    title: Unauthorized
                    status: 401
                    detail: Missing or invalid access token.
                    instance: >-
                      /api/entity/v1/documents/e0ea9515-442e-4bc5-bc82-b8d278255c37/proofs
                    code: UNAUTHORIZED
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
        '404':
          description: >-
            No encontrado. DOCUMENT_NOT_FOUND: El documento no existe, fue
            eliminado o pertenece a otro comerciante.
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalles del problema según RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumen del problema.
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  detail:
                    type: string
                    description: Explicación comprensible para el ser humano.
                  instance:
                    type: string
                    description: Ruta de solicitud.
                  code:
                    type: string
                    description: >-
                      Código de error estable legible por máquina. Basa tu
                      lógica de ramificación en este valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador de la solicitud. Indícalo cuando te pongas
                      en contacto con el servicio de asistencia.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, cuando corresponda.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - DOCUMENT_NOT_FOUND:
                  value:
                    type: about:blank
                    title: Not found
                    status: 404
                    detail: >-
                      The document does not exist, was deleted, or belongs to
                      another merchant.
                    instance: >-
                      /api/entity/v1/documents/e0ea9515-442e-4bc5-bc82-b8d278255c37/proofs
                    code: DOCUMENT_NOT_FOUND
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
        '409':
          description: >-
            Conflicto. ENTITY_IN_REVIEW: La entidad está IN_REVIEW: sus datos,
            documentos, archivos y vínculos UBO están congelados hasta que
            Localpayment Compliance lo resuelva. PROOF_APPROVED: La prueba está
            APPROVED: no se puede reemplazar ni eliminar. ENTITY_NOT_EDITABLE:
            La entidad está REJECTED, BLOCKED o CLOSED, o la operación
            eliminaría el documento principal o el único documento.
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalles del problema según RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumen del problema.
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  detail:
                    type: string
                    description: Explicación comprensible para el ser humano.
                  instance:
                    type: string
                    description: Ruta de solicitud.
                  code:
                    type: string
                    description: >-
                      Código de error estable legible por máquina. Basa tu
                      lógica de ramificación en este valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador de la solicitud. Indícalo cuando te pongas
                      en contacto con el servicio de asistencia.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, cuando corresponda.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - ENTITY_IN_REVIEW:
                  value:
                    type: about:blank
                    title: Conflict
                    status: 409
                    detail: >-
                      The entity is IN_REVIEW: its data, documents, files and
                      UBO links are frozen until Localpayment Compliance
                      resolves it.
                    instance: >-
                      /api/entity/v1/documents/e0ea9515-442e-4bc5-bc82-b8d278255c37/proofs
                    code: ENTITY_IN_REVIEW
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
                Example 2 - PROOF_APPROVED:
                  value:
                    type: about:blank
                    title: Conflict
                    status: 409
                    detail: 'The proof is APPROVED: it cannot be replaced or deleted.'
                    instance: >-
                      /api/entity/v1/documents/e0ea9515-442e-4bc5-bc82-b8d278255c37/proofs
                    code: PROOF_APPROVED
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
                Example 3 - ENTITY_NOT_EDITABLE:
                  value:
                    type: about:blank
                    title: Conflict
                    status: 409
                    detail: >-
                      The entity is REJECTED, BLOCKED or CLOSED, or the
                      operation would remove the primary document or the only
                      document.
                    instance: >-
                      /api/entity/v1/documents/e0ea9515-442e-4bc5-bc82-b8d278255c37/proofs
                    code: ENTITY_NOT_EDITABLE
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
        '413':
          description: >-
            Carga útil demasiado grande. FILE_TOO_LARGE: El archivo subido
            supera los 10 MB.
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalles del problema según RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumen del problema.
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  detail:
                    type: string
                    description: Explicación comprensible para el ser humano.
                  instance:
                    type: string
                    description: Ruta de solicitud.
                  code:
                    type: string
                    description: >-
                      Código de error estable legible por máquina. Basa tu
                      lógica de ramificación en este valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador de la solicitud. Indícalo cuando te pongas
                      en contacto con el servicio de asistencia.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, cuando corresponda.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - FILE_TOO_LARGE:
                  value:
                    type: about:blank
                    title: Payload too large
                    status: 413
                    detail: The uploaded file exceeds 10 MB.
                    instance: >-
                      /api/entity/v1/documents/e0ea9515-442e-4bc5-bc82-b8d278255c37/proofs
                    code: FILE_TOO_LARGE
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
        '415':
          description: >-
            Tipo de medio no compatible. UNSUPPORTED_FILE_TYPE: El archivo
            subido no es JPG, PNG ni PDF.
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalles del problema según RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumen del problema.
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  detail:
                    type: string
                    description: Explicación comprensible para el ser humano.
                  instance:
                    type: string
                    description: Ruta de solicitud.
                  code:
                    type: string
                    description: >-
                      Código de error estable legible por máquina. Basa tu
                      lógica de ramificación en este valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador de la solicitud. Indícalo cuando te pongas
                      en contacto con el servicio de asistencia.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, cuando corresponda.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - UNSUPPORTED_FILE_TYPE:
                  value:
                    type: about:blank
                    title: Unsupported media type
                    status: 415
                    detail: The uploaded file is not a JPG, PNG or PDF.
                    instance: >-
                      /api/entity/v1/documents/e0ea9515-442e-4bc5-bc82-b8d278255c37/proofs
                    code: UNSUPPORTED_FILE_TYPE
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
        '502':
          description: >-
            Error de puerta de enlace. STORAGE_WRITE_FAILED: No se pudo guardar
            el archivo. Intente la carga nuevamente.
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalles del problema según RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumen del problema.
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  detail:
                    type: string
                    description: Explicación comprensible para el ser humano.
                  instance:
                    type: string
                    description: Ruta de solicitud.
                  code:
                    type: string
                    description: >-
                      Código de error estable legible por máquina. Basa tu
                      lógica de ramificación en este valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador de la solicitud. Indícalo cuando te pongas
                      en contacto con el servicio de asistencia.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, cuando corresponda.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - STORAGE_WRITE_FAILED:
                  value:
                    type: about:blank
                    title: Bad gateway
                    status: 502
                    detail: The file could not be stored. Retry the upload.
                    instance: >-
                      /api/entity/v1/documents/e0ea9515-442e-4bc5-bc82-b8d278255c37/proofs
                    code: STORAGE_WRITE_FAILED
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
      security:
        - token: []
components:
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.