CONTRACARGOSBRAINTREE

Cómo ganar contracargos en Braintree

Guía práctica de las disputas de Braintree: tipos y estados, fechas límite, códigos de motivo, pruebas por categoría en cargos recurrentes y cuándo aceptar.

Publicado el 6 min de lectura

Cómo ganar contracargos en Braintree

Un contracargo en una suscripción rara vez tiene que ver con una tarjeta robada. Lo más habitual es que el cliente olvidara que se había suscrito, no reconociera el descriptor o creyera que había cancelado. Esos casos se pueden ganar cuando tienes los registros adecuados y los envías en el formato que espera Braintree. Las herramientas de Braintree son buenas, pero estrictas: si se te pasa la fecha o pones las pruebas en la categoría equivocada, la respuesta nunca llega al banco.

Esta guía recorre cómo estructura Braintree las disputas, las reglas de pruebas que importan en la facturación recurrente y un proceso que puedes aplicar a cada caso. Se ciñe a la documentación de Braintree: el resumen de disputas, Managing disputes via the API, Evidence requirements, el objeto de respuesta Dispute, Chargeback reason codes, Disputing chargebacks, Dispute: Accept y PayPal disputes (todo consultado en noviembre de 2026). Para las llamadas básicas de la API y los nombres de los webhooks, consulta la sección de disputas de recuperar pagos de suscripción fallidos en Braintree.

Tipos y estados de disputa

El objeto dispute tiene un kind (tipo) y un status (estado).

Tipos:

Tipo Qué es
Retrieval Una solicitud de información sobre una transacción
Chargeback El banco del titular revierte la transacción
Pre-arbitration Una etapa posterior, después de un contracargo

Estados: Open, Accepted, Auto Accepted, Disputed, Won, Lost y Expired. «Disputed» significa que has enviado pruebas y esperas la decisión del banco. «Expired» significa que la fecha límite de respuesta pasó y perdiste el derecho a impugnar.

Las transacciones de PayPal procesadas mediante Braintree siguen el proceso propio de PayPal, con tres etapas (retrieval, claim, chargeback) descritas en la guía de disputas de PayPal de Braintree. Braintree señala que los retrievals y las claims resueltos mediante PayPal o tu pasarela no generan tarifas de disputa, mientras que una disputa escalada a contracargo puede conllevar tarifas del emisor o del banco.

Aceptación automática de las pre-arbitrations

Según el artículo sobre cómo disputar contracargos de Braintree, desde el 27 de agosto de 2025 Braintree acepta automáticamente las pre-arbitrations de menos de 1.000 $ para los comercios con tarifa plana en EE. UU., y cobra una tarifa por procesar la pre-arbitration sea cual sea el resultado. Si estás en ese grupo, tu esfuerzo debe ir a la respuesta al primer contracargo.

La fecha límite de respuesta lo es todo

Cada disputa tiene una fecha límite de respuesta. Según Braintree, debes añadir tus pruebas y finalizar antes de esa fecha, o el banco no tendrá en cuenta tu respuesta. Si no respondes, se envía una respuesta Accept en tu nombre. Subir pruebas sin finalizar cuenta como no responder.

Reglas prácticas:

  • Usa Dispute: Search filtrado por fecha límite de respuesta para listar todo lo que vence en los próximos días.
  • Fija una fecha límite interna dos días laborables antes de la fecha límite de respuesta.
  • Las pruebas solo se pueden añadir o quitar (con Dispute: Remove Evidence) mientras la disputa está Open.

Los códigos de motivo que afectan a los negocios de suscripción

El artículo de códigos de motivo de contracargo y la referencia de disputas incluyen, entre otros:

  • Transacción recurrente cancelada: el titular dice que se le cobró un cargo recurrente que canceló o intentó cancelar. Los códigos de las marcas de tarjeta que lista Braintree incluyen Visa 41 y 1320, Mastercard 41 y 4841, Discover 4541 y American Express C28.
  • Fraude / no autorizado: el titular dice que no hizo la compra.
  • No recibido: el titular dice que no recibió el producto o el servicio.

En las suscripciones, la pareja habitual es «recurrente cancelada» y «fraude» de clientes que olvidaron la suscripción. Cada una necesita pruebas distintas.

Pruebas por categoría: la regla que hace tropezar a los equipos

Los requisitos de pruebas de Braintree dicen que cuando respondes a una disputa de fraude o de no recepción, debes clasificar cada prueba según el requisito que cumple. Una tabla de la misma guía indica qué categorías acepta cada código de motivo; usar una categoría no permitida para ese código es un error de validación, y también lo es finalizar sin pruebas válidas.

Dos categorías importan más en la facturación recurrente:

  • RECURRING_TRANSACTION_ID: el ID de una transacción recurrente anterior no disputada del mismo servicio.
  • RECURRING_TRANSACTION_DATE_TIME: la fecha de esa transacción. Braintree la exige siempre que proporcionas un ID de transacción recurrente (o un ARN); una respuesta sin ella se rechaza.

La prueba de un historial de transacciones recurrentes anteriores no disputadas es uno de los tipos de prueba que Braintree indica para algunas disputas de fraude y de no recepción. Dicho de forma sencilla: si la misma tarjeta te pagó durante meses sin quejas, dilo, en la categoría correcta, con fechas.

Cuando disputas desde el Control Panel, Braintree añade automáticamente a tu respuesta detalles de la transacción como los resultados de AVS y CVV.

Qué enviar, según el motivo

Motivo Pruebas que lo responden
Transacción recurrente cancelada Tu política de cancelación tal como se mostró en el registro; el historial de la cuenta del cliente sin solicitud de cancelación antes del cargo (o la fecha en que canceló y que el cargo fue anterior); avisos de renovación enviados
Fraude (el cliente no lo reconoce) Pagos recurrentes anteriores no disputados en la misma tarjeta (clasificados), datos del registro, inicios de sesión y uso después del cargo disputado
No recibido / servicio no prestado Registros de uso del periodo facturado, registros de acceso, conversaciones de soporte en las que el cliente usó el servicio

Mantén cada documento centrado. Un resumen de una página que expone los hechos con fechas, seguido de los registros que lo respaldan, es más fácil de leer para un analista del banco que una exportación larga.

Cuándo aceptar

Dispute: Accept cierra una disputa Open a favor del cliente. La documentación de Braintree añade una nota importante: si ya reembolsaste la transacción, no aceptes; envía el reembolso como prueba. Acepta cuando:

  • el cliente sí canceló y aun así le cobraste (corrige el error y reembolsa a los demás clientes afectados);
  • las pruebas que tienes no responden al código de motivo;
  • el importe es menor que el tiempo que llevaría una respuesta, y no tienes ningún patrón que defender.

Un proceso para cada disputa

  1. Entra el webhook. Con dispute_opened, obtén la disputa y registra el tipo, el motivo, el importe y la fecha límite de respuesta.
  2. Detén los cargos futuros si procede. Es poco probable que un cliente que disputa una renovación pague la siguiente. Decide si cancelas la suscripción o pausas el acceso mientras el caso está abierto.
  3. Reúne los registros de facturación, uso del producto, correo y soporte, para el cliente y el periodo disputado.
  4. Elige las categorías permitidas para este código de motivo y asigna cada registro a una.
  5. Escribe el resumen, añade el texto y los archivos de pruebas.
  6. Finaliza antes de tu fecha límite interna.
  7. Sigue el resultado con los webhooks dispute_won y dispute_lost, por código de motivo.
  8. Corrige la causa. Un descriptor poco claro, un aviso de renovación que faltaba, un botón de cancelar difícil de encontrar: cada disputa perdida debería cambiar algo. Para la prevención, consulta normas de click to cancel y avisos de renovación de planes anuales.

Prueba antes de pasar a producción

El sandbox de Braintree puede simular resultados: enviar el texto compelling_evidence y finalizar pasa una disputa de prueba a Won, y losing_evidence simula una pérdida (guía de pruebas). Úsalo para comprobar de principio a fin tu lógica de clasificación y de finalización.

Hacerlo con NoChurn

Braintree se queda con la disputa, la decisión y los fondos. NoChurn sigue los webhooks de disputas de Braintree y reúne pruebas automáticamente: respuestas del flujo de cancelación, correos enviados, uso del producto y conversaciones de soporte. Redacta una respuesta con IA, y no se envía nada a Braintree hasta que una persona de tu equipo la ha revisado y aprobado. Las conversaciones de soporte vienen de conectores de help desk en solo lectura y se citan tal cual. Consulta NoChurn + Braintree.

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