---
title: "ValidatedFile"
url: "https://devcenter.stone.com.br/apis/chargeback-api-v2026-02-01/versions/277b2a7a-855b-475c-a343-f67650befb83/schemas/ValidatedFile"
---

> Full API specification: https://devcenter.stone.com.br/apis/chargeback-api-v2026-02-01/versions/277b2a7a-855b-475c-a343-f67650befb83.md

# ValidatedFile

Resultado da validação de um único arquivo enviado como evidência. Quando uma submissão é rejeitada, cada arquivo é reportado neste formato, listando todos os códigos de erro que ele violou (vazio quando o arquivo em si está OK, mesmo que a transação tenha falhado por outro motivo).

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Disputas
  version: v2026-02-01
servers:
  - url: https://api.stone.com.br
    description: production
  - url: https://sandbox.api.stone.com.br
    description: sandbox
components:
  schemas:
    ValidatedFile:
      type: object
      description: >
        Resultado da validação de um único arquivo enviado como evidência.
        Quando

        uma submissão é rejeitada, cada arquivo é reportado neste formato,

        listando todos os códigos de erro que ele violou (vazio quando o arquivo

        em si está OK, mesmo que a transação tenha falhado por outro motivo).
      properties:
        name:
          type: string
          description: Nome do arquivo conforme enviado no multipart.
          example: evidence.pdf
        transaction_id:
          type:
            - string
            - "null"
          description: Identificador da transação associada ao arquivo, quando aplicável.
          example: "12332125088527"
        institution:
          type:
            - string
            - "null"
          description: Instituição associada à transação, quando aplicável.
          example: stone
        errors:
          type: array
          items:
            type: string
            description: Código do erro de validação do arquivo.
            enum:
              - FILE_NAME_IS_NOT_VALID
              - FILE_SIZE_TOO_SMALL
              - FILE_SIZE_TOO_BIG
              - FILE_MIME_TYPE_NOT_ALLOWED
              - FILE_EXTENSION_NOT_ALLOWED
              - DISPUTE_NOT_FOUND_TO_INFORMED_TRANSACTION_ID
              - DISPUTE_STATUS_NOT_ALLOWED
              - DISPUTE_DOESNT_BELONG_TO_MERCHANT
          description: >
            Lista de códigos de erro de validação deste arquivo.

            Estará vazia quando `is_valid_file` for `true`.


            **Códigos possíveis:**


            | Código | Significado |

            |---|---|

            | `FILE_NAME_IS_NOT_VALID` | Nome do arquivo não contém um ID de
            transação válido. |

            | `FILE_SIZE_TOO_SMALL` | Tamanho do arquivo abaixo do mínimo
            permitido (1 byte). |

            | `FILE_SIZE_TOO_BIG` | Tamanho do arquivo acima do máximo permitido
            (2 MB). |

            | `FILE_MIME_TYPE_NOT_ALLOWED` | MIME real do arquivo não é
            `application/pdf`. |

            | `FILE_EXTENSION_NOT_ALLOWED` | Extensão não permitida. Permitidas:
            `.pdf`. |

            | `DISPUTE_NOT_FOUND_TO_INFORMED_TRANSACTION_ID` | Não existe
            disputa para o `transaction_id` informado. |

            | `DISPUTE_STATUS_NOT_ALLOWED` | Status atual da disputa não permite
            envio de evidência. |

            | `DISPUTE_DOESNT_BELONG_TO_MERCHANT` | A disputa não pertence ao
            merchant informado. |
          example:
            - FILE_MIME_TYPE_NOT_ALLOWED
            - FILE_SIZE_TOO_BIG
        is_valid_file:
          type: boolean
          description: Indica se o arquivo passou em todas as regras de validação
            individuais.
          example: false
```