Notificaciones con webhooks

Qué es un webhook

Un webhook te avisa a tu servidor cuando ocurre un evento importante (por ejemplo, que un cliente pagó). Es la forma recomendada de enterarte de cada cobro al momento, sin tener que consultar la API a demanda.

Eventos que puedes recibir

• payment.completed (venta cobrada) y payment.refunded (reembolso).
• subscription.created, subscription.updated y subscription.canceled.
• dispute.created y dispute.updated.

Cada evento trae en data.object la venta, la suscripción o la disputa con el mismo formato que la API. El historial está en la API de eventos (GET /api/v1/events).

También puedes consultar tus ventas

a demanda con GET /api/v1/orders?status=paid.

Cómo configurarlo

1. Crea un endpoint en tu servidor que reciba un POST.
2. En el dashboard, entra a Desarrolladores, abre tu aplicación (o crea una) y agrega el webhook con tu URL. Cada aplicación recibe los eventos de los cobros que originan sus API keys.
3. Usa el secreto del webhook para validar la firma de cada evento entrante.

La documentación completa de webhooks está en la sección desarrolladores.

¿Sobre sandbox?

En sandbox (entorno de pruebas para que pruebes el producto sin plata real) configuras tus webhooks desde Desarrolladores en el dashboard de sandbox (dashboard.sandbox.vexorpay.com), igual que en producción: reciben solo los eventos de las ventas de prueba y se firman con su propio secreto.