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

# Submit Dispute Evidence

> Envia evidência de defesa para uma disputa aberta. A disputa precisa estar com status "aberta" e ter ID no gateway (wooviDisputeId). Informe documents (até 10 URLs http/https) e/ou textForPdf (texto convertido automaticamente em PDF de defesa, hospedado em URL assinada com expiração). Não disponível no sandbox.



## OpenAPI

````yaml /api-reference/openapi.yaml post /v1/disputes/{id}/evidence
openapi: 3.1.0
info:
  title: PurinCash API
  version: 1.0.0
servers:
  - url: https://api.purincash.com
    description: Produção
security:
  - bearerAuth: []
tags:
  - name: Cartao
    description: Pagamentos no cartao de credito.
  - name: Cobrancas
    description: Cobrancas PIX avulsas com valor livre.
  - name: Entregas
    description: Conteudo entregue automaticamente apos o pagamento.
  - name: Disputas
    description: Contestacoes (MED) e envio de evidencias.
  - name: Pagamentos
    description: Pagamentos PIX e LTC vinculados ou nao a um produto.
  - name: Saques
    description: Saques em PIX, LTC e USDT.
  - name: Produtos
    description: Produtos de cobranca criados pela API.
  - name: Sandbox
    description: Simulacao de pagamentos e saldo de teste.
  - name: Splits
    description: Cobrancas divididas entre varias contas.
  - name: Loja
    description: Produtos da loja do Discord (somente leitura).
  - name: Assinaturas
    description: PIX recorrente.
  - name: Carteira
    description: Saldo, retencoes e valores a liberar.
paths:
  /v1/disputes/{id}/evidence:
    post:
      tags:
        - Disputas
      summary: Submit Dispute Evidence
      description: >-
        Envia evidência de defesa para uma disputa aberta. A disputa precisa
        estar com status "aberta" e ter ID no gateway (wooviDisputeId). Informe
        documents (até 10 URLs http/https) e/ou textForPdf (texto convertido
        automaticamente em PDF de defesa, hospedado em URL assinada com
        expiração). Não disponível no sandbox.
      operationId: submitDisputeEvidence
      parameters:
        - name: id
          in: path
          required: true
          description: ID da disputa.
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                documents:
                  type: array
                  maxItems: 10
                  description: >-
                    Documentos de evidência (máximo 10). Obrigatório se
                    textForPdf não for enviado. Itens sem URL http/https válida
                    são descartados.
                  items:
                    type: object
                    required:
                      - url
                    properties:
                      url:
                        type: string
                        maxLength: 2000
                        description: URL http(s) do documento.
                      description:
                        type: string
                        maxLength: 500
                        default: Evidence
                        description: Descrição do documento.
                      correlationID:
                        type: string
                        maxLength: 100
                        description: >-
                          Identificador opcional do documento. Gerado
                          automaticamente (código da disputa + sufixo EV) se
                          omitido.
                textForPdf:
                  type: string
                  description: >-
                    Texto de defesa convertido automaticamente em PDF e anexado
                    como evidência. Obrigatório se documents não for enviado.
            example:
              documents:
                - url: https://exemplo.com/comprovante-entrega.pdf
                  description: Comprovante de entrega
              textForPdf: >-
                O produto foi entregue ao comprador em 18/03 às 10h05, conforme
                comprovante anexo.
      responses:
        '200':
          description: Evidências enviadas ao gateway.
          content:
            application/json:
              schema:
                type: object
                properties:
                  uploaded:
                    type: integer
                    description: Quantidade de evidências enviadas.
              example:
                uploaded: 2
        '400':
          description: >-
            Requisição inválida — endpoint não disponível no sandbox, disputa já
            resolvida, disputa sem ID no gateway, corpo sem documents nem
            textForPdf, nenhuma URL http(s) válida ou ID de disputa em formato
            inválido.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: documents array or textForPdf is required
        '404':
          description: Disputa não encontrada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Dispute not found
        '500':
          description: >-
            Erro interno (inclui falha ao gerar o PDF de textForPdf quando não
            há outros documentos válidos).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Internal error
        '502':
          description: Falha ao enviar a evidência ao gateway.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Failed to upload evidence to gateway
        '503':
          description: Gateway de pagamento não configurado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Payment gateway not configured
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: >-
            Mensagem de erro legivel. Trate pelo codigo HTTP; o texto pode
            mudar.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Chave de API gerada no dashboard da PurinCash (ps_live_ ou ps_test_).

````