Reprocessamento de mensagens

stable

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, como no exemplo a seguir:

{ 
  "id": "aaff746c-bb72-4e1c-a5bb-bcda66a1fca4",
  "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.

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 este endpoint para redirecionar os eventos ao endpoint correto.

📘

Nota

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

Requisição

Requisição HTTP

POST https://api-mtls.sandbox.bankly.com.br/webhooks/processed-messages/{idempotencyKey}
--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]' \

Autorização

Esta requisição requer o scope descrito a seguir:

ScopeDescrição
webhook.readConcede acesso para consultar configurações de webhooks, pesquisar mensagens enviadas e realizar o reprocessamento de mensagens.

Cabeçalhos (Headers)

NomeDescrição
api-versionObrigatório. Versão da API. Atualmente estamos na versão 1.0.
AuthorizationObrigatório. Token de autorização do tipo Bearer.

Parâmetros da rota (Path)

No path desta requisição envie o seguinte campo:

NomeTipoDescriçãoEspecificação
idempotencyKeyqueryObrigatório. Informação utilizada para evitar a duplicidade de transações (valor em formato UUID), obtido no endpoint de Consulta de mensagens enviadas.

Resposta (Response)

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

Erros

Este endpoint não retorna erros específicos. Porém, ele poderá retornar alguns erros comuns entre todos os endpoints.

Eventos

Este endpoint não possui eventos relacionados a ele.


Copyright © 2021 Acesso Soluções de Pagamento S.A - Todos os direitos reservados