Consultar Extrato
Essa funcionalidade permite que os clientes da Celcoin consigam realizar a consulta do extrato de uma conta BaaS de seus cliente.
Passos para Integrar
- Realizar autenticação na API - [API Reference]
- 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-walletreports/v1/wallet/movement?Account=300539137798&DateFrom=2022-10-26&DateTo=2022-10-28&DocumentNumber&LimitPerPage' \
--header 'accept: application/json' \
--header 'authorization: Bearer {{token}}'
Exemplo de retorno
Sucesso 200
{
"status": "SUCCESS",
"version": "1.0.0",
"totalItems": 200,
"currentPage": 1,
"totalPages": 10,
"dateFrom": "2022-01-01",
"dateTo": "2022-01-02",
"body": {
"account": "300151",
"documentNumber": "34335125070",
"movements": [
{
"id": "aa99877c-6205-45ce-8fd8-18173fdd782a",
"clientCode": "7a2a4ea2-ee65-4b3d-8e1d-311dd45d3017",
"description": "Recebimento Pix",
"createDate": "2022-08-31T17:19:55",
"lastUpdateDate": "2022-08-31T17:19:55",
"amount": 10.12,
"status": "Saldo Liberado",
"balanceType": "CREDIT",
"movementType": "PIXPAYMENTIN"
}
]
}
}
Status da Transação
| Status | Descrição |
|---|---|
| Saldo Liberado | Transação Concluída. |
| Saldo Bloqueado | Transação Pendente, Aguardando Confirmação. |
Tipos de Movimentação Disponível
Transferência entre contas (P2P)
| Evento | Descrição |
|---|---|
| TEFTRANSFERIN | Credito referente a um cash-in de transferência interna. |
| TEFTRANSFEROUT | Debito referente a um cash-out de transferência interna. |
Pix
| movementType | Descrição |
|---|---|
| PIXPAYMENTIN | Credito referente a um cash-in Pix. |
| PIXPAYMENTOUT | Debito referente a um cash-out Pix. |
| PIXREVERSALOUT | Debito referente a uma devolução de cash-in Pix. |
| PIXREVERSALIN | Credito referente a um recebimento de devolução de cash-out Pix. |
TED
| Evento | Descrição |
|---|---|
| TEDTRANSFERIN | Crédito referente a um TED recebido. |
| TEDTRANSFEROUT | Débito referente a um TED enviado. |
| TEDREVERSALOUT | Débito referente a uma devolução de TED recebida. |
| TEDREVERSALIN | Crédito referente a uma devolução de TED realizada. |
Cobrança Avulsa
| Evento | Descrição |
|---|---|
| CHARGEIN | Crédito referente a um pagamento recebido. |
Pagamento de contas
| Evento | Descrição |
|---|---|
| BILLPAYMENT | Débito referente a um pagamento realizado. |
| BILLPAYMENTCHARGEBACK | Credito referente ao estorno de um pagamento. |
Recargas
| Evento | Descrição |
|---|---|
| RECHARGE | Débito referente a uma recarga realizada. |
| RECHARGECHARGEBACK | Crédito referente ao estorno de uma recarga. |
Recebimento de liquidações do arranjo de cartões via SLC (Domicílio Bancario)
| Evento | Descrição |
|---|---|
| SLC | Crédito referente a um recebimento de recebíveis do arranjo de pagamentos de cartões por meio do SLC. |
Bloqueio Judicial
| Evento | Descrição |
|---|---|
| JUDICIALMOVEMENTOUT | Liberação de valor bloqueado. |
| JUDICIALMOVEMENTIN | Bloqueio de valor por ordem judicial. |
Error 400
{
"status": "ERROR",
"version": "1.0.0",
"error": {
"errorCode": "CBE039",
"message": "Account invalido.."
}
}
Tabela de errorCode
| Code | Message |
|---|---|
| CBE073 | É necessário informar pelo menos um dos campos: account, ou documentNumber. |
| CBE039 | Account invalido. |
| CBE040 | DocumentNumber invalido. |
| CBE041 | Account possui tamanho maximo de 20 caracteres. |
| CBE042 | DocumentNumber possui tamanho maximo de 14 caracteres. |
| CBE089 | Consulta não permitida, Conta esta bloqueada. |
| CBE090 | Consulta não permitida.Conta esta encerrada. |
| CBE066 | Limite sua busca entre 1 a 200. |
| CBE068 | dateFrom não pode ser maior que dateTo. |
| CBE153 | dateFrom e dateTo são obrigatórios para busca dos lançamentos. |
| CBE376 | Consulta conta não permitida. Diferença entre dateFrom e dateTo não pode ultrapassar 7 dias. |
| CBE080 | Page invalido |
| CBE088 | Limit invalido |
Updated 10 days ago