Consultar Extrato Detalhado

O Extrato detalhado é uma opção de extrato, que tem como grande diferencial a inclusão de campos adicionais e informações detalhadas de cada transação, antes enviadas apenas por webhook, tornando o extrato muito mais completo.

Passos para Integrar

1. Realizar autenticação na API - [API Reference]
2. Realiza a consulta na API - [Reference]

Fluxo de integração

Consultar Extrato

cURL da chamada

curl --location --request GET 'https://sandbox.openfinance.celcoin.dev/baas/v2/wallet/power-movement?Account=300539137798&DateFrom=2022-10-26&DateTo=2022-10-28&DocumentNumber&LimitPerPage' \
--header 'accept: application/json' \
--header 'authorization: Bearer {{token}}'

📘

Power Extrato da Celcoin

• O extrato detalhado da Celcoin possui transações de 01/08/2025 em diante.
• Esse extrato exibirá as operações que estão confirmadas.

Regras para Consulta de Extrato

O endpoint de extrato permite consultas flexíveis para montagem de relatórios personalizados, extração de períodos específicos e rastreamento de transações individuais.

Regras Gerais:

• O parâmetro Account é obrigatório em todas as requisições.
• Para consultas gerais de movimentações, os campos DateFrom e DateTo são obrigatórios.
• O intervalo entre DateFrom e DateTo não pode ultrapassar 7 dias.
• Caso a consulta seja de um único dia, recomenda-se informar também o intervalo de horas para maior precisão nos resultados. Exemplo: 2022-10-26T16:04:02 até 2022-10-26T16:08:02

Consulta por Identificador:

• Os campos DateFrom e DateTo deixam de ser obrigatórios quando a consulta for realizada utilizando identificadores únicos da transação:
  • Id → utilizado para qualquer tipo de transação
  • EndToEndId → utilizado para transações Pix

Nesses cenários, a busca será realizada diretamente pelo identificador informado.

Filtros Disponíveis:

É possível utilizar filtros adicionais para refinar a consulta:

• MovementType → filtra por tipo de movimentação.
• Exemplo: PIXPAYMENTIN

Paginação:

Para consultas com grandes volumes de dados, utilize os parâmetros:

• LimitPerPage
• Page

Esses parâmetros permitem navegar pelos resultados de forma paginada, reduzindo impacto de processamento e melhorando a performance da consulta.

Ordenação:

• É possível ordenar os resultados utilizando o parâmetro Order:
  • asc → retorna os lançamentos mais antigos primeiro
  • desc → retorna os lançamentos mais recentes primeiro

Quando os parâmetros de paginação não forem informados, a API utilizará automaticamente:

Order = desc / Page = 1 / LimitPerPage = 200

Nesse cenário, serão retornados os 200 registros mais recentes dentro do filtro informado.

Detalhes do Request

Exemplos de retorno

👍

Sucesso 200

Recebimento de Pix:

{
	"id": "6b3b68cd-8f84-46a6-90fd-14efefca03b7",
	"amount": 21,
	"clientRequestId": "b7f9f5dc-232f-4454-8c1e-a5e677736dd7",
	"transactionIdentification": "kk6g232xel65a0daee4dd13kk2787423130",
	"endToEndId": "E08561701202509011441CZR30ZB2UIE",
	"initiationType": "DYNAMIC_QRCODE",
	"paymentType": "IMMEDIATE",
	"urgency": "HIGH",
	"transactionType": "PIXPAYMENTIN",
	"debitParty": {
		"bank": "01234567",
		"account": "702268624",
		"branch": "0001",
		"taxId": "11265169102",
		"name": "João Paulo da Silva",
		"accountType": "TRAN"
	},
	"creditParty": {
		"bank": "13935893",
		"key": "e86b4565-4fce-4dca-bed4-536e5f58c516",
		"account": "41400000",
		"branch": "0001",
		"taxId": "11265169102",
		"name": "João Paulo da Silva",
		"accountType": "TRAN"
	},
	"remittanceInformation": null,
	"currentBalance": 512134.7,
	"oldBalance": 512113.7,
  "transactionIdBRCode": "2787423130"
 },

Bloqueio Judicial:

{
    "status": "SUCCESS",
    "version": "2.0.0",
    "totalItems": 1,
    "currentPage": 1,
    "limitPerPage": 200,
    "totalPages": 1,
    "dateFrom": "2025-07-06T00:00:00",
    "dateTo": "2025-07-11T00:00:00",
    "body": {
        "account": "30023646094074",
        "documentNumber": "66877376781",
        "movements": [
            {
                "id": "c9586cc9-0316-4482-acf4-83de3b2632d3",
                "clientCode": "",
                "description": "Conta bloqueada devido a solicitação do Juiz",
                "createDate": "2025-07-08T18:01:13.302Z",
                "amount": 0.05,
                "status": "CONFIRMED",
                "balanceType": "DEBIT",
                "movementType": "JUDICIALMOVEMENTOUT",
                "additionalInformation": {
                    "account": "30023646094074",
                    "taxId": "66877376781",
                    "name": "Frank Mante",
                    "branch": "0001",
                    "amount": 0.05,
                    "description": "Conta bloqueada devido a solicitação do Juiz",
                    "processNumber": "12131-45545",
                    "courtName": "212121232",
                    "id": "c9586cc9-0316-4482-acf4-83de3b2632d3",
                    "authorName": "teste",
                    "oldBalance": 5104539.40,
                    "currentBalance": 5104539.35
                }
            }
        ]
    }
}

Os dados de retorno, são de acordo com tipo de transação (transactionType), de modo que, os clientes terão no próprio extrato todas as informações antes recebidas somente por webhook.

📘

O detalhamento das informações adicionais para cada tipo de transação deverá ser sempre baseado na documentação de webhook de retorno do produto.

Tipos de Movimentação Disponível

Transferência entre contas (P2P)

Pix

TED

Cobrança Avulsa

Pagamento de contas

Recargas

Recebimento de liquidações do arranjo de cartões via SLC (Domicílio Bancario)

Bloqueio Judicial

Lançamentos Financeiros

Esses lançamentos são gerados internamente pelo time de tesouraria ou operações e refletem ações como reembolsos ou ajustes no saldo na Conta Pagamento Proprietária ou individualizada.

❗

Error 400

{
  "status": "ERROR",
  "version": "1.0.0",
  "error": {
    "errorCode": "CBE039",
    "message": "Account invalido.."
  }
}

Tabela de errorCode

Clique aqui para encontrar a Tabela de erros completa do BaaS