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.

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_closedeinvalid_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:
- 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.
- 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.
- Espera a
active. Un nuevo mandato pasa porpending_submissionysubmittedantes deactive. Si falla (por ejemplo porque la nueva cuenta no admite domiciliaciones), recibes un eventofailed; pide al cliente que pruebe con otra cuenta. - 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_datedel mandato o después. - 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
causecomoorigin. - 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.