CONTRACARGOSRECURLY

Contracargos con Recurly: qué muestra Recurly y dónde respondes

Cómo llegan los contracargos a Recurly: gestión nativa según la pasarela, qué hace Recurly en el estado final, débito directo y dónde respondes a una disputa.

Publicado el 6 min de lectura

Contracargos con Recurly: qué muestra Recurly y dónde respondes

Recurly factura a tus clientes, pero el pago con tarjeta en sí pasa por una pasarela como Stripe o Adyen. Cuando un cliente disputa un cargo, ese reparto lo decide todo: la disputa se abre y se responde en la pasarela, y Recurly registra las consecuencias en la factura y en la suscripción. Esta guía explica qué muestra Recurly, qué hace por su cuenta y dónde respondes realmente.

Se basa en la propia documentación de Recurly: chargeback management for cards, chargebacks and late failures for direct debit, la página de la pasarela Stripe, el dashboard de transacciones y las notificaciones de suscripción (todo consultado en noviembre de 2026). Cuando la documentación de Recurly no dice nada, lo indicamos.

Quién hace qué

Paso Dónde ocurre
El titular disputa el cargo Su banco, y luego la red de tarjetas
Se abre la disputa y se te notifica Tu pasarela
Envías pruebas o aceptas Tu pasarela, en su dashboard o su API
El banco decide Banco y red
Se actualizan la factura y la suscripción Recurly, si la gestión de contracargos está activada

La página de contracargos de Recurly es explícita sobre la respuesta: el comerciante disputa o acepta el contracargo a través de su pasarela. Recurly no envía pruebas por ti.

La gestión nativa de contracargos de tarjeta de Recurly

Disponibilidad

Según la documentación de Recurly, la gestión nativa de contracargos de tarjeta está en acceso anticipado: pides al soporte de Recurly o a tu account manager que la active. Está disponible en tres pasarelas:

  • Adyen: activa los tipos de webhook de Adyen CHARGEBACK, SECOND_CHARGEBACK y DISPUTE_DEFENSE_PERIOD_ENDED. Recurly señala que algunos estados de Adyen solo llegan después de que actúes en el dashboard de Adyen.
  • Chase Orbital: Chase da a Recurly acceso a sus informes de contracargos con el Partner ID de Recurly; no se configura nada dentro de Recurly.
  • Stripe: el estado del contracargo y el código de motivo aparecen en la Admin UI de Recurly, y Recurly te remite a los códigos de motivo de Stripe para su significado. La página de Stripe de Recurly dice que los eventos de webhook que usa no necesitan configuración adicional en Stripe.

Para otras pasarelas, la documentación que encontramos no describe una gestión nativa de contracargos, y al menos la página de una pasarela (Ebanx) dice que los contracargos no se reflejan. Consulta la página de tu pasarela en la documentación de Recurly.

Qué hace Recurly, y cuándo

Recurly actúa cuando el contracargo llega a un estado final: aceptado, perdido o vencido. En ese momento recibe un evento “Chargeback Completed” de la pasarela y:

  1. crea una factura de reembolso externo, con origen Chargeback;
  2. crea una transacción de contracargo, que aparece con el estado Chargeback en el dashboard de transacciones;
  3. hace vencer la suscripción asociada. Otra parte de la documentación de Recurly dice que las suscripciones afectadas “pueden” vencer automáticamente según tus ajustes, así que comprueba cómo está configurada la tuya.

De ahí se siguen dos consecuencias. Primero, nada cambia en Recurly mientras la disputa está abierta; la suscripción sigue renovándose salvo que actúes. Segundo, la documentación de Recurly que encontramos no describe qué pasa en Recurly cuando ganas una disputa, ya que las acciones están ligadas a aceptado, perdido y vencido. Si ganas, revisa tú mismo la factura y la suscripción.

Un solo sistema de contracargos a la vez

Recurly admite herramientas de contracargos de terceros como alternativa, pero solo puede haber un sistema activo por sitio. Cuando se activa una herramienta de terceros, Recurly deja de procesar los eventos de contracargo de la pasarela para las pasarelas compatibles. Elige una sola fuente de verdad.

El débito directo es distinto

Para los débitos bancarios, la página de débito directo de Recurly describe los contracargos y los fallos tardíos, con GoCardless como ejemplo principal y dos modos:

  • Modo por defecto: cuando Recurly recibe el webhook del contracargo, crea él mismo una transacción de reembolso.
  • Modo manual: Recurly envía una notificación de webhook por cada contracargo y no hace nada; tú decides qué hacer. En este modo el filtro de estado Chargeback de la página de transacciones no devuelve nada, porque no se crean transacciones de reembolso por contracargo.

Recurly indica que las Webhook Options de la pasarela deben estar activadas para que funcione la gestión automática. En los dos modos envía un webhook por cada evento de contracargo.

Dónde respondes: la pasarela

Como la respuesta ocurre en la pasarela, tu proceso allí decide el resultado. Si tu pasarela es Stripe, explicamos el ciclo de vida de la disputa, los campos de pruebas y los plazos en cómo ganar contracargos en Stripe. Sea cual sea la pasarela, las pruebas de un negocio de suscripción vienen en gran parte de lugares en los que Recurly puede ayudar:

  • Historial de la suscripción: cuándo se registró el cliente, qué plan, cuántas renovaciones pagó sin disputa. Las páginas de cuenta y de factura de Recurly lo guardan.
  • Registro de la cancelación: si la disputa dice “ya cancelé”, Recurly tiene canceled_at y expires_at de la suscripción, y la notificación canceled que recibiste. Si no hay cancelación, eso también es una prueba.
  • Condiciones mostradas al registrarse, incluido cómo cancelar y cuándo se producen las renovaciones.
  • Correos enviados: correos de factura, de renovación o de recuperación que recibió el cliente, de Recurly o tuyos.
  • Uso: inicios de sesión y actividad en tu producto durante el periodo cobrado. Esto está en tus sistemas, no en Recurly.
  • Conversaciones de soporte con el cliente, desde tu helpdesk.

Un proceso que funciona

  1. Conoce lo que admite tu pasarela. Comprueba si tu pasarela es una de las tres con gestión nativa, y si está activada para tu sitio.
  2. Recibe los avisos en la pasarela, no al final. Recurly actúa en el estado final; para entonces el plazo de las pruebas ya ha pasado. Suscríbete a las notificaciones de disputas en la propia pasarela.
  3. Decide enseguida qué hacer con la suscripción. Si el titular dice que el cargo no era suyo, la siguiente renovación en esa tarjeta probablemente también se dispute. Plantéate cancelar la suscripción en Recurly mientras la disputa está abierta, en lugar de esperar a que Recurly la haga vencer.
  4. Reúne pruebas de Recurly y de tus propios sistemas, y responde en la pasarela antes de su plazo.
  5. Concilia al final. Cuando Recurly cree la factura de reembolso y la transacción de contracargo, comprueba que el estado de la suscripción coincide con lo que decidiste, y gestiona a mano las disputas ganadas.
  6. Busca patrones. Las disputas por “suscripción cancelada” apuntan a un proceso de cancelación difícil de encontrar o que no se cumple; las disputas por “no reconocido” apuntan a tu descriptor de pago o a que faltan recordatorios de renovación.

Hacerlo con NoChurn

Con Recurly, las disputas vienen de la pasarela que tiene detrás. Si esa pasarela es Stripe o Braintree, NoChurn lee la disputa, reúne pruebas automáticamente (respuestas del flujo de cancelación, correos que envió NoChurn, uso que envías por API y conversaciones de un helpdesk conectado, en solo lectura) y redacta una respuesta con IA que solo se envía a la pasarela después de que una persona de tu equipo la revise. La decisión del banco, las tasas y los plazos se quedan en la pasarela y en las redes, y las facturas y suscripciones se quedan en Recurly. NoChurn también añade flujos de cancelación con una cancelación en un clic siempre visible, lo que ayuda a evitar las disputas del tipo “ya cancelé”. Consulta NoChurn + Recurly.

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