Reenviar webhook de transacción
Reenvía el webhook de una transacción específica a la URL configurada o a una URL temporal (override).
El identificador de la transacción puede ser:
- ID numérico de transacción: El ID retornado por Avista (campo
transactionId en los webhooks)
- Su ID de referencia: El identificador que usted proporcionó al crear la transacción (
externalId)
- PIX End-to-End ID: El
e2eId retornado en los webhooks (formato: E/D + 32 caracteres)
Requiere un Bearer token en el header Authorization.
| Parámetro | Tipo | Requerido | Descripción |
|---|
transactionIdentifier | string | Sí | Identificador de la transacción: id numérico, externalId o endToEndId |
| Campo | Tipo | Requerido | Descripción |
|---|
url | string | No | URL temporal para este reenvío específico. Si no se proporciona, utiliza la URL configurada en el webhook de la cuenta. La URL no se persiste |
{
"url": "https://meu-servidor.com/webhooks/avista"
}
- Si se proporciona
url en el cuerpo, utiliza esa URL temporalmente (no se persiste)
- Si no se proporciona
url, utiliza la URL configurada en el webhook de la cuenta para el tipo de operación
- Si no hay URL disponible, retorna error 400
| Campo | Tipo | Descripción |
|---|
message | string | Mensaje descriptivo del resultado |
webhookLogId | number | ID del registro de webhook generado para auditoría |
sentAt | string | Fecha/hora de envío del webhook (ISO 8601) |
statusCode | number | Código de estado HTTP retornado por la URL de destino |
{
"message": "Webhook resent successfully",
"webhookLogId": 12345,
"sentAt": "2024-01-15T10:30:00.000Z",
"statusCode": 200
}
| Estado | Descripción |
|---|
| 400 | No hay URL de webhook disponible. Configure un webhook para el tipo de operación de esta transacción o proporcione una URL temporal en el campo url |
| 401 | Token inválido, expirado o faltante |
| 404 | Transacción no encontrada o no pertenece a la cuenta autenticada |
| 429 | Límite de solicitudes excedido (máx 60 req/min) |