Los webhooks le avisan a tu sistema, en tiempo real, cuando algo pasa en Recurrente: un pago exitoso, un pago fallido, una suscripción cancelada. Son la base de cualquier integración propia.
Paso a paso
Paso 1: En el menú de tu cuenta, entra a Configuración → Llaves API.
Paso 2: En Herramientas, haz clic en Webhooks para abrir el panel de endpoints de producción. Los de prueba están dentro de tu Sandbox: entra al Sandbox y abre Webhooks desde su pantalla de Llaves API.
Paso 3: Haz clic en Add Endpoint e ingresa la URL de tu sistema que recibirá los eventos.
Paso 4: Selecciona intent.succeeded e intent.failed para recibir los resultados de pagos y guarda el endpoint. Prueba el flujo con un pago en Sandbox y un endpoint registrado en ese mismo Sandbox.
No necesitas una activación adicional: abrir Webhooks desde Recurrente o registrar un endpoint por API habilita los envíos del ambiente correspondiente.
Eventos disponibles
Para pagos, usa intent.succeeded e intent.failed. Las cuentas nuevas reciben estos eventos unificados sin el duplicado payment_intent.*; las cuentas anteriores al cambio conservan ambos formatos. Esto no cambia los eventos de suscripciones, reembolsos ni otros eventos sin reemplazo unificado. La lista completa de eventos, sus payloads y cómo verificar las firmas está en la documentación para desarrolladores.
Si tu integración administra cuentas conectadas, puedes recibir verification.completed cuando se acepta la verificación y tax_invoice_settings.enabled cuando FEL está listo para emitir. El evento identifica la cuenta hija con account_id y connected: true. Habilitar la facturación mientras la activación sigue en proceso todavía no genera el evento de FEL listo.
Si no llegan los eventos
- Comprueba que el endpoint pertenece a la misma cuenta y ambiente que el pago.
- En una cuenta nueva, suscríbete a
intent.succeededeintent.failed; filtrar solopayment_intent.*deja fuera sus eventos de pago. - Send example prueba la recepción de un ejemplo. Que llegue no confirma que los pagos reales estén generando mensajes ni que sus filtros coincidan.
- Si no aparece ningún mensaje del pago en el panel, vuelve a abrir Webhooks desde Recurrente. Si continúa, comparte con soporte el ID del checkout, la cuenta y la hora con su zona horaria. No envíes llaves ni secretos.
Volver a abrir el panel no reenvía pagos anteriores. Soporte debe revisar los eventos faltantes antes de recuperarlos.
¿Necesitas más ayuda? Contacta a soporte por correo [email protected] o escríbenos por WhatsApp.