Fire Bankingdocs

Reenviar webhook de transação

POST /api/resend-webhook/{transactionIdentifier}

Reenvia o webhook de uma transação específica para a URL configurada ou para uma URL temporária (override).

O identificador da transação pode ser:

  • ID numérico da transação: O ID retornado pela Avista (campo transactionId nos webhooks)
  • Seu ID de referência: O identificador que você forneceu ao criar a transação (externalId)
  • End-to-End ID do PIX: O e2eId retornado nos webhooks (formato: E/D + 32 chars)

Autenticação

Requer token Bearer no header Authorization.

Path Parameters

ParâmetroTipoObrigatórioDescrição
transactionIdentifierstringSimIdentificador da transação: id numérico, externalId ou endToEndId

Request Body (opcional)

CampoTipoObrigatórioDescrição
urlstringNãoURL temporária para este reenvio específico. Se não fornecida, usa a URL configurada no webhook da conta. A URL não é persistida
{
  "url": "https://meu-servidor.com/webhooks/avista"
}

Comportamento de URL

  • Se url for fornecido no body, usa essa URL temporáriamente (não persiste)
  • Se url não for fornecido, usa a URL configurada no webhook da conta para o tipo da operação
  • Se nenhuma URL estiver disponível, retorna erro 400

Response (200)

CampoTipoDescrição
messagestringMensagem descritiva do resultado
webhookLogIdnumberID do log de webhook gerado para auditoria
sentAtstringData/hora do envio do webhook (ISO 8601)
statusCodenumberCódigo de status HTTP retornado pela URL de destino
{
  "message": "Webhook resent successfully",
  "webhookLogId": 12345,
  "sentAt": "2024-01-15T10:30:00.000Z",
  "statusCode": 200
}

Erros

StatusDescrição
400Nenhuma URL de webhook disponível. Configure um webhook para o tipo de operação desta transação ou forneca uma URL temporária no campo url
401Token inválido, expirado ou não fornecido
404Transação não encontrada ou não pertence a conta autenticada
429Rate limit excedido (max 60 req/min)

Nesta página