For the complete documentation index, see llms.txt. This page is also available as Markdown.

Cómo funciona FlyCode: arquitectura del motor de recuperación

Cómo FlyCode recupera pagos fallidos de suscripciones: las señales que lee, el modelo por comerciante que decide cada reintento, las acciones que toma y las protecciones.

Resumen: FlyCode se conecta a tu plataforma de facturación (Stripe, aplicaciones de suscripción de Shopify, Braintree, PayPal, Chargebee), lee cada pago fallido y sus señales de rechazo, decide por factura qué hacer a continuación (reintentar en un momento específico, cargar una tarjeta de respaldo, enrutar a otro procesador o contactar al cliente) y luego informa los ingresos incrementales recuperados por encima de tu línea base anterior. Un solo sistema se encarga de toda la decisión de recuperación, así que nada se superpone a los reintentos de tu procesador.

Por el equipo de FlyCode. Última revisión: septiembre de 2026.

Las cuatro capas

Cada pago fallido pasa por las mismas cuatro capas. Entenderlas explica por qué los números de recuperación de FlyCode difieren de un calendario fijo de reintentos.

Capa
Qué sucede
De dónde provienen los datos

1. Entradas

FlyCode recibe la factura fallida, el código de rechazo del procesador, el código de respuesta bruto de la red, el emisor, el BIN y el tipo de tarjeta, el importe, la moneda, el historial del cliente y la zona horaria.

Webhooks de la plataforma de facturación y lecturas de la API (para Stripe: las cuatro llamadas enumeradas en la Guía de integración de Stripe) más datos de la red de tarjetas.

2. Toma de decisiones

Un modelo por comerciante clasifica el fallo (blando, duro, autenticación, fraude), predice cuándo y cómo es más probable que se apruebe un reintento y puntúa la factura por valor.

Tu propio historial de transacciones, además de los aprendizajes cruzados entre comercios de FlyCode y las señales de la red Visa y Mastercard.

3. Acciones

Reintento adaptativo en el momento elegido, intento con un método de pago de respaldo, orquestación del pago a otro procesador y, luego, correo o SMS de recuperación si el cliente debe actuar.

Se ejecuta a través de la plataforma de facturación para que la factura, la suscripción y los recibos se mantengan sincronizados.

4. Informes

Los ingresos recuperados se atribuyen contra la línea base previa a FlyCode; el panel muestra la tasa de recuperación, la recuperación incremental, los intentos por recuperación y el embudo de contacto.

Panel de FlyCode e informes periódicos.

Capa 1: lo que lee FlyCode

Un pago fallido lleva más información que el código que ves en el panel de tu procesador. El banco emisor devuelve un código de respuesta bruto, la red lo estandariza y el procesador lo traduce de nuevo (por ejemplo generic_decline en Stripe puede ocultar una docena de decisiones bancarias). FlyCode captura toda la cadena y añade contexto que el procesador no usa: el comportamiento histórico del emisor hacia tu cuenta de comerciante, el rango BIN de la tarjeta y el tipo de producto (crédito, débito, prepago), el historial de pagos del cliente contigo, el día del mes en relación con los ciclos típicos de pago y la hora local.

FlyCode nunca maneja números de tarjeta sin procesar. Los cargos los ejecuta tu procesador contra los métodos de pago que ya están almacenados allí.

Capa 2: cómo se toma la decisión

El núcleo de FlyCode es un modelo de aprendizaje automático por comerciante. Un modelo global (el tipo que ejecuta un procesador en millones de negocios) optimiza para el comerciante promedio. Un modelo por comerciante aprende que, por ejemplo, tus clientes con un emisor específico aprueban a las 9 a. m. hora local el segundo día después de un fallo, o que do_not_honor de un rango BIN dado se comporta como fondos insuficientes. El modelo responde tres preguntas para cada factura abierta:

  1. ¿Esto se puede recuperar reintentándolo? Los rechazos suaves (fondos insuficientes, emisor no disponible, errores de procesamiento, la mayoría de los rechazos genéricos) suelen serlo. Los rechazos duros (credenciales inválidas o reemplazadas, tarjeta robada o perdida, cuenta cerrada) no lo son, y reintentarlos desperdicia intentos de red. La referencia de códigos de rechazo enumera todos los códigos.

  2. ¿Cuándo es más probable que tenga éxito el siguiente intento? El momento se elige por factura, no a partir de un calendario fijo de 3, 5, 7 días, y siempre dentro de los límites de Visa y Mastercard (consulta las reglas de reintento de la red de tarjetas).

  3. ¿Vale la pena perseguir la factura? La puntuación por valor (ARR, valor de vida, antigüedad, coste de adquisición) decide cuánto dura la recuperación y si la factura se escala a una persona a través de Priority Recovery.

Capa 3: las acciones, en orden

  1. Reintentos adaptativos. El reintento se programa en el mejor momento previsto para esa tarjeta y ese emisor. El número de reintentos se mantiene dentro de las reglas de la red y un único calendario coordinado reemplaza los reintentos predeterminados del procesador.

  2. Métodos de pago de respaldo adaptativos. Cuando falla la tarjeta principal y el cliente tiene otros métodos de pago válidos guardados, FlyCode carga el siguiente mejor, sin que el cliente tenga que actuar. Ver Métodos de pago de respaldo en Stripe.

  3. Orquestación de pagos. Para los comerciantes que usan más de un procesador, el agente de orquestación sin código puede enrutar un cobro fallido a un proveedor con mayor probabilidad de aprobación.

  4. Contacto de recuperación. Solo cuando el rechazo requiere al cliente (se necesita una tarjeta nueva, se requiere autenticación) FlyCode envía un correo de marca o SMS desde tu dominio, a la hora local del cliente, con un enlace de actualización sin inicio de sesión. Los mensajes se retienen mientras hay un reintento pendiente. Consulta la colección de contacto del Centro de ayuda.

  5. Reglas del ciclo de vida. Cuando la recuperación se agota, tus reglas deciden qué sucede por producto y segmento: cancelar, anular o dejar en mora. Las cancelaciones por falta de pago pueden activar Reactivación.

Salvaguardas

  • Sin doble gestión de cobro. En Recharge, Skio, Stay AI y Chargebee, las barreras de protección enrutan los pagos fallidos a FlyCode y sincronizan de vuelta los cobros recuperados para que el cobro nativo y FlyCode nunca contacten al mismo cliente dos veces. Detalles para Shopify en Cómo gestiona FlyCode los pagos fallidos de suscripciones de Shopify.

  • Cumplimiento de red. Los recuentos de reintentos y los códigos de no reintentar siguen las reglas de Visa y Mastercard, lo que protege tu tasa de autorización en el primer intento.

  • Primero la línea base. Tu rendimiento de recuperación antes de FlyCode se mide para que el incremento, y la comisión, se calculen contra una cifra real. Ver modelo de precios explicado.

  • Controles de puesta en marcha. Las integraciones comienzan en modo de monitoreo; la recuperación se activa una vez que los ajustes del lado de la plataforma (reintentos nativos, correos nativos) están alineados.

Cómo se ven los resultados

En los resultados publicados de clientes, los equipos que pasan de los reintentos predeterminados del procesador ven un aumento de 16 a 25 puntos porcentuales en la tasa de recuperación y un incremento de 5 a 9 por ciento en ARR; frente a herramientas de cobro heredadas, el aumento es de 25 a 40 por ciento. Ejemplos: Capsho del 63 al 91 por ciento de recuperación, Gardencup del 62 al 82 por ciento con un aumento del 20 por ciento en LTV, BUBS Naturals del 51 al 66 por ciento en un mes, GitBook un impulso del 8 por ciento en ARR. Consulta Costo de pagos fallidos y ROI de la recuperación para el modelo detrás de estas cifras y puntos de referencia por segmento para la lista completa.

Preguntas frecuentes

¿FlyCode reemplaza Stripe Smart Retries o funciona junto a ellos?

FlyCode los reemplaza. Durante la configuración, los reintentos automáticos de Stripe y los correos de pagos fallidos se desactivan para que un solo motor coordinado decida cada intento. Los reintentos apilados de dos sistemas son lo que los emisores leen como actividad descoordinada y pueden reducir las tasas de autorización.

¿FlyCode almacena números de tarjeta?

No. Los cargos los ejecuta tu procesador contra los métodos de pago que ya están almacenados allí. FlyCode trabaja con tokens, objetos de factura y suscripción, y datos de rechazo.

¿Cuánto tarda FlyCode en estar en producción?

La mayoría de los comerciantes se conectan en minutos (instalación de la app de Stripe, app del marketplace de Recharge o marketplace de Skio) y ven un aumento medible en uno o dos ciclos de facturación.

¿FlyCode funciona tanto para B2B como para B2C?

Sí. Como el modelo se adapta por comerciante y no por categoría, lo usan marcas de suscripción de SaaS, software B2B, fintech y DTC. Incrementos publicados por segmento: 27 por ciento B2C, 19 por ciento B2B, 26 por ciento DTC, 23 por ciento empresas de IA (frente a herramientas anteriores).

Relacionado

¿Te fue útil?