Transações
Listar transações
Lista os movimentos do extrato.
Lista os movimentos do extrato, do mais recente para o mais antigo, com
paginação por cursor. Na conciliação, some
Os filtros são combináveis e se acumulam com
net_amount por moeda em todas as páginas.
Os movimentos de saída já são negativos.
Autenticação
Escopo
read é suficiente. A listagem respeita o modo da chave: uma key de
produção nunca retorna movimentos de sandbox, e vice-versa.
Parâmetros de query
Filtra pelo tipo do movimento:
charge, refund, chargefy_fee,
platform_fee, affiliate_fee ou adjustment. Valor fora dessa lista responde 400.Filtra pela moeda do saldo, como
currency=brl. Quando omitido, a lista inclui todas as moedas do escopo da requisição.Aceita hoje: brl. Maiúsculas valem como minúsculas (BRL é lido como brl); outra moeda retorna 400 com code: "unsupported_currency". Veja Moedas.Todos os movimentos originados por um pagamento (
pi_) — as parcelas, as
taxas e os estornos dele.Intervalo de criação:
created_at[gte], created_at[gt], created_at[lte],
created_at[lt]. Aceita ISO 8601 ou epoch em segundos.Intervalo da previsão de liquidação, mesmos operadores. Use para montar o
fluxo de caixa futuro.
Filtra pela previsão de depósito bancário. Aceita
[gte], [gt], [lte] e
[lt], com datas ISO 8601. Não filtra pela confirmação bancária.Quantidade por página. Valores fora de 1–100 são ajustados para o limite mais
próximo.
AND. Só existem igualdade e os
operadores de intervalo acima — não há [in], [ne] nem busca textual.
Paginação
A ordenação é porcreated_at decrescente, e os cursores caminham nessa mesma
ordem. Passe o id da última transaction da página em starting_after para
pedir a próxima e use has_more para saber quando parar. O cursor precisa ser
um txn_ visível para a sua key — um id inexistente, de outra organização ou
do outro modo responde 400.
Resposta
200 OK com o envelope de listagem. data traz objetos transaction
completos — nunca uma versão resumida. Lista vazia retorna o mesmo envelope com
data: [], nunca 404.
O exemplo de venda mostra R$ 1.000,00 com taxa de R$ 39,90 e incentivo de cartão de R$ 5,00. O total de taxas é R$ 34,90 e o líquido é R$ 965,10.
Erros comuns
400
400
400

