Reenviar webhook de transacción

POST /api/resend-webhook/{transactionIdentifier}

POST https://api.avista.global/api/resend-webhook/{transactionIdentifier}

Requiere un Bearer token en el header Authorization. Vea Generar Token para obtener uno.

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)

Autenticación

Requiere un Bearer token en el header Authorization.

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
`transactionIdentifier`	string	Sí	Identificador de la transacción: id numérico, externalId o endToEndId

Cuerpo de la solicitud (opcional)

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"
}

Comportamiento de la URL

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

Ejemplos de Código

cURL

curl -X POST "https://api.avista.global/api/resend-webhook/PAG-2024-0001" \
  -H "Authorization: Bearer $AVISTA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://meu-servidor.com/webhooks/avista"
}'

const axios = require('axios');

const response = await axios.post('https://api.avista.global/api/resend-webhook/PAG-2024-0001',
  {
  "url": "https://meu-servidor.com/webhooks/avista"
},
  {
    headers: {
      'Authorization': `Bearer ${process.env.AVISTA_TOKEN}`,
      'Content-Type': 'application/json',
    },
  }
);
console.log(response.data);

import os, requests

response = requests.post(
    'https://api.avista.global/api/resend-webhook/PAG-2024-0001',
    headers={
        'Authorization': f'Bearer {os.environ["AVISTA_TOKEN"]}',
        'Content-Type': 'application/json',
    },
    json={
  "url": "https://meu-servidor.com/webhooks/avista"
},
)
print(response.json())

$ch = curl_init('https://api.avista.global/api/resend-webhook/PAG-2024-0001');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('AVISTA_TOKEN'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => '{
  "url": "https://meu-servidor.com/webhooks/avista"
}',
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

String body = """
    {
      "url": "https://meu-servidor.com/webhooks/avista"
    }
    """;
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.avista.global/api/resend-webhook/PAG-2024-0001"))
    .header("Authorization", "Bearer " + System.getenv("AVISTA_TOKEN"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Respuesta (200)

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
}

Errores

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)

Reenviar webhook de transacción

En esta página