Alguns códigos de erro menos frequentes também podem aparecer nos logs de Webhook. Abaixo estão os principais:

301

A URL configurada no Webhook foi movida permanentemente para outro endereço.

O Asaas não segue redirecionamentos automaticamente, então é necessário atualizar o Webhook com a nova URL correta.

307

A URL do Webhook foi temporariamente redirecionada, mantendo o mesmo método (POST).

O Asaas não acompanha esse redirecionamento. É importante corrigir o endpoint e evitar esse tipo de resposta.

405

O servidor rejeitou a requisição porque não aceita o método POST, que é o método utilizado pelo Asaas para envio de Webhooks.

Verifique se o endpoint está corretamente configurado para aceitar POST.

415

O servidor não aceita o tipo de conteúdo enviado.

Os Webhooks do Asaas utilizam Content-Type: application/json. O endpoint precisa estar preparado para esse formato.

429 – Too Many Requests

O endpoint do cliente recebeu muitas requisições em um curto período de tempo e respondeu com limite excedido.

Verifique se há mecanismos de rate limit configurados e, se necessário, ajuste a infraestrutura para suportar picos.

502 – Bad Gateway

O servidor intermediário (como um proxy ou API Gateway) retornou erro ao tentar acessar o servidor final.

Pode ser instabilidade, falha de rede ou configuração incorreta no servidor do cliente.

503 – Service Unavailable

O servidor do cliente estava indisponível no momento do envio do Webhook.

Pode indicar manutenção, falha temporária ou sobrecarga. O cliente deve revisar a estabilidade da aplicação.

504 – Gateway Timeout

A requisição foi encaminhada, mas o servidor não respondeu dentro do tempo limite.

Pode ser causado por lentidão, travamentos ou falhas no servidor do cliente.

Outros Códigos

Outros códigos menos comuns também podem aparecer, como:

406 – o servidor não consegue responder no formato exigido.
409 – conflito na lógica do endpoint ao tentar processar o evento.
412 – alguma condição prévia definida pelo servidor não foi atendida.

Encontrou um erro diferente?

Caso você encontre um erro HTTP que não esteja listado aqui, não se preocupe. Todos os códigos de erro seguem a lógica explicada na nossa documentação principal sobre fila pausada.

Veja mais em:
Códigos HTTP e o comportamento dos Webhooks no Asaas

Em caso de dúvidas, entre em contato com nosso time de suporte técnico para avaliação.