Extrato (Conta Stone)

O extrato é o registro consolidado de todas as movimentações de uma Conta Stone — entradas e saídas —, com o saldo resultante a cada operação.

Sempre que entra ou sai dinheiro da conta — um Pix recebido, um Pix enviado, uma transferência, o pagamento de um boleto, uma compra no cartão —, o sistema cria uma nova entrada no extrato. Cada entrada registra o tipo da movimentação, a operação (crédito quando entra, débito quando sai), o valor, o saldo antes e depois, e a contraparte — quem estava do outro lado.

Pela API, você consulta esse consolidado de uma conta com filtro por período, tipo e direção, e paginação. É assim que você exibe ao cliente o histórico da conta dele e concilia recebimentos e pagamentos com os seus próprios registros.

Endpoint

GET /v1/accounts/statement

A conta (payment_account_id) não é informada na URL — ela é resolvida automaticamente a partir da API Key autenticada. Autenticação via Basic Auth no header Authorization.

Paginação por cursor (after/before/limit), filtros por período (start_datetime/end_datetime), tipo (type) e direção (operation).

Termos-chave

• Extrato — a lista consolidada das movimentações de uma conta em um período.
• Movimentação (entrada) — cada crédito ou débito registrado no extrato.
• Operação — a direção do dinheiro: crédito (entrada) ou débito (saída).
• Tipo — a natureza da movimentação: Pix recebido, Pix enviado, transferência, pagamento de boleto, compra no cartão, entre outras.
• Saldo — quanto a conta tinha antes e depois de cada movimentação.
• Contraparte — a pessoa ou empresa do outro lado da movimentação.

Quando usar

• Exibir ao cliente o histórico de movimentações e a evolução do saldo da conta.
• Conciliar recebimentos e pagamentos com os seus próprios registros.
• Gerar relatórios e exportações contábeis a partir das movimentações da conta.