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: Guarda y realiza un pago de prueba para confirmar que tu endpoint recibe el evento.
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.
¿Necesitas más ayuda? Contacta a soporte por correo [email protected] o escríbenos por WhatsApp.