Procedimento Técnico de Handshake

Na BMP, configuramos o handshake na aba específica no cadastro do parceiro. As configurações incluem:

• Ativo: Se o handshake está ativo.
• Método: Método HTTPS a ser usado.
• URL: URL do endpoint do parceiro.
• Chave HMAC: Chave secreta para assinatura de mensagens.
• Headers: Cabeçalhos desejados na requisição.

O parceiro deve gerar uma chave HMAC robusta, idealmente com 128 caracteres, usando recomendações de segurança avançadas. Esta chave será utilizada para assinar as mensagens e verificar a assinatura das mensagens recebidas da BMP.

Gerar Chave HMAC

O parceiro deve configurar um endpoint HTTPS que aceite requisições POST. O endpoint deve responder dentro de um timeout padrão de 5 segundos para garantir eficiência no processo de handshake. As informações necessárias incluem:

• URL do endpoint
• Método HTTPS
• Headers desejados

Durante as transações que exigem handshake, a BMP enviará uma requisição ao endpoint configurado contendo os detalhes da transação. O parceiro deve verificar a transação utilizando a chave HMAC e responder de acordo:

• 200 OK: Se a transação for reconhecida e validada.
• 404 Not Found: Se a transação não for reconhecida.

Exemplo de body da requisição de handshake:

{
  "TipoTransacao": "EnvioTED",
  "DataTransacao": "2020-06-25",
  "Valor": 45.99,
  "ContaOrigem": "detalhes da conta",
  "ContaDestino": "detalhes da conta destino"
}