Configuración de Webhook
Ubicación: Ajustes → Pagos → Webhook
Ubicación:Ajustes → Pagos → Webhook
Los webhooks permiten a QuantaPay notificar a tu servidor en tiempo real cuando se completa un pago.
Campos
| Campo | Descripción |
|---|---|
| URL del Webhook | El endpoint HTTPS en tu servidor que recibirá solicitudes POST cuando ocurran eventos de pago. Debe ser una URL de acceso público. |
| Clave Secreta del Webhook | Secreto autogenerado incluido en la carga útil JSON del webhook como el campokey. Utiliza esto para verificar que los webhooks entrantes provengan genuinamente de QuantaPay. |
Configuración
- Introduce la URL de tu endpoint de webhook (p. ej.,
https://yoursite.com/webhook/quantapay) - LaClave Secreta del Webhookse genera automáticamente. Haz clic en el botón de actualizar para regenerar si es necesario.
- Guarda la configuración.
Cómo funciona
Cuando se completa un pago (estadoC), QuantaPay envía una solicitud HTTP POST a la URL de tu Webhook con:
- Un cuerpo JSON que contiene
{ "key": "your-secret", "transaction": { ... } } - Verifica que el campo
keycoincida con tu Clave Secreta del Webhook para confirmar la autenticidad.
Para ver el formato completo de la carga útil del webhook, el código de verificación de la firma y las mejores prácticas, consultaReferencia de la API: Webhooks.
Pruebas
Para probar tu webhook:
- Crea una sesión de pago de prueba a través de la API
- Completa un pequeño pago
- Revisa los registros de tu servidor para el webhook entrante
Consejo: Utiliza un servicio comowebhook.sitedurante el desarrollo para inspeccionar las cargas útiles de los webhooks entrantes.