Extrato do recebedor
Extrato paginado do recebedor, com filtros por natureza do lançamento, direção, origem, moeda, disponibilidade e período.
GET /wallets/owner/{ownerId}/transactions
Faz parte do recurso Carteiras — o que cada saldo significa está lá.
Retorna o extrato do lançamento mais recente para o mais antigo, consolidando todas as
carteiras do recebedor; cada lançamento traz a própria moeda. A página vem com limit 20 por
padrão e aceita até 100 — confira pagination.totalPages antes de concluir que o extrato
acabou. Todos os filtros são opcionais e podem ser combinados; as datas seguem ISO 8601 com
timezone (veja Convenções).
amount negativo. O sinal acompanha o flow: credit é positivo, debit
é negativo — uma taxa aparece como flow: "debit" com amount: -12500. Somar o amount de
todos os lançamentos dá o efeito líquido direto; não aplique o flow por cima do sinal, ou
todo débito conta em dobro.releaseStatus separa o que já dá para sacar. released é o que está disponível;
pending ainda está no prazo de liberação e o campo scheduledFor diz quando cai. O saldo
sacável não é a soma do extrato inteiro.transactionId: a venda, as taxas e eventuais
estornos daquela transação vêm juntos, e é assim que se explica a diferença entre o valor da
venda e o que entrou na carteira.Exemplo
Authorizations
API Key da Credential (gerada no Backoffice)
Path Parameters
ID do recebedor
Query Parameters
Natureza do lançamento: sale, refund, chargeback, chargeback_reversal, pending_refund, pending_refund_reversal, anticipation, fee, withdrawal, adjustment, manual ou transfer. Aceita vários valores separados por vírgula e tem precedência sobre type.
sale, refund, chargeback, chargeback_reversal, pending_refund, pending_refund_reversal, anticipation, fee, withdrawal, adjustment, manual, transfer Direção do lançamento: credit (entrada) ou debit (saída). Débitos vêm com amount negativo — o sinal e o flow contam a mesma coisa.
credit, debit Origem do lançamento: psp_import (recebido do adquirente), platform_calc (calculado na liquidação) ou manual (ajuste lançado por um operador).
psp_import, platform_calc, manual Moeda no padrão ISO 4217 (ex.: BRL). Um valor por requisição.
Disponibilidade do valor: released (já disponível para saque) ou pending (ainda a liberar).
released, pending Traz lançamentos criados a partir deste instante (ISO 8601 com timezone), inclusive.
Traz lançamentos criados até este instante (ISO 8601 com timezone), inclusive.
Retorna os lançamentos originados desta transação (txn_). Correspondência exata — útil para reconstruir venda, taxas e estornos de um mesmo pedido.
1Página da listagem. Padrão: 1.
x >= 1Itens por página. Padrão: 20. Máximo: 100.
1 <= x <= 100