{"templateId":"markdown","versions":[{"version":"v2026.04","label":"v2026.04","link":"/pt-br/products/payments-direct-2/api-docs/developer-guides/get-ledger-balances-and-transactions","default":true,"active":true,"folderId":"7e5507fe"},{"version":"v2026.03","label":"v2026.03","link":"/pt-br/products/payments-direct-2/v2026.03/api-docs/developer-guides/get-ledger-balances-and-transactions","default":false,"active":false,"folderId":"7e5507fe"},{"version":"v2025.11","label":"v2025.11","link":"/pt-br/products/payments-direct-2/v2025.11/api-docs/developer-guides/get-ledger-balances-and-transactions","default":false,"active":false,"folderId":"7e5507fe"}],"sharedDataIds":{"sidebar":"sidebar-@l10n/pt-BR/products/payments-direct-2/@v2025.11/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Obter saldos e transações do ledger","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"obter-saldos-e-transações-do-ledger","__idx":0},"children":["Obter saldos e transações do ledger"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Neste tutorial, você usará duas operações da API de ledger para monitorar o saldo da sua conta e obter um registro detalhado da atividade na sua conta pré-financiada:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Get available balances"]}," — recupera os saldos disponível e reservado atuais da sua conta."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Get ledger transactions"]}," — recupera uma lista paginada de transações do ledger dentro de um intervalo de data e hora para conciliação."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Você também aprenderá a:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Paginar grandes conjuntos de resultados usando paginação por offset."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Filtrar por ID de pagamento para localizar todos os lançamentos de ledger associados a um pagamento específico."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Exportar resultados em CSV para usar em fluxos de conciliação."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para entender como as operações de ledger (RESERVE, DEBIT, CREDIT, RELEASE) afetam o seu saldo, consulte ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/introduction/concepts/ledger-transactions"},"children":["Transações do ledger"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"antes-de-começar","__idx":1},"children":["Antes de começar"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para seguir este tutorial, você precisa de:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Acesso ao ambiente UAT da API do ","Payments Direct","."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Um token de acesso OAuth2 válido. Consulte ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/api-docs/developer-guides/request-an-access-token"},"children":["Solicitar um token de acesso"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Pelo menos um pagamento concluído ou em andamento (para observar lançamentos de ledger relevantes)."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"etapa-1-obter-os-saldos-disponíveis","__idx":2},"children":["Etapa 1: Obter os saldos disponíveis"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use a operação ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Get available balances"]}," para ver quanto está disponível no momento na sua conta pré-financiada e quanto está reservado para pagamentos em andamento."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint","__idx":3},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/balances"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"parâmetro-de-consulta-opcional","__idx":4},"children":["Parâmetro de consulta opcional"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parâmetro"},"children":["Parâmetro"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrição"},"children":["Descrição"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filtra os resultados por uma única moeda (por exemplo, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USD"]},"). Se omitido, todas as moedas são retornadas."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"exemplo-de-requisição--todas-as-moedas","__idx":5},"children":["Exemplo de requisição — todas as moedas"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.test.ripple.com/v2/balances\" \\\n  -H \"Authorization: Bearer <YOUR_TOKEN>\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"exemplo-de-requisição--apenas-usd","__idx":6},"children":["Exemplo de requisição — apenas USD"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.test.ripple.com/v2/balances?currency=USD\" \\\n  -H \"Authorization: Bearer <YOUR_TOKEN>\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"exemplo-de-resposta","__idx":7},"children":["Exemplo de resposta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"timestamp\": \"2025-03-15T10:30:00.000000Z\",\n  \"balances\": [\n    {\n      \"fundingType\": \"FUNDED\",\n      \"currency\": \"USD\",\n      \"availableBalance\": \"50000.00\",\n      \"reservedBalance\": \"2500.00\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"entendendo-os-campos-de-saldo","__idx":8},"children":["Entendendo os campos de saldo"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrição"},"children":["Descrição"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["availableBalance"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recursos que podem ser usados no momento. Este é o saldo que você pode usar para iniciar novos pagamentos."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reservedBalance"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recursos atualmente separados para pagamentos em andamento. Você não pode usar este saldo para iniciar novos pagamentos até que a reserva seja liberada ou consumida."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["timestamp"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O momento em que o instantâneo do saldo foi capturado."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Saldo e criação de pagamentos"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se uma requisição de criação de pagamento falhar com o erro ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USR_067"]}," (Insufficient balance), compare ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["availableBalance"]}," com o valor do pagamento. O saldo reservado não está disponível para novos pagamentos."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"etapa-2-obter-as-transações-do-ledger","__idx":9},"children":["Etapa 2: Obter as transações do ledger"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use a operação ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Get ledger transactions"]}," para recuperar uma lista paginada de lançamentos de ledger dentro de um intervalo de data e hora. Cada lançamento mostra a operação realizada, o efeito dela sobre o seu saldo disponível e a origem que a criou."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-1","__idx":10},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/ledger-transactions"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"parâmetros-de-consulta-obrigatórios","__idx":11},"children":["Parâmetros de consulta obrigatórios"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parâmetro"},"children":["Parâmetro"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrição"},"children":["Descrição"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Exemplo"},"children":["Exemplo"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Código de moeda ISO 4217."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USD"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start-dttm"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Início do intervalo de data e hora (inclusivo, UTC)."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2025-03-15T00:00:00Z"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end-dttm"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fim do intervalo de data e hora (exclusivo, UTC)."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2025-03-16T00:00:00Z"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page-size"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Número de registros por página. Mínimo: 1, máximo: 50."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["25"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"parâmetros-de-consulta-opcionais","__idx":12},"children":["Parâmetros de consulta opcionais"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parâmetro"},"children":["Parâmetro"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrição"},"children":["Descrição"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Exemplo"},"children":["Exemplo"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filtra os resultados pelo status da transação de ledger. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUCCESS"]}," retorna as transações de ledger concluídas. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PENDING"]}," está reservado para uso futuro e no momento não retorna resultados."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUCCESS"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Outros parâmetros opcionais são abordados mais adiante neste tutorial: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offset"]}," na Etapa 3, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["txnReference"]}," na Etapa 4, e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort-key"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort-direction"]}," em Ordenação dos resultados."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"exemplo-de-requisição","__idx":13},"children":["Exemplo de requisição"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.test.ripple.com/v2/ledger-transactions?\\\ncurrency=USD\\\n&start-dttm=2025-03-15T00:00:00Z\\\n&end-dttm=2025-03-16T00:00:00Z\\\n&page-size=25\" \\\n  -H \"Authorization: Bearer <YOUR_TOKEN>\" \\\n  -H \"Accept: application/json\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"exemplo-de-resposta-1","__idx":14},"children":["Exemplo de resposta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"offset\": \"0\",\n  \"pageSize\": \"25\",\n  \"pageElements\": \"4\",\n  \"total\": \"4\",\n  \"statementTransactions\": [\n    {\n      \"tenant\": \"acme-corp\",\n      \"amount\": \"14.00\",\n      \"currency\": \"USD\",\n      \"txnReference\": \"b1c2d3e4-5f60-4a7b-8c9d-0e1f2a3b4c5d\",\n      \"operation\": \"DEBIT\",\n      \"txnSource\": \"PAYMENTS\",\n      \"status\": \"SUCCESS\",\n      \"createdDttm\": \"2025-03-15T10:25:12.000000Z\",\n      \"updatedDttm\": \"2025-03-15T10:25:12.000000Z\",\n      \"availableBalanceBefore\": \"49986.00\",\n      \"availableBalanceAfter\": \"49986.00\"\n    },\n    {\n      \"tenant\": \"acme-corp\",\n      \"amount\": \"14.00\",\n      \"currency\": \"USD\",\n      \"txnReference\": \"b1c2d3e4-5f60-4a7b-8c9d-0e1f2a3b4c5d\",\n      \"operation\": \"RESERVE\",\n      \"txnSource\": \"PAYMENTS\",\n      \"status\": \"SUCCESS\",\n      \"createdDttm\": \"2025-03-15T10:25:11.000000Z\",\n      \"updatedDttm\": \"2025-03-15T10:25:11.000000Z\",\n      \"availableBalanceBefore\": \"50000.00\",\n      \"availableBalanceAfter\": \"49986.00\"\n    },\n    {\n      \"tenant\": \"acme-corp\",\n      \"amount\": \"10014.00\",\n      \"currency\": \"USD\",\n      \"txnReference\": \"7ea3399c-1234-5678-8d8f-d320ea406630\",\n      \"operation\": \"DEBIT\",\n      \"txnSource\": \"PAYMENTS\",\n      \"status\": \"SUCCESS\",\n      \"createdDttm\": \"2025-03-15T10:25:10.000000Z\",\n      \"updatedDttm\": \"2025-03-15T10:25:10.000000Z\",\n      \"availableBalanceBefore\": \"50000.00\",\n      \"availableBalanceAfter\": \"50000.00\"\n    },\n    {\n      \"tenant\": \"acme-corp\",\n      \"amount\": \"10014.00\",\n      \"currency\": \"USD\",\n      \"txnReference\": \"7ea3399c-1234-5678-8d8f-d320ea406630\",\n      \"operation\": \"RESERVE\",\n      \"txnSource\": \"PAYMENTS\",\n      \"status\": \"SUCCESS\",\n      \"createdDttm\": \"2025-03-15T10:23:45.000000Z\",\n      \"updatedDttm\": \"2025-03-15T10:23:45.000000Z\",\n      \"availableBalanceBefore\": \"60014.00\",\n      \"availableBalanceAfter\": \"50000.00\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"entendendo-as-operações-de-ledger","__idx":15},"children":["Entendendo as operações de ledger"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O campo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation"]}," informa qual ação foi aplicada à sua conta. A sequência RESERVE → DEBIT é o padrão típico de um pagamento concluído."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operação"},"children":["Operação"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Efeito sobre availableBalance"},"children":["Efeito sobre ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["availableBalance"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Quando ocorre"},"children":["Quando ocorre"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREDIT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Aumenta"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recursos são adicionados à sua conta (por exemplo, uma recarga)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RESERVE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Diminui"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recursos são separados quando um pagamento entra no estado de validação ou de transferência."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DEBIT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sem alteração (normalmente)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Os recursos reservados são consumidos quando um pagamento é concluído. O saldo disponível já havia diminuído no momento do RESERVE."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RELEASE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Aumenta"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Os recursos reservados são devolvidos quando um pagamento falha ou é cancelado."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VOID_BALANCE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Depende da implementação"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Correção administrativa. Entre em contato com o suporte técnico da Ripple para mais detalhes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OVERRIDE_BALANCE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Depende da implementação"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Correção administrativa. Entre em contato com o suporte técnico da Ripple para mais detalhes."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Por que o DEBIT não altera o saldo disponível"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quando um pagamento começa, a operação ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RESERVE"]}," tira recursos do saldo disponível e os coloca em estado reservado. Quando o pagamento é concluído, o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DEBIT"]}," finaliza a saída a partir do valor reservado. Mas, como o saldo disponível já havia diminuído no momento do ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RESERVE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["availableBalanceBefore"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["availableBalanceAfter"]}," normalmente são iguais em um lançamento de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DEBIT"]},". Se um pagamento falhar, um lançamento de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RELEASE"]}," devolve os recursos reservados ao saldo disponível."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"etapa-3-paginar-os-resultados","__idx":16},"children":["Etapa 3: Paginar os resultados"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se o valor de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}," na resposta for maior que ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pageElements"]},", há mais registros a recuperar. Use o parâmetro ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offset"]}," para buscar as páginas seguintes."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Padrão:"]}," defina ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offset"]}," como um múltiplo de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page-size"]}," para avançar pelas páginas."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"exemplo-buscar-a-segunda-página","__idx":17},"children":["Exemplo: buscar a segunda página"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.test.ripple.com/v2/ledger-transactions?\\\ncurrency=USD\\\n&start-dttm=2025-03-15T00:00:00Z\\\n&end-dttm=2025-03-16T00:00:00Z\\\n&page-size=25\\\n&offset=25\" \\\n  -H \"Authorization: Bearer <YOUR_TOKEN>\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Continue somando ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page-size"]}," ao ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offset"]}," até que ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pageElements"]}," na resposta seja menor que ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page-size"]},", o que indica que você chegou à última página."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Fixe o intervalo de tempo antes de paginar"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Não altere ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start-dttm"]}," nem ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end-dttm"]}," entre páginas da mesma consulta. Alterar o intervalo de tempo no meio da paginação pode fazer você perder ou duplicar registros."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"etapa-4-filtrar-por-id-de-pagamento","__idx":18},"children":["Etapa 4: Filtrar por ID de pagamento"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para localizar todos os lançamentos de ledger associados a um pagamento específico, use o parâmetro ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["txnReference"]},". Para pagamentos, o valor de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["txnReference"]}," é o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentId"]}," retornado quando o pagamento foi criado."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Isso é útil para auditar o impacto de um pagamento específico no saldo (os lançamentos de RESERVE, DEBIT e eventuais RELEASE daquele pagamento)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"exemplo-consultar-os-lançamentos-de-ledger-de-um-pagamento-específico","__idx":19},"children":["Exemplo: consultar os lançamentos de ledger de um pagamento específico"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.test.ripple.com/v2/ledger-transactions?\\\ncurrency=USD\\\n&start-dttm=2025-03-15T00:00:00Z\\\n&end-dttm=2025-03-16T00:00:00Z\\\n&page-size=25\\\n&txnReference=7ea3399c-1234-5678-8d8f-d320ea406630\" \\\n  -H \"Authorization: Bearer <YOUR_TOKEN>\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"exemplo-de-resposta-2","__idx":20},"children":["Exemplo de resposta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"offset\": \"0\",\n  \"pageSize\": \"25\",\n  \"pageElements\": \"2\",\n  \"total\": \"2\",\n  \"statementTransactions\": [\n    {\n      \"tenant\": \"acme-corp\",\n      \"amount\": \"10014.00\",\n      \"currency\": \"USD\",\n      \"txnReference\": \"7ea3399c-1234-5678-8d8f-d320ea406630\",\n      \"operation\": \"DEBIT\",\n      \"txnSource\": \"PAYMENTS\",\n      \"status\": \"SUCCESS\",\n      \"createdDttm\": \"2025-03-15T10:25:10.000000Z\",\n      \"updatedDttm\": \"2025-03-15T10:25:10.000000Z\",\n      \"availableBalanceBefore\": \"50000.00\",\n      \"availableBalanceAfter\": \"50000.00\"\n    },\n    {\n      \"tenant\": \"acme-corp\",\n      \"amount\": \"10014.00\",\n      \"currency\": \"USD\",\n      \"txnReference\": \"7ea3399c-1234-5678-8d8f-d320ea406630\",\n      \"operation\": \"RESERVE\",\n      \"txnSource\": \"PAYMENTS\",\n      \"status\": \"SUCCESS\",\n      \"createdDttm\": \"2025-03-15T10:23:45.000000Z\",\n      \"updatedDttm\": \"2025-03-15T10:23:45.000000Z\",\n      \"availableBalanceBefore\": \"60014.00\",\n      \"availableBalanceAfter\": \"50000.00\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Isso mostra o impacto completo do pagamento no ledger: os recursos foram reservados quando o pagamento foi criado e debitados quando ele foi concluído."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"etapa-5-exportar-em-csv","__idx":21},"children":["Etapa 5: Exportar em CSV"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Em fluxos de conciliação, você pode solicitar a resposta como arquivo CSV definindo o cabeçalho ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accept: text/csv"]},". Se esse cabeçalho for omitido, a API retorna JSON por padrão."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"exemplo-baixar-um-extrato-em-csv","__idx":22},"children":["Exemplo: baixar um extrato em CSV"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.test.ripple.com/v2/ledger-transactions?\\\ncurrency=USD\\\n&start-dttm=2025-03-01T00:00:00Z\\\n&end-dttm=2025-04-01T00:00:00Z\\\n&page-size=50\" \\\n  -H \"Authorization: Bearer <YOUR_TOKEN>\" \\\n  -H \"Accept: text/csv\" \\\n  -o ledger-march-2025.csv\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"formato-csv","__idx":23},"children":["Formato CSV"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A resposta em CSV inclui os mesmos campos da resposta em JSON, como cabeçalhos de coluna:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"csv","header":{"controls":{"copy":{}}},"source":"tenant,amount,currency,txnReference,operation,txnSource,status,createdDttm,updatedDttm,availableBalanceBefore,availableBalanceAfter\nacme-corp,10014.00,USD,7ea3399c-1234-5678-8d8f-d320ea406630,DEBIT,PAYMENTS,SUCCESS,2025-03-15T10:25:10Z,2025-03-15T10:25:10Z,50000.00,50000.00\nacme-corp,10014.00,USD,7ea3399c-1234-5678-8d8f-d320ea406630,RESERVE,PAYMENTS,SUCCESS,2025-03-15T10:23:45Z,2025-03-15T10:23:45Z,60014.00,50000.00\n","lang":"csv"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"A paginação também vale para o CSV"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As respostas em CSV também são paginadas. Em intervalos de datas grandes, use o parâmetro ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offset"]}," para recuperar as páginas seguintes e concatenar os resultados, omitindo a linha de cabeçalho em todas as páginas depois da primeira."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ordenação-dos-resultados","__idx":24},"children":["Ordenação dos resultados"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort-key"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort-direction"]}," para controlar a ordem dos resultados. Se esses parâmetros forem omitidos, a ordenação padrão é determinada pela API."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.test.ripple.com/v2/ledger-transactions?\\\ncurrency=USD\\\n&start-dttm=2025-03-15T00:00:00Z\\\n&end-dttm=2025-03-16T00:00:00Z\\\n&page-size=25\\\n&sort-key=CREATED_AT\\\n&sort-direction=DESC\" \\\n  -H \"Authorization: Bearer <YOUR_TOKEN>\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Valores de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort-key"]}," compatíveis:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Valor"},"children":["Valor"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Ordena por"},"children":["Ordena por"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREATED_AT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Timestamp de criação da transação"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STATEMENT_OPERATION"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tipo de operação (CREDIT, DEBIT etc.)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STATEMENT_SOURCE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Origem da transação (PAYMENTS, BANK etc.)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STATEMENT_STATUS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Status da transação de ledger"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STATEMENT_TXN_REFERENCE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Referência da transação"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STATEMENT_UPDATED_AT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Timestamp da última atualização"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tratamento-de-erros","__idx":25},"children":["Tratamento de erros"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Código de erro"},"children":["Código de erro"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrição"},"children":["Descrição"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Ação"},"children":["Ação"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USR_251"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Parâmetro de requisição ausente."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Falta um parâmetro obrigatório (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start-dttm"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end-dttm"]}," ou ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page-size"]},"). Adicione o parâmetro ausente e tente novamente."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SYS_301"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Erro interno do servidor."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tente novamente com espera exponencial. Entre em contato com o suporte técnico da Ripple se o problema persistir."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CFG_201"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Configuração inválida."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Não foi possível recuperar os saldos por um problema de configuração. Entre em contato com o suporte técnico da Ripple."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTH_001"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Não autorizado."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O seu token é inválido ou expirou. Gere um novo token de acesso e tente novamente."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"resumo-e-próximos-passos","__idx":26},"children":["Resumo e próximos passos"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Neste tutorial, você:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Recuperou os seus saldos disponível e reservado atuais usando ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/balances"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Buscou uma lista paginada de transações de ledger em um intervalo de datas usando ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/ledger-transactions"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Filtrou as transações por ID de pagamento usando o parâmetro ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["txnReference"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Exportou os resultados em CSV para conciliação."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Próximos passos:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Para entender como as operações de ledger se relacionam com os eventos do ciclo de vida do pagamento, consulte ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/introduction/concepts/ledger-transactions"},"children":["Transações do ledger"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Para criar pagamentos que aparecerão como lançamentos de ledger, consulte ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/api-docs/developer-guides/create-a-payment"},"children":["Criar um pagamento"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Para ver os códigos de erro relacionados a saldo, consulte ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/api-docs/error-handling/api-errors"},"children":["Erros da API"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Para monitorar as mudanças de estado do pagamento que geram atividade no ledger, consulte ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/api-docs/payment-monitoring/polling"},"children":["Polling"]}," ou ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/api-docs/payment-monitoring/notification-webhooks"},"children":["Webhooks de notificação"]},"."]}]}]},"headings":[{"value":"Obter saldos e transações do ledger","id":"obter-saldos-e-transações-do-ledger","depth":1},{"value":"Antes de começar","id":"antes-de-começar","depth":2},{"value":"Etapa 1: Obter os saldos disponíveis","id":"etapa-1-obter-os-saldos-disponíveis","depth":2},{"value":"Endpoint","id":"endpoint","depth":3},{"value":"Parâmetro de consulta opcional","id":"parâmetro-de-consulta-opcional","depth":3},{"value":"Exemplo de requisição — todas as moedas","id":"exemplo-de-requisição--todas-as-moedas","depth":3},{"value":"Exemplo de requisição — apenas USD","id":"exemplo-de-requisição--apenas-usd","depth":3},{"value":"Exemplo de resposta","id":"exemplo-de-resposta","depth":3},{"value":"Entendendo os campos de saldo","id":"entendendo-os-campos-de-saldo","depth":3},{"value":"Etapa 2: Obter as transações do ledger","id":"etapa-2-obter-as-transações-do-ledger","depth":2},{"value":"Endpoint","id":"endpoint-1","depth":3},{"value":"Parâmetros de consulta obrigatórios","id":"parâmetros-de-consulta-obrigatórios","depth":3},{"value":"Parâmetros de consulta opcionais","id":"parâmetros-de-consulta-opcionais","depth":3},{"value":"Exemplo de requisição","id":"exemplo-de-requisição","depth":3},{"value":"Exemplo de resposta","id":"exemplo-de-resposta-1","depth":3},{"value":"Entendendo as operações de ledger","id":"entendendo-as-operações-de-ledger","depth":3},{"value":"Etapa 3: Paginar os resultados","id":"etapa-3-paginar-os-resultados","depth":2},{"value":"Exemplo: buscar a segunda página","id":"exemplo-buscar-a-segunda-página","depth":3},{"value":"Etapa 4: Filtrar por ID de pagamento","id":"etapa-4-filtrar-por-id-de-pagamento","depth":2},{"value":"Exemplo: consultar os lançamentos de ledger de um pagamento específico","id":"exemplo-consultar-os-lançamentos-de-ledger-de-um-pagamento-específico","depth":3},{"value":"Exemplo de resposta","id":"exemplo-de-resposta-2","depth":3},{"value":"Etapa 5: Exportar em CSV","id":"etapa-5-exportar-em-csv","depth":2},{"value":"Exemplo: baixar um extrato em CSV","id":"exemplo-baixar-um-extrato-em-csv","depth":3},{"value":"Formato CSV","id":"formato-csv","depth":3},{"value":"Ordenação dos resultados","id":"ordenação-dos-resultados","depth":2},{"value":"Tratamento de erros","id":"tratamento-de-erros","depth":2},{"value":"Resumo e próximos passos","id":"resumo-e-próximos-passos","depth":2}],"frontmatter":{"title":"Obter saldos e transações do ledger","toc":{"enable":true,"maxDepth":2},"seo":{"title":"Obter saldos e transações do ledger"}},"lastModified":"2026-10-21T01:29:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/pt-br/products/payments-direct-2/api-docs/developer-guides/get-ledger-balances-and-transactions","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}