Paginação e filtros

Todos os query params são opcionais. A consulta retorna as Transações da empresa autenticada; filtros de identificadores, documento, opção de pagamento e status usam correspondência exata.

Os padrões são page=1, size=10, sort=created_at e dir=desc. dir depende do envio de sort. Os enums listam valores conhecidos; valores desconhecidos em status e payment_option não têm rejeição por enum garantida.

Em cartão, document_number usa o documento informado para o cartão, com fallback para o comprador. No fluxo de cobrança com cartão verificado, AUTHORISED_TO_VALIDATE pertence a detailed_status e é traduzido para PAID em status.

Valores

Valores monetários são inteiros em centavos (1000 = R$ 10,00). Valores iguais ao mínimo ou ao máximo informado também entram no resultado. amount_end < amount_start retorna HTTP 400 quando ambos são enviados; não há validação equivalente para paid_amount.

Datas

• Formatos aceitos: YYYY-MM-DD, YYYY-MM-DDTHH:mm:ss, YYYY-MM-DD HH:mm:ss e RFC 3339 com Z ou offset.
• Sem offset, a interpretação inicial é UTC. Datas sem horário representam meia-noite; _end não se estende ao fim do dia. Registros exatamente nos limites considerados pelo filtro também entram no resultado.
• created_at_* e updated_at_* somam três horas ao valor interpretado, mesmo com offset. payment_at_* não recebe esse acréscimo.
• Em cartão, payment_at pode ser a data de criação informada pelo provedor, distinta de captured_at.
• Datas inválidas podem ser ignoradas, sem erro de validação garantido.