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.

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_CHARGEBACKyDISPUTE_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:
- crea una factura de reembolso externo, con origen Chargeback;
- crea una transacción de contracargo, que aparece con el estado Chargeback en el dashboard de transacciones;
- 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_atyexpires_atde 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
- 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.
- 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.
- 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.
- Reúne pruebas de Recurly y de tus propios sistemas, y responde en la pasarela antes de su plazo.
- 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.
- 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.