Descripción general de las suscripciones
Las suscripciones te permiten cobrar a un cliente de forma recurrente. MONEI gestiona el ciclo de facturación automáticamente — crea y activa una suscripción, y MONEI cobra al cliente en cada intervalo de facturación.
Ciclo de vida de una suscripción
Una suscripción pasa por varios estados a lo largo de su vida:
Estados
| Estado | Descripción |
|---|---|
| PENDING | Suscripción creada, pendiente de activación. El cliente aún no ha proporcionado un método de pago. |
| TRIALING | Periodo de prueba activo. Se realizó un pago de verificación de €0 para validar el método de pago. La facturación comienza al finalizar el periodo de prueba. |
| ACTIVE | Los pagos recurrentes se cobran en cada intervalo de facturación. |
| PAUSED | La facturación está suspendida temporalmente. La suscripción puede reanudarse en cualquier momento. |
| PAST_DUE | Un pago recurrente ha fallado. MONEI reintentará según el calendario de reintentos. |
| CANCELED | La suscripción ha sido cancelada permanentemente. No se realizarán más cobros. |
| EXPIRED | La suscripción no se activó a tiempo y ya no puede utilizarse. |
En MONEI Dashboard → Suscripciones, cada estado es una pestaña sobre la tabla, así que puedes listar todas las suscripciones activas, en prueba, en pausa, canceladas o con pago pendiente:
Intervalos de facturación
Configura la frecuencia con la que se cobra al cliente usando interval e intervalCount. La tabla siguiente muestra ejemplos habituales; no es una lista completa de todos los intervalos de facturación válidos:
| interval | intervalCount | Frecuencia de facturación |
|---|---|---|
| day | 1 | Cada día |
| week | 1 | Cada semana |
| week | 2 | Cada 2 semanas |
| month | 1 | Cada mes |
| month | 3 | Cada 3 meses (trimestral) |
| year | 1 | Cada año |
El período de facturación máximo es de 1 año. Por ejemplo, intervalCount no puede superar 365 para day, 52 para week, 12 para month, ni 1 para year.
Los intervalos minute y hour solo están disponibles en modo de prueba — útiles para probar rápidamente tu integración sin esperar ciclos de facturación reales.
Periodos de prueba
Puedes ofrecer un periodo de prueba gratuito antes del primer cobro. Configúralo con una de las siguientes opciones:
- trialPeriodDays — número de días gratuitos (p. ej.,
14para un periodo de prueba de 14 días) - trialPeriodEnd — marca de tiempo Unix cuando finaliza el periodo de prueba
Durante la activación, MONEI crea un pago de verificación de €0 para validar el método de pago del cliente sin cobrarle. El primer cobro real se realiza cuando finaliza el periodo de prueba.
Puedes ampliar un periodo de prueba activo actualizando trialPeriodEnd en una suscripción en estado TRIALING — consulta Actualizar detalles de la suscripción.
Eventos de webhook
MONEI envía notificaciones de para los cambios de estado de las suscripciones y los pagos recurrentes. Configuras dos URLs de callback separadas al crear una suscripción:
- callbackUrl — recibe los eventos de cambio de estado de la suscripción
- paymentCallbackUrl — recibe los eventos de pago de cada cobro recurrente
Eventos de suscripción
| Tipo de evento | Se activa cuando |
|---|---|
| SUBSCRIPTION_PENDING | Se crea la suscripción |
| SUBSCRIPTION_ACTIVATED | La suscripción se vuelve activa |
| SUBSCRIPTION_TRIALING | Comienza el periodo de prueba |
| SUBSCRIPTION_PAUSED | La suscripción se pausa |
| SUBSCRIPTION_PAST_DUE | Un pago recurrente falla |
| SUBSCRIPTION_CANCELED | La suscripción se cancela |
| SUBSCRIPTION_EXPIRED | La suscripción caducó (no se activó a tiempo) |
| SUBSCRIPTION_UPDATED | Se modifican los detalles de la suscripción |
Cada solicitud de webhook incluye una cabecera MONEI-Signature. Siempre verifica la firma antes de procesar el evento, y devuelve un código de estado HTTP 200 para confirmar la recepción.
Métodos de pago
Las suscripciones son compatibles con los siguientes métodos de pago:
- Tarjeta — Visa, Mastercard y otras compatibles. Método de pago predeterminado para todas las suscripciones.
- Bizum — Disponible con las siguientes restricciones:
- Solo intervalos de facturación mensual y anual (los intervalos diario y semanal no están disponibles en producción)
- Los periodos de prueba no están disponibles
- El importe de la suscripción no puede modificarse tras la activación
Activar suscripciones
Elige cómo activan los clientes las suscripciones:
- Usar página de pago prediseñada — Redirige a los clientes a una página alojada por MONEI para activar su suscripción. La integración más sencilla, no se requiere código de frontend.
- Crear un checkout personalizado — Recoge los detalles de pago en tu propio sitio usando los componentes de MONEI. Control total sobre la experiencia de checkout.
- Enviar enlace de suscripción — Envía un enlace de activación por email o SMS para crear suscripciones de forma manual o desde el back office.
Gestionar suscripciones
Cuando las suscripciones estén activas, usa estas guías para gestionarlas:
- Gestionar suscripciones — Pausa, reanuda, cancela, omite pagos, actualiza el método de pago y mucho más.
- Gestionar pagos fallidos — Comprende la lógica de reintentos, configura el comportamiento de y recupera suscripciones en estado vencido.
Preguntas frecuentes
¿Qué es la API de Suscripciones?
La API de Suscripciones te permite gestionar pagos de suscripciones. Por ejemplo, puedes utilizar MONEI Subscriptions para programar cargos automáticos en la cuenta de un cliente, por un importe fijo, semanalmente, mensualmente o anualmente.
Puedes crear suscripciones basadas en varios parámetros, incluyendo el ID, el nombre/descripción, la fecha de inicio, el importe, la divisa, el método de pago, el intervalo, la duración (periodo-final) y la información del cliente, incluyendo los datos de entrega y facturación.
Simplifica tus facturas, mejora la experiencia del cliente y consigue ingresos regulares con MONEI Subscriptions. Lo único que tienes que hacer es integrar la API de suscripciones con tu tienda online, a través de nuestra página de pago alojada. Si tu sitio web utiliza WooCommerce, puedes usar nuestro plugin de suscripciones para WooCommerce (más abajo).
Algunos casos de uso son las cajas por suscripción, los servicios de suscripción (streaming, cursos online, gimnasios) y los por alquiler o leasing.
Reintentos automáticos para pagos de suscripciones
Si el método de pago de tu cliente falla durante el pago de la suscripción porque la tarjeta ha caducado (o cualquier otra razón), llevamos a cabo las dos cosas siguientes para recuperar la transacción:
- Enviamos un email automático al cliente, pidiéndole que actualice sus datos de suscripción. Este email se manda hasta tres veces por defecto — al día 1, al día 6 y al día 15 tras el fallo de pago para una suscripción mensual (la frecuencia depende del plan de suscripciones). Este email viene de tu negocio e incluye tu logo y datos de contacto.
- Si el pago de la suscripción no se recupera, se cancela y recibirás una notificación.
También puedes personalizar los reintentos (más abajo).
Reintentos personalizados para pagos de suscripciones
Sí, puedes determinar cuándo se envían los reintentos automáticos para los pagos de suscripciones. Puedes programar reintentos por días, semanas, meses o años, aunque la suma de estos intervalos en el calendario de reintentos no puede superar el intervalo de la suscripción.
Ejemplos
- Si tu suscripción se renueva cada semana, y quieres enviar hasta 2 reintentos, ambos tienen que ser enviados en el curso de 7 días, antes de que el nuevo intervalo de la suscripción empiece.
- Si tu suscripción es mensual y quieres enviar hasta 5 reintentos, los 5 tienen que ocurrir antes de que el intervalo del mes que viene empiece.
Suscripciones en WooCommerce
El plugin de WooCommerce para MONEI incluye la opción de suscripciones. Antes de configurar las suscripciones en tu cuenta de WooCommerce, tendrás que instalar y configurar el plugin de WooCommerce para MONEI, y a continuación, comprar la extensión de WooCommerce Subscriptions.