MED - Notificações

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.

Essas notificações permitem que recebedores e pagadores sejam informados em tempo real sobre:

• Bloqueios de saldo decorrentes de infrações.

• Liberação de valores.

• Devolução ao pagador.

• Crédito na conta do pagador em função de devolução por fraude.

As mensagens podem ser entregues através de:

• 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.

Quem recebe

• Usuário recebedor da transação original.

Campos obrigatórios

Exemplo payload Kafka 

{
  "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.

Quem recebe

• Usuário recebedor da transação original.

Campos obrigatórios

Exemplo payload Kafka

{
  "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.

Quem recebe

• Usuário recebedor da transação original.

Campos obrigatórios

Exemplo payload Kafka

{
  "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.

Quem recebe

• Usuário pagador da transação original.

Campos obrigatórios

Exemplo payload Kafka

{
  "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 Kafka

• VR_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:

• notificacao_bloqueio_saldo_med → Bloqueio de saldo MED
• notificacao_desbloqueio_saldo_recebedor_med → Desbloqueio de saldo (Recebedor) MED
• notificacao_devolucao_saldo_pagador_med → Devolução de saldo MED
• notificacao_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.

Parâmetros esperados:

• CC_NTF_BLQ_SLD_MED_URL_WH → URL Webhook para notificação de bloqueio de saldo MED

• CC_NTF_DLQ_SLD_MED_URL_WH → URL Webhook para notificação de desbloqueio de saldo ao recebedor MED

• CC_NTF_DVL_SLD_MED_URL_WH → URL Webhook para notificação de devolução de saldo ao pagador MED

• CC_NTF_RCB_DVL_MED_URL_WH → URL Webhook para notificação de recebimento de devolução MED

Formato padrão de envio: JSON