Reenviar webhook de transação
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)
Requer token Bearer no header Authorization.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
transactionIdentifier | string | Sim | Identificador da transação: id numérico, externalId ou endToEndId |
| Campo | Tipo | Obrigatório | Descrição |
|---|
url | string | Não | URL 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"
}
- 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
| Campo | Tipo | Descrição |
|---|
message | string | Mensagem descritiva do resultado |
webhookLogId | number | ID do log de webhook gerado para auditoria |
sentAt | string | Data/hora do envio do webhook (ISO 8601) |
statusCode | number | Código de status HTTP retornado pela URL de destino |
{
"message": "Webhook resent successfully",
"webhookLogId": 12345,
"sentAt": "2024-01-15T10:30:00.000Z",
"statusCode": 200
}
| Status | Descrição |
|---|
| 400 | Nenhuma 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 |
| 401 | Token inválido, expirado ou não fornecido |
| 404 | Transação não encontrada ou não pertence a conta autenticada |
| 429 | Rate limit excedido (max 60 req/min) |