Histórico da Página
| Índice | ||
|---|---|---|
|
1. Visão Geral
O Conta Corrente Digital Service foi evoluído para suportar notificações automáticas relacionadas ao Mecanismo Especial de Devolução (MED), conforme regulamentação do Banco Central do Brasil.
...
Postagem em tópicos Kafka, ou
Envio via Webhook para sistemas externos.
2. Tipos de Notificações Implementados
2.1. Notificação de Bloqueio
Quando ocorre
Imediatamente após o bloqueio de saldo na conta do recebedor.
Para todos os bloqueios decorrentes do MED.
...
Usuário recebedor da transação original.
Campos obrigatórios
| Campo | Descrição |
|---|---|
motivoBloqueio | Motivo do bloqueio |
valorBloqueado | Valor bloqueado |
nomePagador | Nome do usuário pagador |
dataHoraTransacaoOriginal | Data/hora/min/seg da transação original (Brasília) |
valorTransacaoOriginal | Valor total da transação original |
prazoMaximoBloqueio | Prazo máximo permitido para bloqueio (11 dias) |
Exemplo payload Kafka
| Bloco de código | ||
|---|---|---|
| ||
{
"payload": {
"motivoBloqueio": "Bloqueio de Pix Infra\ufffd\ufffdo",
"valorBloqueado": 10,
"nomeUsuarioPagador": "Joao Exter",
"dataHoraTransacaoOriginal": {
"date": {
"year": 2025,
"month": 9,
"day": 22
},
"time": {
"hour": 14,
"minute": 52,
"second": 39,
"nano": 131000000
}
},
"valorTransacaoOriginal": 100,
"prazoMaximoDiasBloqueio": 11,
"endToEnd": "E11114444202509221452A4OZCI72TJC"
},
"correlation": {
"id": "AgendaContaCorrenteService#a5ba4e53-4e70-435a-8762-ca405ad8a03d"
}
} |
2.2. Notificação de Desbloqueio
Quando ocorre
Imediatamente após o desbloqueio de saldo na conta do recebedor.
Para desbloqueios decorrentes do MED, realizados via frontend.
...
Usuário recebedor da transação original.
Campos obrigatórios
| Campo | Descrição |
|---|---|
valorDisponibilizado | Valor desbloqueado |
dataHoraBloqueio | Data/hora/min/seg do bloqueio (Brasília) |
nomePagador | Nome do usuário pagador |
dataHoraTransacaoOriginal | Data/hora/min/seg da transação original (Brasília) |
valorTransacaoOriginal | Valor total da transação original |
Exemplo payload Kafka
| Bloco de código | ||
|---|---|---|
| ||
{
"payload": {
"valorDisponibilizado": 11.99,
"dataHoraBloqueio": {
"date": {
"year": 2025,
"month": 9,
"day": 22
},
"time": {
"hour": 14,
"minute": 52,
"second": 41,
"nano": 0
}
},
"nomeUsuarioPagador": "Joao Exter",
"dataHoraTransacaoOriginal": {
"date": {
"year": 2025,
"month": 9,
"day": 22
},
"time": {
"hour": 14,
"minute": 52,
"second": 39,
"nano": 131000000
}
},
"valorTransacaoOriginal": 100,
"endToEnd": "E11114444202509221452A4OZCI72TJC"
},
"correlation": {
"id": "AgendaContaCorrenteService#ecf59f31-5be9-4b95-a336-7458eaa44d5d"
} |
2.3. Notificação de Envio de Devolução ao Pagador
Quando ocorre
Imediatamente após o envio de devolução da conta recebedora para a origem pagadora.
Para todas as devoluções decorrentes do MED.
Inclui envios de PIX por reembolso no âmbito MED.
...
Usuário recebedor da transação original.
Campos obrigatórios
| Campo | Descrição |
|---|---|
valorDevolvido | Valor devolvido |
dataHoraBloqueio | Data/hora/min/seg do bloqueio (Brasília) |
nomeDestinatarioDevolucao | Nome do destinatário da devolução (usuário pagador) |
dataHoraTransacaoOriginal | Data/hora/min/seg da transação original (Brasília) |
valorTransacaoOriginal | Valor total da transação original |
Exemplo payload Kafka
| Bloco de código | ||
|---|---|---|
| ||
{
"payload": {
"valorDevolvido": 2,
"dataHoraBloqueio": {
"date": {
"year": 2025,
"month": 9,
"day": 22
},
"time": {
"hour": 15,
"minute": 0,
"second": 16,
"nano": 0
}
},
"nomeDestinatarioDevolucao": "Joao Exter",
"dataHoraTransacaoOriginal": {
"date": {
"year": 2025,
"month": 9,
"day": 22
},
"time": {
"hour": 15,
"minute": 0,
"second": 15,
"nano": 566000000
}
},
"valorTransacaoOriginal": 2,
"endToEnd": "E11114444202509221500BQFNVYIBLZ6"
},
"correlation": {
"id": "AgendaContaCorrenteService#47e6ef6b-1e0a-4902-8d45-394ba55bf5a0"
}
} |
2.4. Notificação de Crédito ao Pagador
Quando ocorre
Imediatamente após o crédito na conta do pagador referente à devolução confirmada por fraude.
Aplica-se a devoluções finalizadas no âmbito MED.
...
Usuário pagador da transação original.
Campos obrigatórios
| Campo | Descrição |
|---|---|
valorCreditado | Valor devolvido e creditado |
dataHoraCredito | Data/hora/min/seg do crédito (Brasília) |
nomeRecebedorOriginal | Nome do recebedor da transação original |
dataHoraTransacaoOriginal | Data/hora/min/seg da transação original (Brasília) |
valorTransacaoOriginal | Valor total da transação original |
Exemplo payload Kafka
| Bloco de código | ||
|---|---|---|
| ||
{
"payload": {
"valorCreditado": 40,
"nomeRemetenteDevolucao": "Joao Cassio",
"dataHoraTransacaoOriginal": {
"date": {
"year": 2025,
"month": 9,
"day": 22
},
"time": {
"hour": 15,
"minute": 3,
"second": 7,
"nano": 509000000
}
},
"valorTransacaoOriginal": 40,
"endToEnd": "E11114444202509221503S0SGGRDIKJG"
},
"correlation": {
"id": "AgendaContaCorrenteService#a2bf6428-9965-4658-a304-cc9266c61571"
}
} |
3. Configuração
As notificações do Conta Corrente Digital Service podem ser enviadas via Kafka ou Webhook.
O modo de integração é definido pelo parâmetro de personalização CC_SRV_INT_NTF.
VR_PRM = K→ Notificações via KafkaVR_PRM = W→ Notificações via Webhook
3.1. Kafka
Para funcionamento via Kafka é necessário possuir um cluster Kafka ativo no ambiente em que roda a aplicação.
A aplicação criará automaticamente os seguintes tópicos:
- Bloqueio de saldo MED
notificacao_bloqueio_saldo_medDesbloqueio → Bloqueio de saldo (recebedor) MED notificacao_desbloqueio_saldo_recebedor_medDevolução→Desbloqueio de saldo ao pagador (Recebedor) MEDnotificacao_devolucao_saldo_pagador_medRecebimento → Devolução de devolução saldo MEDnotificacao_recebimento_devolucao_med→ Recebimento de devolução MED
3.2. Webhook
Para funcionamento via Webhook, além do parâmetro CC_SRV_INT_NTF = W, é necessário configurar as URLs de destino através de parâmetros de personalização.
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas