Skip to main content

Qué son los webhooks

Los webhooks son notificaciones HTTP que VenePagos envía a tu servidor cuando ocurren eventos importantes, como un pago completado o una transferencia fallida.

Cómo funcionan

  1. Configuras una URL de tu servidor como endpoint de webhook
  2. Cuando ocurre un evento, VenePagos envía un POST a tu URL
  3. Tu servidor procesa la notificación y responde con 200 OK

Eventos disponibles

Formato del payload

Implementar un webhook

Buenas prácticas

Tu endpoint debe responder en menos de 5 segundos. Si necesitas hacer procesamiento pesado, responde 200 inmediatamente y procesa en background.
Los webhooks pueden enviarse más de una vez. Usa el id de la transacción para verificar si ya procesaste el evento.
Tu endpoint de webhook debe usar HTTPS para proteger los datos en tránsito.
Los webhooks funcionan tanto en sandbox como en producción. Usa sandbox para probar tu implementación antes de ir a producción.