> For the complete documentation index, see [llms.txt](https://docs.flycode.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flycode.com/docs/es/guides/how-flycode-works-architecture-of-the-recovery-engine.md). # Cómo funciona FlyCode: arquitectura del motor de recuperación {% hint style="info" %} **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. {% endhint %} *Por el equipo de FlyCode. Última revisión: septiembre de 2026.* {% hint style="success" %} **Puntos clave** * FlyCode reemplaza el motor de reintentos en lugar de añadir intentos encima de él. Los reintentos integrados de tu procesador y los correos de cobro se desactivan para que una sola capa coordinada decida cada intento con una tarjeta. * Las decisiones se toman por comerciante, no a partir de un promedio global: el modelo se entrena con tus propias razones de rechazo, respuestas del emisor, patrones de BIN, tipos de tarjeta, geografía y señales del ciclo de saldo, usando más de 100 puntos de datos por transacción y datos de la red Visa y Mastercard. * La recuperación silenciosa va primero (reintentos y métodos de pago de respaldo). Se contacta a los clientes solo cuando la red realmente necesita que actúen, y cada mensaje se secuencia con los reintentos para que a nadie se le envíe un correo sobre un cobro que está a punto de salir bien. * La configuración toma minutos, no se requiere ingeniería y el precio es un porcentaje de los ingresos recuperados por encima de tu línea base medida. {% endhint %} ## 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](/docs/es/integrations/stripe-integration-guide-for-flycode.md)) 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](/docs/es/read-more/stripe-decline-codes-reference-meaning-soft-or-hard-and-what-to-do.md) 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](/docs/es/read-more/card-network-retry-rules-for-failed-payments-visa-and-mastercard.md)). 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](/docs/es/guides/priority-recovery-and-dynamic-recovery-handling-high-value-failed-invoices.md). ## 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](/docs/es/guides/backup-payment-methods-on-stripe-for-subscription-recovery.md). 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](/docs/es/guides/recovery-sms-when-to-add-sms-to-failed-payment-outreach.md) 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](https://help.flycode.com/failed-payment-outreach). 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](/docs/es/guides/reactivation-winning-back-customers-cancelled-for-non-payment.md). ## 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](/docs/es/integrations/how-flycode-handles-shopify-subscription-failed-payments.md). * **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](/docs/es/read-more/flycode-pricing-model-explained.md). * **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](/docs/es/failed-payment-cost-recovery-roi.md) para el modelo detrás de estas cifras y [puntos de referencia por segmento](/docs/es/read-more/involuntary-churn-benchmarks-by-segment.md) 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 * [¿Qué es FlyCode?](/docs/es/introduction/what-is-flycode.md) * [Plataformas de pago y suscripción compatibles](/docs/es/integrations/supported-payment-and-subscription-platforms.md) * [Guía completa de Stripe Smart Retries](/docs/es/stripe-smart-retries-complete-guide.md) * [Referencia de métricas y reportes de recuperación](/docs/es/read-more/recovery-metrics-and-reporting-reference.md) * [¿Cómo decide la IA de FlyCode cuándo reintentar?](https://help.flycode.com/ai-powered-payment-recovery) en el Centro de ayuda --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.flycode.com/docs/es/guides/how-flycode-works-architecture-of-the-recovery-engine.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.