FLUJOS DE CANCELACIÓNGOCARDLESS

Cómo añadir un flujo de cancelación a las suscripciones de GoCardless

GoCardless permite pausar, reanudar, cambiar y cancelar suscripciones por API. Cómo crear un flujo de cancelación: motivos, una oferta y una salida limpia.

Publicado el 5 min de lectura

Cómo añadir un flujo de cancelación a las suscripciones de GoCardless

Un cliente de domiciliación bancaria que quiere irse tiene dos salidas: tu app o su banco. Si tu app se lo pone difícil, el banco está a una llamada, y un mandato cancelado o una reclamación de indemnización son un final peor para ambos que una cancelación limpia. Un buen flujo de cancelación en GoCardless trata, por tanto, en parte de conservar clientes y en parte de asegurarse de que los que se van lo hagan a través de ti.

Esta guía muestra lo que la Subscriptions API de GoCardless te permite hacer cuando un cliente quiere cancelar, y cómo construir encima un flujo de cancelación corto. Se ciñe a la documentación de GoCardless: la referencia de la API de suscripciones, la referencia de eventos de suscripción y la guía para desarrolladores Responding to mandate events (todas consultadas en noviembre de 2026). El sitio de documentación de GoCardless no era accesible desde nuestro entorno de investigación, así que comprobamos el comportamiento de los endpoints con las bibliotecas cliente oficiales de la API de GoCardless, como gocardless-pro-ruby, que se generan a partir del mismo esquema de API y llevan las mismas descripciones.

Lo que te da GoCardless

Una suscripción de GoCardless crea pagos sobre un mandato según su calendario. Su status es uno de estos:

Estado Significado
pending_customer_approval A la espera de la aprobación del cliente
customer_approval_denied El cliente no la aprobó
active Seguirá creando pagos
paused No creará pagos
finished Se han creado todos los pagos programados
cancelled Ya no creará pagos

Las cuatro llamadas que necesita un flujo de cancelación:

Cancelar

POST /subscriptions/:id/actions/cancel cancela la suscripción de inmediato; no se crean más pagos en ella. Falla con cancellation_failed si la suscripción ya está cancelada o terminada.

Un pago ya creado solo puede cancelarse mientras su estado es pending_submission (POST /payments/:id/actions/cancel). Una vez enviado a los bancos, se cobrará o fallará por sí solo. Revisa los pagos próximos al confirmar la cancelación, para no prometer “ningún pago más” cuando ya hay uno en camino.

Pausar y reanudar

POST /subscriptions/:id/actions/pause impide que la suscripción cree pagos:

  • Sin pause_cycles, queda en pausa hasta que llames a resume.
  • Con pause_cycles, queda en pausa durante ese número de ciclos, y upcoming_payments sigue mostrando las fechas de cobro posteriores.
  • Funciona con las suscripciones indefinidas o que cobran un número fijo (count) de pagos, no con las que tienen una end_date. Falla con subscription_cannot_be_paused cuando no es posible pausar.

POST /subscriptions/:id/actions/resume reanuda la creación de pagos. La fecha de cobro del siguiente pago es la earliest_charge_date_after_resume de la suscripción.

Esto hace de “pausar en lugar de cancelar” una oferta nativa en GoCardless, algo que no ocurre en todas las plataformas de pago.

Actualizar

PUT /subscriptions/:id cambia campos como el importe. GoCardless documenta límites que importan para las ofertas de descuento:

  • Falla con number_of_subscription_amendments_exceeded si el importe ya se ha cambiado 10 veces.
  • Falla con mandate_payments_require_approval si el importe cambia y el mandato requiere aprobación.
  • Falla con subscription_not_active si la suscripción ya no está activa.

Un descuento temporal cuesta, por tanto, dos modificaciones (bajar y luego volver a subir). Lleva la cuenta.

No toques el mandato

Cancelar una suscripción no cancela el mandato. La guía para desarrolladores de GoCardless dice que solo canceles un mandato si el cliente lo ha pedido expresamente. Conservarlo significa que un cliente que vuelve puede reanudar sin configurar una nueva domiciliación. Si el cliente te pide cancelar la propia domiciliación, hazlo y dilo en la confirmación.

Diseñar el flujo

1. Pregunta por qué

Una pregunta, una lista corta, un toque:

  • Demasiado caro
  • No lo uso lo suficiente
  • Solo lo necesitaba durante un tiempo
  • Falta algo
  • Me voy a otro proveedor
  • Otro

Guarda el motivo con el cliente. También puedes ponerlo en los metadata de la suscripción antes de cancelar, para que se quede con el registro de GoCardless.

2. Una oferta que encaje con el motivo

Motivo Oferta En GoCardless
Solo lo necesitaba durante un tiempo Pausa de 1 a 3 ciclos pause con pause_cycles
Demasiado caro Un precio más bajo durante unos meses update del importe, programar la vuelta al precio (2 modificaciones)
No lo uso lo suficiente Un plan más barato update del importe, o cancelar y crear una nueva suscripción sobre el mismo mandato
Falta algo, me voy Sin descuento; pide detalles Nada que cambiar

Indica el efecto exacto antes de que el cliente acepte: para una pausa, la fecha del siguiente cobro; para un descuento, el importe reducido, cuántos pagos cubre y el importe posterior.

3. Cancelar, siempre visible

El botón de cancelar va en cada paso, no después de la oferta. Un cliente que rechaza la oferta está a un clic de la confirmación, que dice:

  • que la suscripción está cancelada;
  • si algún pago ya enviado se cobrará todavía, y su fecha;
  • hasta cuándo conserva el acceso;
  • si el mandato de domiciliación sigue vigente (y cómo cancelarlo también si lo quiere).

Este último punto importa en la domiciliación bancaria. Un cliente que ve un mandato todavía listado en su banco puede cancelarlo allí “por si acaso”. Es su derecho, y es mejor que sepa que no hace falta.

Conectarlo todo

  1. Carga la suscripción y sus pagos próximos al abrir el flujo.
  2. Usa una clave de idempotencia en las llamadas de pausa, reanudación y cancelación (las bibliotecas cliente oficiales de GoCardless gestionan los conflictos de idempotencia en estas acciones), y desactiva los botones tras el primer clic.
  3. Escucha los eventos de suscripción (consulta la referencia de eventos para la lista completa de acciones) para que tu app siga sincronizada cuando los cambios vienen del panel o del propio GoCardless, por ejemplo cuando se cancela un mandato y con él sus suscripciones.
  4. Programa los seguimientos que necesitan tus ofertas: la vuelta al precio completo, el final de una pausa indefinida, un recordatorio antes de que se reanude una suscripción en pausa.
  5. Registra cada paso: motivo, oferta mostrada, respuesta, hora de la cancelación. Si más tarde llega una reclamación de indemnización, este registro te ayuda a entender qué falló.

Mide lo correcto

  • Ofertas aceptadas, por motivo.
  • Suscripciones en pausa que se reanudan y siguen pagando tres meses después.
  • Cancelaciones a través de tu flujo frente a mandatos cancelados en el banco. Si muchos clientes se van a través de su banco, la opción de cancelar es demasiado difícil de encontrar.

Hacerlo con NoChurn

GoCardless conserva la suscripción, el mandato y el cobro. NoChurn añade el flujo de cancelación: motivos, una oferta que encaja con cada motivo y una cancelación en un clic siempre visible, alojada por NoChurn o integrada en tu propia interfaz con la API headless. En GoCardless, una cancelación termina la suscripción de GoCardless y el mandato queda como elija el cliente. Los motivos de cancelación guían los correos de win-back a los días 30, 60 y 90 y alimentan la puntuación de churn. 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