Reprocessamento de mensagens

beta scopes: webhook.read

Quando as mensagens enviadas pelos Webhooks Bankly não são recebidas com sucesso pela API do parceiro, o sistema Bankly fará três novas tentativas de envio.

Se ainda assim, as requisições não obtiverem sucesso, o Bankly cessará as tentativas, e o status do evento na consulta de mensagens enviadas constará como Failed.

{ 
  "idempotencyKey": "f5ff2ba3-76c0-4aa0-8015-a93b62a6c126", 
  "state": "Failed", 
  "destination": " https://webhook.site/3635f9f2-e837-41d2-a929-f7f1198120defghk", 
  "sentDate": "2022-01-03T19:12:08.72", 
  "eventName": "TED_CASH_IN_WAS_CLEARED", 
  "retryCount": 0, 
  "elapsedEventCapture": "00:00:00.1016841", 
  "elapsedHttpCall": "00:00:00.4783374", 
  "context": "Ted" 
},

Nesse caso, para solicitar o reenvio de eventos que não foram entregues com sucesso no seu endpoint, o parceiro poderá utilizar o endpoint de reprocessamento de mensagens.

📘

Nota

Recomendamos que o parceiro estabeleça uma rotina de consulta de mensagens enviadas para que identifique eventuais falhas no recebimento de eventos.

Se o parceiro considerar necessário, também poderá solicitar o reenvio de mensagens recebidas com sucesso (status Success). Por exemplo, caso tenha informado a URL do endpoint para recebimento de mensagens sobre Pix no webhook de envio de mensagens para TED, o parceiro poderá utilizar o endpoint de reprocessamento de mensagens para redirecionar os eventos para o endpoint correto.

Etapas

Endpoint

Para o consumo deste endpoint, no path da requisição, é obrigatório informar o idempotencyKey do evento que será reprocessado. Lembramos que o valor desse campo é retornado no header e no body do evento recebido, assim como no endpoint de pesquisa de mensagens enviadas.

--location --request  POST 'https://api-mtls.sandbox.bankly.com.br/webhooks/processed-messages/{idempotencyKey} ' \  
--header 'Content-Type: application/json' \  
--header 'api-version: 1' \ 
--header 'Authorization: Bearer [token]' \

Retorno

O status code 202 indicará sucesso no reenvio da mensagem.

Erro

Status codeCódigoDescrição
404NOT_FOUNDEvento não encontrado.