Procedimento Técnico de Callback

​

Introdução

O Callback do DBS é um mecanismo automático para notificar os parceiros sobre transações específicas realizadas em suas contas correntes ou serviços relacionados a emissão de boletos. Este serviço assegura que os parceiros sejam informados em tempo real sobre as operações financeiras, permitindo um gerenciamento eficiente e responsivo de suas atividades financeiras.

​

Tipos de Callbacks Suportados

​

Operações Bancárias

• Envio de transferência entre contas do banco BMP.
• Recebimento de transferência entre contas do banco BMP.
• Envio de TED para outras Instituições Financeiras (IFs).
• Recebimento de TED de outras IFs.
• Devolução de TED rejeitada pela IF de destino.

​

Serviços de Boletos

• Pagamento de boleto de outra IF.
• Registro de boleto.
• Confirmação de alteração em boleto.
• Confirmação de solicitação de baixa de boleto.
• Confirmação de pagamento de boleto.

​

Configuração de Callback

Os parceiros devem fornecer uma URL de endpoint para onde o DBS enviará as notificações de callback. As especificações incluem:

• Endpoint: URL para recebimento dos callbacks.
• Tentativas: O número máximo de tentativas de envio é de 10. Se este número for excedido, a mensagem de callback será descontinuada.

​

Exemplo de Configuração

{
  "url": "https://seupartner.com/callbacks",
  "tentativas": 10
}

​

Mecanismo de Entrega

Os callbacks são gerenciados através de um sistema que tenta enviar a notificação até o número máximo de tentativas definido.

​

Formato das Mensagens de Callback

Cada mensagem de callback é formatada em JSON, incluindo um cabeçalho com informações gerais da transação e um corpo detalhando os elementos específicos da transação.

​

Exemplo de Mensagem de Callback

{
  "Header": {
    "TipoEvento": "PagamentoBoleto",
    "Timestamp": "2024-04-08T11:47:07.037"
  },
  "Body": {
    "IDTransacao": "228dee66-2a89-4566-b48d-02c97dc223e7",
    "Status": "Concluído",
    "Valor": 758.50,
    "Detalhes": {
      "BancoOrigem": 274,
      "AgenciaOrigem": "0001",
      "ContaOrigem": "12345678"
    }
  }
}

​

Respostas do Callback

É essencial que o endpoint configurado para receber os callbacks responda com um código HTTP 200 para indicar o recebimento bem-sucedido.

​

Simulação de Recepção de Callbacks

Para auxiliar no desenvolvimento e teste da integração de callbacks sem impactar os sistemas de produção, recomendamos o uso de ferramentas como WebHook.site. Essa ferramenta permite simular a recepção de mensagens em um ambiente controlado, facilitando a verificação e ajustes no processo de integração.

​

Considerações Finais

Recomenda-se que o endpoint configurado para receber os callbacks funcione principalmente como um repositório, minimizando o processamento no momento da recepção para evitar atrasos. Implementar processos complexos durante o recebimento dos callbacks pode resultar em timeouts e falhas na comunicação, comprometendo a eficiência do sistema. Opte por processar as mensagens recebidas de forma assíncrona para melhorar a performance e confiabilidade do seu sistema de callbacks.