Visión general
Este artículo cubre lo que ocurre después de enviar el cobro: cómo devolver dinero (reembolso), cómo el webhook mantiene los estados sincronizados sin que hagas nada y qué informes muestran la salud financiera de la operación.
El webhook es el canal por el que la pasarela avisa a la plataforma de cada cambio (pagado, vencido, reembolsado, cancelado). Por eso es la fuente de verdad: la plataforma actualiza el estado del cobro a partir del webhook, no de la pantalla de "éxito" del checkout.
Requisitos previos
- Módulo Pagos habilitado y una pasarela conectada con el webhook configurado.
- Permiso para emitir reembolsos.
- Para los informes, tener cobros/suscripciones registrados en el período.
Paso a paso
Reembolsar un cobro
- Abre el cobro que deseas reembolsar (ya pagado).
- Elige reembolsar.
- Selecciona total (devuelve el valor entero) o parcial (ingresa el valor a devolver).
- Confirma. La plataforma solicita el reembolso a la pasarela.
- Observa el estado cambiar a reembolsado (o parcialmente reembolsado) cuando la pasarela confirme.
Verificar el webhook
- En la configuración de la conexión de la pasarela, revisa la URL del webhook y el secreto de verificación.
- Asegúrate de que la URL esté registrada en el panel de la pasarela.
- Haz una prueba y observa el estado actualizarse automáticamente.
Leer los informes
- Abre los informes de Pagos.
- Filtra por período.
- Analiza los indicadores (facturación, ticket medio, MRR, churn) y los cortes por estado, pasarela y moneda.
Configuración y opciones
-
Reembolso total vs. parcial: ambos admitidos por las pasarelas actuales.
-
Webhook: autenticado por cada pasarela (token en el encabezado en Asaas; firma en Mercado Pago); las notificaciones repetidas se manejan de forma segura (sin duplicar efectos).
-
Indicadores de los informes:
Indicador Qué muestra Facturación Total recibido en el período Ticket medio Valor medio por cobro pagado Descuentos otorgados Suma de los descuentos aplicados Por estado Distribución entre pagado, pendiente, vencido, etc. Por pasarela Cuánto ingresó por Asaas / Mercado Pago Por moneda Cortes cuando hay más de una moneda MRR Ingreso recurrente mensual de las suscripciones activas Churn Suscripciones canceladas en el período
Casos de uso
- Devolver un valor a un cliente que desistió (reembolso total).
- Revertir parte de un cobro (reembolso parcial).
- Seguir el crecimiento del ingreso recurrente con el MRR.
- Identificar la pérdida de suscriptores con el churn.
Consejos, límites y buenas prácticas
- Confía siempre en el webhook para el estado; la pantalla del checkout puede renderizar antes de la confirmación.
- El reembolso lo procesa la pasarela — el plazo para que el dinero llegue al cliente sigue las reglas del proveedor/medio de pago.
- Sigue MRR y churn juntos para tener la foto real de la recurrencia.
- Mantén la URL del webhook accesible y el secreto de verificación correcto; sin eso, los estados no se actualizan.
Solución de problemas
- El estado nunca cambia a pagado: el webhook no está llegando o fue rechazado (firma/token incorrectos) — vuelve a configurar el webhook en la conexión.
- El reembolso no concluye: confirma que el cobro estaba pagado y que la pasarela admite el tipo de reembolso solicitado.
- Informe vacío: verifica el filtro de período y si hay cobros en el rango.
- El MRR parece incorrecto: confirma los ciclos de las suscripciones; el MRR normaliza cada una al equivalente mensual.