PAGOS FALLIDOSGOCARDLESS

Qué hacer cuando se cancela un mandato de GoCardless

Por qué se cancelan o caducan los mandatos de GoCardless, qué pasa con sus suscripciones y pagos, cómo leer la causa y cómo configurar un nuevo mandato.

Publicado el 6 min de lectura

Qué hacer cuando se cancela un mandato de GoCardless

En GoCardless, cada pago depende de un mandato: la autorización del cliente para cargar su cuenta. Cuando el mandato se cancela, nada más funciona. Los pagos pendientes se detienen, las suscripciones que dependen de él terminan y ningún reintento puede ayudar. Es el evento más importante que gestionar bien en un negocio de domiciliación bancaria, y también aquel en el que un correo automático de “actualiza tus datos” tiene más probabilidades de equivocarse.

Esta guía cubre por qué terminan los mandatos, qué pasa con las suscripciones y los pagos que dependen de ellos, cómo leer la causa y cómo obtener un nuevo mandato cuando el cliente quiere seguir pagando. Se ciñe a la documentación de GoCardless: la referencia de eventos de mandato, la referencia de eventos de suscripción, la guía para desarrolladores Responding to mandate events y el artículo del centro de ayuda sobre los estados de mandato (todas consultadas en noviembre de 2026). El sitio de documentación de GoCardless no era accesible desde nuestro entorno de investigación, así que también comprobamos las descripciones de campos y endpoints con las bibliotecas cliente oficiales de la API de GoCardless (por ejemplo gocardless-pro-ruby), que se generan a partir del mismo esquema de API. Para la parte de pagos de la recuperación, consulta cómo recuperar pagos fallidos por domiciliación bancaria con GoCardless.

Estados de mandato

GoCardless documenta estos estados de mandato:

Estado Significado
pending_customer_approval Aún no firmado por un segundo firmante
pending_submission Aún no enviado al banco del cliente
submitted Enviado, aún no procesado
active Configurado por el banco del cliente; se pueden cobrar pagos
suspended_by_payer Suspendido por el pagador
failed No se pudo crear
cancelled Cancelado
expired Caducado por inactividad
consumed Usado y no reutilizable (solo en los esquemas autorizados por pago)
blocked Bloqueado; no se pueden crear pagos

Solo se pueden cobrar los mandatos active, y un reintento manual de pago requiere un mandato activo. Cada mandato tiene también una next_possible_charge_date, que importa cuando configuras uno de sustitución y quieres saber cuándo puedes cobrar.

Por qué se cancela un mandato

El evento cancelled viene con details.cause, details.origin y, cuando el origen es el banco, details.reason_code. Usa cause para tu lógica. GoCardless advierte de que reason_code es propio de cada esquema y puede no ser coherente entre bancos.

La guía para desarrolladores de GoCardless enumera varias causas de un mandato cancelado, entre ellas:

  • bank_account_closed: la cuenta bancaria del cliente se cerró.
  • invalid_bank_details: los datos bancarios no son válidos.
  • mandate_cancelled: el mandato se canceló.

Sobre la última, las páginas de GoCardless no son coherentes entre sí. La referencia de la API de eventos de mandato describe mandate_cancelled como un mandato cancelado por el cliente o su banco, mientras que la guía para desarrolladores más antigua lo usa para las cancelaciones hechas desde el panel o la API y describe de otra forma una cancelación del cliente en el banco. No te fíes solo de cause para distinguir “el cliente canceló en su banco” de “lo cancelamos nosotros”: lee también origin (bank, api, gocardless, customer, etc.). Un origen api significa que lo hizo tu propio sistema, o una app que conectaste.

Un mandato caducado es distinto: GoCardless caduca los mandatos por inactividad. Nadie decidió parar; el mandato simplemente no se usó.

Qué pasa con los pagos y las suscripciones

Un mandato cancelado arrastra otras cosas:

  • Pagos pendientes. La referencia de la API del endpoint de cancelación dice que cancelar un mandato cancela todos los pagos asociados que se puedan cancelar. Un pago que ya se envió a los bancos aún puede cobrarse o fallar por sí solo.
  • Suscripciones. La referencia de eventos de suscripción de GoCardless muestra suscripciones canceladas porque se canceló su mandato, con causas como mandate_cancelled, bank_account_closed e invalid_bank_details.
  • Pagos posteriores. Un pago sobre un mandato cancelado falla con la causa mandate_cancelled. No es posible reintentarlo: los reintentos requieren un mandato activo.

Así que una sola cancelación produce varios eventos: el mandato, la suscripción y posiblemente pagos. Agrúpalos por cliente antes de enviar ningún correo, o el cliente puede recibir tres mensajes sobre lo mismo.

Decide qué significa la cancelación

Antes de escribir al cliente, clasifica la cancelación en uno de tres casos:

Caso Señales Respuesta adecuada
El cliente cambió o cerró su cuenta bank_account_closed, o una cancelación seguida de que el cliente diga que cambió de banco Pedir los nuevos datos bancarios mediante un nuevo mandato
El cliente quiere dejar de pagar Cancelado en el banco, a menudo cerca de una renovación; sin respuesta Tratarlo como una cancelación: confirmarla, preguntar por qué, terminar el acceso de forma limpia
Lo canceló tu lado origin es api o el panel Revisar tus propios registros antes de decirle nada al cliente

La guía para desarrolladores de GoCardless es clara en un punto: cancela tú mismo un mandato solo si el cliente lo ha pedido expresamente.

Configurar un nuevo mandato

Cuando el cliente quiere continuar:

  1. Escribe una vez, con claridad. Di que la domiciliación se ha cancelado, que no se pueden cobrar más pagos con ella y que puede configurar una nueva en un minuto si quiere mantenerla. La guía de GoCardless recomienda avisar al cliente e invitarle a configurar un nuevo mandato si hace falta.
  2. Enlaza a un flujo alojado. En GoCardless, los nuevos mandatos se recogen con un Billing Request y su Billing Request Flow alojado. Envía ese enlace; nunca pidas datos bancarios por correo.
  3. Espera a active. Un nuevo mandato pasa por pending_submission y submitted antes de active. Si falla (por ejemplo porque la nueva cuenta no admite domiciliaciones), recibes un evento failed; pide al cliente que pruebe con otra cuenta.
  4. Recrea lo que se perdió. Crea una nueva suscripción sobre el nuevo mandato, y un pago por cualquier importe aún adeudado, en la next_possible_charge_date del mandato o después.
  5. Dile al cliente qué se cobrará y cuándo, antes de que ocurra.

¿Y reactivar el mandato?

La API de GoCardless tiene una acción reinstate para los mandatos cancelados o caducados. Vuelve a enviar el mandato a los bancos; después recibes resubmission_requested, submitted, y reinstated o failed hasta dos días hábiles más tarde, y un mandato puede volver a enviarse hasta 10 veces. Úsala solo cuando sepas que el mandato debería seguir siendo válido, por ejemplo tras un error por tu parte. Cuando el cliente canceló en su banco, reactivarlo sin su acuerdo va contra su decisión, y es probable que acabe en un fallo o una reclamación.

Mandatos caducados

Un mandato caducado es el más fácil de recuperar, porque nadie se opuso. Si piensas cobrar a un cliente cuyo mandato lleva tiempo sin usarse (un plan anual, o un cliente que hizo una pausa), comprueba el estado del mandato antes de la fecha de cobro. Si ha caducado, pide al cliente que configure un nuevo mandato con antelación, en lugar de descubrirlo con un pago fallido.

Una lista de control

  • Tu gestor de webhooks procesa los eventos de mandato, no solo los de pago.
  • Los eventos se agrupan por cliente antes de enviar ningún correo.
  • Se guardan y se leen tanto cause como origin.
  • Las cancelaciones hechas por tu propio sistema se reconocen y no se envían a los clientes como “tu banco canceló”.
  • El correo de nuevo mandato enlaza a un Billing Request Flow alojado.
  • Las suscripciones solo se recrean cuando el nuevo mandato está activo.
  • Los mandatos se comprueban antes de los cobros poco frecuentes.

Hacerlo con NoChurn

GoCardless conserva los mandatos, el cobro y los datos bancarios. NoChurn importa clientes, mandatos, suscripciones y pagos, sigue los webhooks de GoCardless y lee el estado de los mandatos (activo, cancelado, caducado). Cuando se cancela un mandato, el correo de recuperación de NoChurn escrito por la IA, que revisas, enlaza al cliente para configurar uno nuevo; cuando el cliente quiere parar, toman el relevo el flujo de cancelación con la cancelación en un clic siempre visible y los correos de win-back a los días 30, 60 y 90. Consulta NoChurn + GoCardless.

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