Notificaciones de Stripe: el correo de disputa es el que no puedes perderte

Una disputa de Stripe llega con un plazo, y es corto. La propia documentación de Stripe dice que tienes una ventana limitada para responder, «normalmente de 7 a 21 días, según la red de la tarjeta», y que si la dejas pasar «pierdes la disputa automáticamente y no puedes recuperar los fondos en disputa». De todas las notificaciones de Stripe que puedes activar, esa es la que cuesta dinero cuando se queda sin leer.

Si prefieres que el correo de disputa de Stripe hiciera sonar tu teléfono, la ruta del correo funciona en un iPhone; las alertas push de la app de Stripe ahí necesitan un relé Bluetooth.

¿Te notifica Stripe las disputas?

Sí, en cuatro lugares. La página de disputas de Stripe menciona tu dirección de correo, el Dashboard, un evento charge.dispute.created si tu integración escucha eventos, y una notificación push de la app móvil si estás suscrito. Las disputas también están en la lista por defecto de correos que cada miembro del equipo puede activar o desactivar, y esa parte individual importa más de lo que parece.

Dos detalles de la misma página cambian lo rápido que deberías moverte.

Algunas disputas empiezan como consultas, una etapa previa a la disputa que suele aparecer cuando el titular de la tarjeta no reconoce un cargo. Stripe dice que responder en esa etapa puede detener una disputa formal y ahorra «tiempo, comisiones, y tu calificación con las redes de tarjetas». Si se escala de todos modos, respondes de nuevo.

Y solo tienes una oportunidad. «Solo tienes una oportunidad de enviar tu respuesta», escribe Stripe, y una vez enviada no puedes editarla ni añadir archivos. Así que el plazo no es en realidad de 7 a 21 días para responder. Son 7 a 21 días para encontrar la factura, los correos con el cliente, tu política de reembolso y lo que sea que demuestre que el trabajo se entregó. Luego los combinas en archivos bajo el límite de 4,5 MB de Stripe y respondes. Para el fundador de un SaaS, esa prueba suelen ser registros de uso. Para un freelancer es el contrato y el mensaje donde el cliente dijo que el trabajo se veía genial.

Contestar tampoco es gratis. Stripe cobra una comisión de disputa contestada además de la comisión de disputa recibida, y solo devuelve la comisión de contestación si ganas. El banco puede tardar hasta 3 meses en decidir, y Stripe te envía un correo cuando lo hace. Si también aceptas PayPal, sus disputas corren con otro reloj, cubierto en notificaciones de PayPal.

¿Envía Stripe una notificación de pago fallido?

A tu cliente, sí, si lo activas. A ti, depende de lo que ofrezca tu cuenta, y ahí es donde la gente se confunde.

El ajuste que la mayoría encuentra primero es Enviar correos cuando fallan los pagos con tarjeta, en la página de correos de recuperación de ingresos. Stripe es claro sobre quién lo recibe: «envía automáticamente un correo a tu cliente después de cada pago fallido» para que actualice su tarjeta. Bueno para suscripciones. No hace nada por decirte a ti que una renovación anual de 2.000 US$ acaba de fallar.

La lista publicada de Stripe de correos que te envía a ti cubre pagos exitosos, disputas, pagos marcados como riesgosos por Stripe o una regla de Radar, comisiones de aplicación de cuentas conectadas, menciones en notas, facturas pagadas con el monto equivocado y entregas de webhook fallidas. Los pagos fallidos no están en esa lista. Stripe también dice que la lista completa vive en tus propias Preferencias de comunicación, así que mira ahí antes de decidir nada. Si no se ofrece, hay dos rutas. Stripe Workflows empieza desde un disparador y puede enviarle un correo a un miembro del equipo (el ejemplo de Stripe envía un correo a alguien cuando un pago de más de 1.000 US$ tiene éxito), así que revisa si un disparador de fallo está disponible en tu cuenta. O un desarrollador puede capturar el fallo con un webhook, cubierto en la nota para desarrolladores de abajo.

Notificaciones de pago de Stripe

Un pago que llega no necesita una alarma. Tu banco te avisará. Un pago que falla es distinto. Si tu banco no puede procesar un pago, las preguntas frecuentes de pagos de Stripe dicen que puedes recibir un correo con el asunto «Se requiere una acción para reanudar los pagos desde tu saldo de Stripe». Para una cuenta bancaria cerrada, puede tardar hasta 5 días laborables en que el dinero vuelva a Stripe. Arregla los datos bancarios en el Dashboard cuando llegue ese correo, no cuando notes que el alquiler no se ha cobrado.

En el teléfono, Stripe lista las «transferencias depositadas» entre los tipos de notificación push de la app.

¿Deberías recibir un correo por cada pago exitoso?

No. Desactívalo, al menos para ti.

Los correos de pago exitoso son los ruidosos, y el ruido tiene un costo que nunca aparece en una factura. Recibe cuarenta correos de «pago recibido» a la semana de Stripe y tu cerebro archiva a Stripe como buenas noticias que pueden esperar. Luego llega el correo de disputa de Stripe y recibe el mismo vistazo de medio segundo, el mismo martes ocupado, y se desliza bajo los siguientes tres recibos. Cada correo de pago exitoso te entrena para ignorar los correos de Stripe, incluido el que tiene un plazo. Si quieres saber qué entró hoy, los gráficos de la página principal del Dashboard y el resumen diario push de la app hacen ese trabajo sin tocar tu bandeja.

¿Cómo activo las notificaciones de correo de Stripe?

En el Dashboard, abre tu configuración de Datos personales y busca Preferencias de comunicación. Stripe las aplica por usuario, así que cada compañero configura las suyas, y cualquiera puede activar o desactivar cualquier notificación por defecto. Activar las disputas para ti mismo no hace nada por la bandeja de tu cofundador. Si los dos pueden responder a una disputa, los dos deberían revisarlo.

Para la app, toca tu icono de comercio arriba a la izquierda de cualquier pantalla para abrir Cuenta y configuración, ve a Configuración global, luego Configuración de notificaciones, y usa el interruptor para cada cuenta de comercio. Luego permite las notificaciones para Stripe en los propios Ajustes de tu teléfono, porque Stripe dice que el push no funcionará sin eso. Los tipos de push de la app son resumen diario, pagos nuevos, clientes nuevos, pagos en disputa y transferencias depositadas.

Una nota para desarrolladores

Si prefieres construir tus propias alertas, los webhooks de Stripe son la herramienta. Registras un endpoint HTTPS público (en la pestaña Webhooks en Workbench, o a través de la API), eliges los tipos de evento, y Stripe te envía cada evento como JSON en tiempo real. Empieza con charge.dispute.created y payment_intent.payment_failed. Verifica el encabezado Stripe-Signature, devuelve un 2xx rápido, y espera duplicados y eventos fuera de orden. En modo en vivo, Stripe reintenta una entrega fallida hasta por tres días, y una entrega de webhook fallida es, a su vez, una de las cosas sobre las que Stripe puede enviarte un correo. Deja ese correo activado, porque la semana en que tu endpoint de alertas se rompe en silencio es la semana en que de otro modo te enterarías de una disputa por tu saldo.

¿Puede un correo de disputa de Stripe llamarme?

Los correos de notificación de Stripe pueden ir a Gmail, y ahí es donde nuestra app, OLL.E, los recoge. Escribes una vigilancia como una frase. Cuando se abre una disputa, o llega un correo sobre un pago fallido por encima de tu monto, te llama y envía un resumen del correo, y puede reenviar el correo a tu cofundador, cuyos propios ajustes de Stripe podrían estar apagados. Esa parte funciona en iPhone sin nada extra. Si dependes del push de la app de Stripe en su lugar, los teléfonos Android se pueden vigilar directamente y un iPhone necesita el llavero PinG.

Ve el correo que Stripe te envía, nada más: sin reembolsos, sin subir evidencia, sin acceso al dinero. Por eso, una vigilancia de pago fallido necesita que exista primero un correo de pago fallido, desde tus preferencias, un workflow o tu propio código de webhook.

Otra razón para vigilar la bandeja en vez de confiar en los ajustes: las preferencias de correo de Stripe le pertenecen a cada persona, no a la cuenta, así que tu cofundador puede estar recibiendo cada correo de disputa mientras tú no recibes ninguno, o al revés. OLL.E cierra esa brecha desde tu propio Gmail. Te llama cuando llega un correo de disputa, envía un resumen corto, y reenvía el correo a quien reúna la evidencia, para que la persona con los recibos se entere el mismo día. En iPhone, la vigilancia de Gmail funciona por completo; las alertas de la app de Stripe ahí necesitan PinG. Puedes empezar gratis; el plan de pago es 19,99 US$ al mes en cuanto superes las cuatro vigilancias.