PAGOS FALLIDOSMOLLIE

Cómo gestionar los pagos recurrentes fallidos con Mollie

Cómo gestiona Mollie los pagos de suscripción fallidos: mandatos, reintentos y bajas automáticas, webhooks solo con ID, contracargos y volver a cobrar.

Publicado el 7 min de lectura

Cómo gestionar los pagos recurrentes fallidos con Mollie

Mollie hace que los pagos recurrentes sean fáciles de poner en marcha: un primer pago crea un mandato, y las suscripciones o los cobros bajo demanda funcionan sobre ese mandato. Lo que pasa cuando falla uno de esos cobros es menos evidente. ¿Reintenta Mollie? ¿Cuándo cancela la suscripción? ¿Qué recibe realmente tu webhook? ¿Y cómo vuelves a tener al cliente con un método de pago que funcione?

Esta guía responde a esas preguntas a partir de la documentación de Mollie: pagos recurrentes, webhooks, webhooks de nueva generación, status reasons, la Chargebacks API, Update subscription y los artículos del centro de ayuda de Mollie sobre pagos por adeudo directo SEPA fallidos y mandatos tras una devolución (todos consultados en noviembre de 2026).

Cómo funcionan los pagos recurrentes de Mollie

El modelo de Mollie tiene tres piezas, descritas en la guía de pagos recurrentes:

  1. Un primer pago. Creas un pago para un cliente con sequenceType en first. El cliente lo completa en el checkout normal.
  2. Un mandato. Cuando el primer pago funciona, Mollie guarda un mandato para ese cliente y ese método de pago. Un mandato no limita el importe ni el número de cobros.
  3. Cobros recurrentes. O creas tú los pagos con sequenceType en recurring (requiere un mandato con estado valid), o creas una suscripción y Mollie cobra según su intervalo. Para las suscripciones, el cliente necesita un mandato en estado pending o valid.

El cliente solo pasa por el checkout una vez. Es la fuerza del modelo, y también la razón por la que la recuperación es distinta de las plataformas con tarjeta guardada: cuando un mandato deja de funcionar, no hay un formulario de “actualizar tarjeta” en el propio mandato. El cliente tiene que hacer un nuevo primer pago.

Qué pasa cuando falla un pago de suscripción

Mollie sí reintenta. Según la guía de pagos recurrentes:

  • Si falla un pago de suscripción, Mollie puede volver a intentarlo hasta 5 veces, una vez al día, según el motivo del fallo.
  • El comportamiento de los reintentos puede variar según el método de pago y el motivo del fallo.
  • Si un reintento funciona, la fecha del próximo cobro se actualiza a partir del último pago correcto y de tu intervalo.
  • Cuando se agotan todos los reintentos, la suscripción se cancela.

Algunos motivos de fallo se saltan ese patrón. La misma página enumera motivos que cancelan la suscripción de inmediato y otros que la cancelan cuando se repiten:

Comportamiento Ejemplos de motivos SEPA indicados por Mollie
Cancelación inmediata IBAN no válido (AC01), cuenta cerrada (AC04), deudor fallecido (MD07)
Cancelación cuando el mismo problema se repite Sin mandato (MD01), devolución solicitada por el cliente (MD06), rechazo del deudor (MS02), motivo no especificado

Si la suscripción tiene un mandato fijo (su campo mandateId), cancelarla por estos motivos también revoca el mandato.

Una advertencia: un artículo de ayuda más antiguo de Mollie da otro umbral para las suscripciones SEPA (cancelación tras 2 fallos, no aplicable a fondos insuficientes). La documentación para desarrolladores es la referencia más reciente, pero prueba el comportamiento con tus propios métodos de pago en lugar de dar por hecho una cifra. Para los fondos insuficientes (AM04), el centro de ayuda de Mollie sugiere volver a intentar el adeudo directo o contactar con el cliente.

Dos consecuencias prácticas:

  • Necesitas saber cuándo canceló Mollie una suscripción, porque tu app tiene que reaccionar. Las suscripciones canceladas no pueden modificarse mediante la API, así que recuperar implica crear una suscripción nueva.
  • Los reintentos por sí solos no arreglarán una cuenta cerrada ni un mandato revocado. Esos clientes tienen que volver a pagar pasando por el checkout.

Webhooks que solo llevan un ID

Los webhooks clásicos de Mollie son mínimos a propósito. Como explica la referencia de webhooks, Mollie llama a tu webhookUrl con un parámetro POST id, el ID del objeto que cambió (para un pago, id=tr_...), y nada más. Tu handler tiene que obtener el objeto de la API y leer su estado actual.

Lo que hay que construir alrededor:

  1. Obtén siempre el objeto. No deduzcas lo que pasó por el hecho de que haya llegado una llamada. Lee el pago, comprueba su estado y, en los pagos de suscripción, comprueba el ID de la suscripción y el estado de la propia suscripción.
  2. Devuelve HTTP 200 rápido. Mollie trata cualquier otra cosa, o una respuesta de más de 15 segundos, como un fallo, y reintenta con intervalos crecientes, hasta 10 intentos en unas 26 horas. No puedes volver a disparar a mano una llamada de webhook desde Mollie.
  3. Haz que el procesamiento sea idempotente. El mismo pago puede notificarse más de una vez, y el estado que lees puede haber cambiado desde que se envió la llamada.
  4. Concilia de forma periódica. Como no puedes reproducir las llamadas, un job periódico que liste los pagos y suscripciones recientes recoge todo lo que se perdió un endpoint caído.

Mollie también ofrece webhooks de nueva generación, firmados con una cabecera X-Mollie-Signature calculada con tu secreto de webhook. Si los usas, verifica la firma antes de actuar. En cualquier caso, trata tu propia lectura de la API como la fuente de verdad.

Contracargos

Los clientes pueden devolver pagos, y Mollie los expone mediante la Chargebacks API:

  • GET /v2/chargebacks lista los contracargos de todos tus pagos, del más reciente al más antiguo, paginados.
  • Los endpoints a nivel de pago listan u obtienen los contracargos de un pago.

Con el adeudo directo SEPA, un cliente puede devolver un pago en un plazo de 8 semanas y, según el centro de ayuda de Mollie, Mollie revoca el mandato tras una devolución. Cualquier cobro posterior necesita un mandato nuevo, así que un contracargo sobre un pago recurrente también es un problema de método de pago, no solo un importe perdido. Para las disputas de tarjeta, el artículo sobre contracargos de tarjeta de Mollie explica que, según el caso, puedes responder con documentación dentro de un número limitado de días.

Cuando llega un contracargo sobre una suscripción, decide de forma explícita: pausar el acceso, contactar al cliente o terminar la suscripción. No dejes que el siguiente cobro programado descubra que el mandato ya no existe.

Pedir al cliente que vuelva a pagar

Cuando se han agotado los reintentos, el mandato está revocado o la cuenta está cerrada, recuperar implica que el cliente vuelva a pasar por el checkout. El flujo que sigue el modelo documentado de Mollie:

  1. Detecta el fallo desde tu handler de webhooks después de obtener el pago, y anota el motivo del fallo según la referencia de status reasons cuando esté disponible.
  2. Escribe al cliente el mismo día. Explica que el pago no se pudo cobrar, sin citar códigos bancarios, e incluye un solo enlace.
  3. Haz que el enlace apunte a un nuevo primer pago. Crea un pago para el mismo cliente con sequenceType first por el importe pendiente. Pagarlo salda lo que se debe y crea un mandato nuevo en un solo paso. Los enlaces de pago de Mollie son otra forma de cobrar el importe, pero comprueba si el método que usas crea un mandato para los cobros futuros.
  4. Reinicia la suscripción sobre el nuevo mandato una vez cobrado el pago. Si Mollie ya había cancelado la suscripción antigua, crea una nueva con una fecha de inicio que encaje con el periodo que el cliente acaba de pagar.
  5. Envía recordatorios si no se usa el enlace: a los pocos días, y después un aviso final con la fecha en que termina el acceso.
  6. Ofrece otro método de pago en el recordatorio. Un cliente cuya cuenta bancaria se cerró puede preferir una tarjeta, y el primer pago le permite elegir.

Una lista de control

  • Tu handler de webhooks obtiene cada objeto y devuelve 200 rápido.
  • Guardas el estado de la suscripción y reaccionas cuando Mollie la cancela.
  • Los motivos definitivos (cuenta cerrada, IBAN no válido, mandato revocado) pasan directamente a un correo de “vuelve a pagar”, sin esperar.
  • Los fondos insuficientes reciben tiempo: los propios reintentos de Mollie, más un recordatorio.
  • Se revisan los contracargos y marcan el mandato como inutilizable en tu app.
  • Un job programado concilia pagos y suscripciones por si se perdieron llamadas de webhook.

Hacerlo con NoChurn

El procesamiento de pagos, los mandatos, los reintentos de Mollie y los datos de tarjeta y bancarios siguen en Mollie. NoChurn se conecta a tu cuenta de Mollie, importa clientes, mandatos y suscripciones y, como los webhooks de Mollie solo llevan un ID, vuelve a leer el pago antes de actuar. Añade correos de recuperación escritos por IA que revisas antes de que salgan, con un enlace para volver a pagar y configurar un nuevo método de pago. Los contracargos se muestran en solo lectura en la cronología del cliente y cuentan en el churn score de 0 a 100. NoChurn también añade flujos de cancelación con motivos, ofertas y una cancelación en un clic siempre visible, y correos de win-back los días 30, 60 y 90 según el motivo de cancelación. Consulta NoChurn + Mollie.

PROMPT

Read https://www.nochurn.sh/llms.txt,
then follow https://docs.nochurn.sh/quickstart/
to add NoChurn to this app. Use a test key
(nc_test_…) until I say we go live.

Deja de perder ingresos.

  • Gratis hasta 300 € de MRR
  • Sin tarjeta
  • Listo en 10 minutos
  • Sin comisión