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 code | Código | Descrição |
---|---|---|
404 | NOT_FOUND | Evento não encontrado. |
Updated 12 months ago