Consultar Extrato Detalhado (Beta)

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.

O Extrato Detalhado foi desenhado para ser flexível e permitir que o cliente consulte as informações que realmente precisa. E para isso, poderão ser utilizados os filtros disponíveis na chamada da API.

Dessa forma, o cliente tem total controle para montar relatórios personalizados, extratos de períodos específicos ou até rastrear transações individuais.

  • Em toda requisição deverá ser utilizado o parâmetro Account de forma obrigatória;
  • Sempre busque movimentações em um período determinado, usando DateFrom e DateTo.
  • Se a busca for de um único dia, informe a mesma data nos campos DateFrom e DateTo e coloque também o intervalo de horas desejado para uma pesquisa mais específica.
    Exemplo: 2022-10-26T16:04:02 - 2022-10-26T16:08:02
  • Se desejar buscar uma transação única, utilizar os identificadores Id (para todas as transações) ou EndToEndId (para Pix).
  • É possível filtrar por tipo de movimentação (Exemplo: MovementType = PIXPAYMENTIN).
  • Para navegar em grandes volumes de dados, deve-se utilizar LimitPerPage e Page. Isso permite um melhor controle de paginação sem sobrecarregar a aplicação.
  • É possível também ordenar os resultados (Order = asc ou desc). A ordem "desc" retornará os lançamentos mais recentes primeiro e a ordem "asc" os lançamentos mais antigos primeiro.

Observação: Se nenhum filtro for informado, o sistema retorna os 200 registros mais recentes (Order = DESC, Page = 1, LimitPerPage = 200).


Detalhes do Request

NomeTipoDescriçãoValor PadrãoExemplo
accountstringNúmero da conta BaaS que deseja consultar. (obrigatório)452893147
dateFromstring (yyyy-MM-dd)Data inicial para filtrar as movimentações. É possível também informar horário no formato (yyyy-MM-dd-Thh:mm:ss)2025-08-01 (ou 2025-08-01T01:30:02)
dateTostring (yyyy-MM-dd)Data final para filtrar as movimentações. É possível também informar horário no formato (yyyy-MM-dd-Thh:mm:ss)2025-08-27 (ou 2025-08-27T05:30:03)
orderstringOrdenação dos registros.
desc (decrescente).
asc (crescente).
DESCASC
limitPerPageintQuantidade máxima de registros retornados por página.200100
pageintNúmero da página a ser retornada12
movementTypestringTipo de movimentaçãoJUDICIALMOVEMENTOUT
clientCodestringId único enviado pelo cliente no ato da transaçãoCLIENT123
endToEndIdstringId da transação de ponta a ponta presente nas movimentações de PIXE1234567892025082712345678901234567
idstringId único da transação gerado pelo BaaSa1b2c3d4e5

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": "RECEIVEPIX",
	"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)

EventoDescrição
TEFTRANSFERINCredito referente a um cash-in de transferência interna.
TEFTRANSFEROUTDebito referente a um cash-out de transferência interna.

Pix

movementTypeDescrição
PIXPAYMENTINCredito referente a um cash-in Pix.
PIXPAYMENTOUTDebito referente a um cash-out Pix.
PIXREVERSALOUTDebito referente a uma devolução de cash-in Pix.
PIXREVERSALINCredito referente a um recebimento de devolução de cash-out Pix.

TED

EventoDescrição
TEDTRANSFERINCrédito referente a um TED recebido.
TEDTRANSFEROUTDébito referente a um TED enviado.
TEDREVERSALOUTDébito referente a uma devolução de TED recebida.
TEDREVERSALINCrédito referente a uma devolução de TED realizada.

Cobrança Avulsa

EventoDescrição
CHARGEINCrédito referente a um pagamento recebido.

Pagamento de contas

EventoDescrição
BILLPAYMENTDébito referente a um pagamento realizado.
BILLPAYMENTCHARGEBACKCredito referente ao estorno de um pagamento.

Recargas

EventoDescrição
RECHARGEDébito referente a uma recarga realizada.
RECHARGECHARGEBACKCrédito referente ao estorno de uma recarga.

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

EventoDescrição
SLCCrédito referente a um recebimento de recebíveis do arranjo de pagamentos de cartões por meio do SLC.

Bloqueio Judicial

EventoDescrição
JUDICIALMOVEMENTOUTLiberação de valor bloqueado.
JUDICIALMOVEMENTINBloqueio de valor por ordem judicial.

Lançamentos Financeiros

EventoDescrição
ENTRYCREDITRepresenta uma entrada de valor na conta (crédito)
ENTRYDEBITRepresenta uma saída de valor da conta (débito).

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 bolsão ou individualizada.


Error 400

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

Tabela de errorCode

CodeMessage
CBE073É necessário informar pelo menos um dos campos: account, ou documentNumber.
CBE039Account invalido.
CBE040DocumentNumber invalido.
CBE041Account possui tamanho maximo de 20 caracteres.
CBE042DocumentNumber possui tamanho maximo de 14 caracteres.
CBE089Consulta não permitida. Conta esta bloqueada.
CBE090Consulta não permitida. Conta esta encerrada.
CBE066Limite sua busca entre 1 a 200.
CBE068dateFrom não pode ser maior que dateTo.
CBE153dateFrom e dateTo são obrigatórios para busca dos lançamentos.
CBE376Consulta conta não permitida. Diferença entre dateFrom e dateTo não pode ultrapassar 7 dias.
CBE080Page invalido
CBE088Limit invalido

🚧

O extrato detalhado da Celcoin encontra-se em fase beta de testes.

Faça uso e nos forneça feedbacks sobre o que achou e como podemos melhorar!