CONTRACARGOSSTRIPE

Cómo ganar contracargos en Stripe

Cómo funcionan las disputas de Stripe en suscripciones: estados, categorías de motivo, campos de pruebas, plazos, tasas, alertas de fraude y Smart Disputes.

Publicado el 8 min de lectura

Cómo ganar contracargos en Stripe

Un contracargo en un pago de suscripción te cuesta el pago, una tasa y parte de tu reputación ante las redes de tarjetas. Tienes una sola oportunidad de responder, normalmente en unas pocas semanas, y el banco decide solo con lo que envías. Esta guía explica cómo funciona el proceso de disputa en Stripe y cómo preparar un expediente de pruebas que encaje con un negocio de suscripción.

Se basa en la propia documentación de Stripe: how disputes work, respond to disputes, las categorías de códigos de motivo de las disputas, los códigos de motivo de las disputas, las buenas prácticas para las pruebas, el objeto Dispute, Smart Disputes y la FAQ sobre tasas de disputa (todo consultado en noviembre de 2026). Cuando las páginas de Stripe dejan un vacío, lo indicamos.

El ciclo de vida de una disputa

Una disputa empieza cuando el titular contacta con su banco. Stripe crea entonces un objeto Dispute en el cargo y envía el webhook charge.dispute.created. A partir de ahí, el objeto Dispute pasa por un pequeño conjunto de estados:

Estado Qué significa
warning_needs_response Una consulta (todavía no un contracargo) que necesita respuesta
warning_under_review Una consulta en revisión después de que enviaras pruebas
warning_closed Una consulta cerrada sin convertirse en una disputa formal
needs_response Un contracargo que necesita respuesta
under_review Un contracargo en revisión después de que enviaras pruebas
won / lost Resuelto a tu favor / a favor del cliente
prevented Una disputa que se evitó antes de convertirse en un contracargo formal

Las consultas importan porque, según Stripe, no se retiran fondos salvo que la consulta escale a disputa. Si pierdes una consulta, escala: el estado cambia con un evento charge.dispute.updated y los fondos se retiran con charge.dispute.funds_withdrawn. Cuando termina el caso, se dispara charge.dispute.closed con won, lost o warning_closed.

En cuanto a los plazos, la página how disputes work de Stripe dice que normalmente tienes de 7 a 21 días para responder después de que se cree un contracargo, según la red de tarjetas, y que el emisor suele tardar de 60 a 75 días en decidir después de que envíes las pruebas. Todo el proceso puede llevar de dos a tres meses. El plazo exacto de cada caso está en el objeto Dispute y en el Dashboard; trabaja siempre con esa fecha, no con una regla general.

Tasas

Stripe cobra una tasa de disputa cuando se abre una disputa, y una tasa aparte por responder si la impugnas. Según la FAQ sobre tasas de disputa y la página de precios de Stripe en EE. UU., en EE. UU. las dos son de $15.00; la tasa por responder se devuelve si ganas, y la tasa de disputa no se devuelve salvo que tu contrato diga otra cosa. Los importes varían según el país, así que consulta la página de precios del tuyo. Aceptar una disputa no evita la tasa de disputa.

Para las disputas de cumplimiento de Visa y Mastercard, Stripe cobra una tasa adicional de la red de 500 USD (o el equivalente local) si la impugnas, que se devuelve si ganas.

Categorías de motivo

Cada red tiene sus propios códigos de motivo. Stripe los asigna a un valor reason en la disputa, que es lo primero que hay que leer porque decide qué pruebas mirará el banco. La página de categorías los enumera; los tres que más aparecen en las suscripciones son:

  • fraudulent: el titular dice que no autorizó el pago (por ejemplo Visa 10.4, Mastercard 4837).
  • subscription_canceled: el titular dice que se le cobró después de cancelar (Visa 13.2, Mastercard 4841, Amex C28).
  • product_not_received: el titular dice que no recibió lo que pagó (Visa 13.1, Mastercard 4855).

Existen otros valores, como duplicate, credit_not_processed, product_unacceptable y general. Usa la página de códigos de motivo para ver lo que espera la red en cada caso.

Lo que Stripe acepta como pruebas

Envías las pruebas a través del Dashboard o actualizando la disputa mediante la API. El hash evidence tiene campos de archivo y campos de texto. Algunos que importan para las suscripciones, con las descripciones de Stripe parafraseadas del objeto Dispute:

Campo Tipo Úsalo para
cancellation_policy Archivo Tu política de cancelación tal como se mostró al cliente
access_activity_log Texto, máx. 20.000 caracteres Registros que prueban que el cliente usó el producto: direcciones IP, fechas y horas, actividad
customer_communication Archivo Correos o mensajes con el cliente
uncategorized_text / uncategorized_file Texto / archivo Cualquier cosa relevante que no encaje en otro campo

Las limitaciones que Stripe documenta en respond to disputes y en las buenas prácticas:

  • Un solo envío. Solo puedes enviar una vez. Después no puedes editar la respuesta ni añadir pruebas.
  • Prepara primero. Actualizar la disputa con submit=false guarda las pruebas sin enviarlas. Una petición posterior con submit=true (el valor por defecto) las envía al banco.
  • Un archivo por tipo de prueba. Combina varios documentos de un mismo tipo en un único archivo de varias páginas.
  • Límites de tamaño. Los archivos tienen un límite combinado de 4,5 MB, y las pruebas de Mastercard un límite combinado de 19 páginas. Todos los campos de texto juntos tienen un límite de 150.000 caracteres. Si el expediente compilado es demasiado largo, la API devuelve dispute_evidence_page_limit_exceeded.
  • Sin enlaces. Stripe indica que los bancos no revisan contenido externo, así que no te bases en URL ni en “llámanos”.

Pruebas que funcionan para las suscripciones

La página de códigos de motivo de Stripe da la dirección para cada categoría. Traducido a un negocio de suscripción:

Suscripción cancelada

El banco quiere saber si el cliente canceló realmente antes del cargo, y si aceptó las condiciones.

  1. Muestra la prueba de que el cliente aceptó las condiciones de la suscripción, incluido cómo y cuándo podía cancelar. Sube la sección correspondiente de la política como cancellation_policy, no todas tus condiciones; Stripe sugiere resaltar la parte que se aplica.
  2. Da el registro de la cancelación con fechas y horas exactas. Si el cliente nunca canceló, o canceló después del cargo, dilo con el registro del sistema.
  3. Si usó el producto después de la fecha en la que dice haber cancelado, incluye el uso con fechas, horas e IP en access_activity_log.
  4. Si reembolsaste algo, incluye el registro del reembolso.

Fraude

El titular dice que nunca autorizó el pago. Para una suscripción, la respuesta más sólida es que el mismo cliente lleva un tiempo pagando y usando la cuenta.

  1. Muestra el historial: pagos anteriores no disputados con la misma tarjeta, fecha de creación de la cuenta, el correo registrado.
  2. Muestra el uso de la cuenta: inicios de sesión, direcciones IP, dispositivos, actividad alrededor de la fecha de facturación.
  3. Incluye cualquier comunicación de ese cliente que muestre que conoce el servicio.

Producto no recibido

Para los servicios digitales, Stripe apunta a los registros de inicio de sesión, los registros de descargas y las fechas y horas de uso, además de tus condiciones. Muestra que la cuenta se activó y se usó durante el periodo cobrado.

Escribe una nota de presentación breve

Sea cual sea el motivo, pon un resumen sencillo en uncategorized_text: quién es el cliente, qué compró, qué pasó y qué documento adjunto prueba cada punto. El revisor lee muchos casos; haz que el tuyo sea fácil de seguir.

Alertas tempranas de fraude

Los emisores de Visa, Mastercard y JCB pueden enviar alertas tempranas de fraude (EFW) sobre pagos que sospechan que son fraudulentos, a menudo antes de cualquier disputa. Stripe las expone como objetos Early Fraud Warning y con el webhook radar.early_fraud_warning.created. El campo actionable del objeto es true solo mientras el cargo no tiene disputa y no se ha reembolsado por completo.

La recomendación de Stripe es no reembolsar todas las alertas. Su documentación dice que un reembolso no elimina la alerta en sí y que solo evita la denuncia de fraude cuando se procesa como reversión, lo que suele ocurrir en unas dos horas tras la captura. Stripe sugiere que reembolsar tiene más sentido para cargos más o menos iguales o inferiores a tu tasa de disputa, y da un ejemplo de Workflows que reembolsa por debajo de ese importe y avisa a una persona por encima. Para una suscripción, plantéate también cancelar la suscripción en esa tarjeta para que la siguiente renovación no cree una segunda disputa.

Smart Disputes

Stripe ofrece Smart Disputes, que reúne un expediente de pruebas a partir de los datos que Stripe ya tiene y, si no haces nada, lo envía justo antes del plazo. Puedes desactivar el envío automático en el Dashboard. La documentación de Stripe dice que la tasa de Smart Disputes solo se cobra cuando se gana la disputa; consulta las condiciones actuales en esa página, ya que Stripe presenta el producto como una vista previa. Smart Disputes solo puede usar los datos que tiene Stripe, así que las pruebas que están en tus propios sistemas (inicios de sesión, uso, conversaciones de soporte) tienen que venir de ti.

Una lista para responder

  1. Suscríbete a charge.dispute.created, charge.dispute.updated, charge.dispute.closed y radar.early_fraud_warning.created.
  2. En cada disputa, lee primero reason y el plazo de respuesta.
  3. Decide rápido si aceptas. Si el cliente sí canceló y se le cobró de todos modos, aceptar y arreglar la causa puede ser la respuesta honesta.
  4. Reúne pruebas para ese motivo: condiciones aceptadas, registro de cancelación, registros de uso, comunicaciones.
  5. Prepara las pruebas con submit=false, comprueba los límites, haz que alguien las revise y luego envíalas una vez.
  6. Registra el resultado y el motivo, para poder arreglar los patrones que causan disputas (descriptor de facturación poco claro, botón de cancelar difícil de encontrar, recordatorios de renovación que faltan).

Hacerlo con NoChurn

NoChurn lee las disputas de Stripe y reúne automáticamente las pruebas de cada una: las respuestas del cliente en el flujo de cancelación, los correos que envió NoChurn, los datos de uso que envías por API y las conversaciones de un helpdesk conectado (en solo lectura). Redacta la respuesta con IA, y no se envía nada a Stripe hasta que una persona de tu equipo la haya revisado. Stripe sigue decidiendo las tasas, los plazos y el resultado con el banco, y NoChurn no puede cambiarlos. NoChurn es gratis por debajo de 300 € de MRR, con todas las funciones en todos los planes (tu propio dominio para correos y páginas alojadas como opción de 14,99 € al mes en cualquier plan). Consulta NoChurn + Stripe.

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