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.

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
- 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. - 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.
- Reúne los registros de facturación, uso del producto, correo y soporte, para el cliente y el periodo disputado.
- Elige las categorías permitidas para este código de motivo y asigna cada registro a una.
- Escribe el resumen, añade el texto y los archivos de pruebas.
- Finaliza antes de tu fecha límite interna.
- Sigue el resultado con los webhooks
dispute_wonydispute_lost, por código de motivo. - 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.