Recupera uma lista de transações com base nos critérios de filtro especificados.

GET /v2/payment/transactions · versão da spec v2 · coleção Postman e spec

Parâmetros

Nome	Onde	Tipo	Obrigatório	Descrição
SellerId	query	string	não
BuyerId	query	string	não
Amount	query	integer	não
Status	query		não
CreatedAtTo	query	string	não	O limite superior para a data de criação da transação. Junto com CreatedAtFrom, as duas vêm sempre juntas ou nenhuma: só uma informada, ou a final menor que a inicial, é 400 TRANSACTION_WINDOW_INVALID. Sem nenhuma das duas, o servidor aplica como janela efetiva os últimos 7 dias. Com as duas informadas, a diferença entre elas não pode passar de 31 dias (400 TRANSACTION_WINDOW_TOO_LARGE).
CreatedAtFrom	query	string	não	O limite inferior para a data de criação da transação. Ver as regras de janela em CreatedAtTo.
PaymentMethod	query		não
PageSize	query	integer	não	O número máximo de transações a retornar por página. Deve ser positivo. O padrão é 20 se não especificado. Acima de 100, a requisição é recusada com 400 TRANSACTION_PAGE_SIZE_TOO_LARGE.
PageNumber	query	integer	não

Respostas

Status	Descrição	Formato
400	Requisição inválida. Na listagem, os códigos de teto são TRANSACTION_PAGE_SIZE_TOO_LARGE (PageSize acima de 100), TRANSACTION_WINDOW_INVALID (só uma das datas informada, ou CreatedAtTo menor que CreatedAtFrom) e TRANSACTION_WINDOW_TOO_LARGE (janela acima de 31 dias).	application/problem+json
401	Unauthorized	application/problem+json
403	Forbidden	application/problem+json
404	Not Found	application/problem+json
500	Internal Server Error	application/problem+json

Respostas de erro seguem o Problem Details (RFC 9457): trate pelo campo code e consulte o catálogo de erros.

Exemplo

curl -X GET "https://api-payments.sand-fintech.com/v2/payment/transactions" \
  -H "Authorization: Bearer $TOKEN"