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

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

# TransactionBatchError

Falha de validação aplicada ao conjunto de arquivos de uma mesma transação (independente de cada arquivo ser individualmente válido), ex.: a soma de páginas dos arquivos enviados excede o limite de 10 páginas por transação.

## 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:
    TransactionBatchError:
      type: object
      description: >
        Falha de validação aplicada ao conjunto de arquivos de uma mesma
        transação

        (independente de cada arquivo ser individualmente válido), ex.: a soma
        de

        páginas dos arquivos enviados excede o limite de 10 páginas por
        transação.
      properties:
        transaction_id:
          type: string
          description: Transação alvo da regra de batch.
          example: "12332125088527"
        filenames:
          type: array
          items:
            type: string
          description: Arquivos considerados no batch desta transação.
          example:
            - 12332125088527.pdf
            - dummy_print.pdf
        errors:
          type: array
          items:
            type: string
            description: Código do erro de validação de batch da transação.
            enum:
              - MAX_ITEMS_PER_TRANSACTION_QUANTITY_EXCEEDED
          description: Códigos de erro de validação da transação.
          example:
            - MAX_ITEMS_PER_TRANSACTION_QUANTITY_EXCEEDED
```