> 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/integrations/step-by-step-integrate-flycode-with-recharge.md).

# Guía de integración de Recharge: conecta FlyCode con Recharge

{% hint style="info" %}
**Resumen:** Instala la aplicación FlyCode desde Recharge App Marketplace, permite las integraciones de terceros en la configuración de pagos de Recharge, establece los reintentos máximos de Recharge en 8 con "No hacer nada" cuando se alcance el máximo, acuerda una fecha de lanzamiento y ponlo en marcha. FlyCode entonces recupera los cargos fallidos de Recharge con un tiempo de reintento basado en aprendizaje automático y mensajería coordinada, mientras que Recharge y Recharge Retain siguen gestionando todo lo demás.
{% endhint %}

## Para quién es esto

Comerciantes de Shopify que ejecutan suscripciones en Recharge, con o sin Recharge Retain. FlyCode no reemplaza a Recharge; asume la recuperación de pagos fallidos, el área en la que concentra toda su inversión en producto e IA, y Retain sigue encargándose de las referidos, recompensas, prevención de cancelaciones y recuperación de clientes perdidos. Los principales comerciantes de Recharge ya usan ambos. Ver [Recharge y FlyCode: mejor juntos](#recharge-and-flycode-better-together) abajo.

## Requisitos previos

* Una tienda Shopify con Recharge instalado y un programa de suscripción activo.
* Acceso de administrador de Recharge a la configuración de Pagos y al App Marketplace.
* Una cuenta de FlyCode. Si no tienes una, [empieza](https://www.flycode.com/get-started) o solicita una [auditoría de pagos gratuita](https://www.flycode.com/churn-audit-failed-payments) primero para ver tus ingresos recuperables.

## Configuración

{% stepper %}
{% step %}

### Obtén el enlace de instalación de FlyCode para Recharge

Desde tu incorporación en FlyCode o desde Recharge App Marketplace, abre el enlace de instalación de la aplicación FlyCode para tu tienda.

<figure><img src="https://lh7-us.googleusercontent.com/ytc52NRaXKYiaZDRm2i0ATfMxey7Aa-esZslTNI7YJk48RxpfUwbCkV1Vv3CkbmwLYQejpX7TRVmlPoDZqsHydm6wawNZ1ogjDHQVbCCAZl5SDu7D-AA8lCV7tDXD4lYCckTGk9EjwnrnfjFBlWzjUM" alt=""><figcaption><p>FlyCode en Recharge App Marketplace</p></figcaption></figure>
{% endstep %}

{% step %}

### Confirma los permisos e instala

Revisa los permisos que muestra Recharge (leer clientes, suscripciones y cargos; reintentar cargos) y confirma la instalación.

<figure><img src="https://lh7-us.googleusercontent.com/-gUMqN-gFG59g4hwBHP8cZsqiVDk3gb36pt0M-LGiHOS5DPXZeNcc98QeofA95B1GtP94baaosUWy3FVHp9gbv26uBsYrdqy1Ia2yTVni_AWRyczyYBaYXVM3c4EYgiDA5ZGsdbOfgq0gF4bO1cBcPU" alt=""><figcaption><p>Confirmación de permisos</p></figcaption></figure>
{% endstep %}

{% step %}

### Cambia la configuración de pagos de Recharge

En Recharge, abre Configuración, Pagos, y establece:

1. **Permitir integración de terceros:** activado. Esto permite a FlyCode reintentar cargos.
2. **Reintentos máximos:** 8. Esto mantiene el cargo en un estado en el que puede volver a intentarse durante toda la ventana de recuperación.
3. **Cuando se alcancen los reintentos máximos:** "No hacer nada". FlyCode gestiona lo que ocurre con los cargos no recuperados, así que Recharge no debe cancelar ni omitir por sí solo.

<figure><img src="https://lh7-us.googleusercontent.com/UThVnfC2IWomEXbHksarlmTBYHAwGxMi6BUIxlRIqjjBHRuEXYZGaEi54BC7ZdXvyh6QnKIEmdPrp9a8jPZfIGad8lMF80-Fj5foXHid65UtSw1eREAtMzVlYFlPXsjHbyL8sqLBJuei0ltBjI9twF0" alt=""><figcaption><p>Configuración de pagos de Recharge</p></figcaption></figure>
{% endstep %}

{% step %}

### Establece la fecha de lanzamiento

Acuerda una fecha de puesta en marcha con FlyCode. Al activarse, FlyCode carga todos los cargos existentes en estado de error y completa retroactivamente los detalles del error, por lo que la recuperación comienza con tus cargos fallidos actuales y también con los nuevos. La carga retroactiva también se ejecuta siempre que FlyCode recibe un webhook de un cargo que no había visto antes.
{% endstep %}

{% step %}

### Prueba y ponlo en marcha

FlyCode ejecuta un plan de pruebas de extremo a extremo por comerciante para confirmar que cada opción de pago y tipo de error en tu tienda se gestiona correctamente. Una vez que las pruebas pasan, FlyCode se activa y comienza a reintentar. Si usas los correos electrónicos de pagos fallidos propios de Recharge o la cobranza de Retain, decide en este punto si FlyCode o Recharge se encargará de la mensajería al cliente para que ambos no le envíen correos al cliente.
{% endstep %}
{% endstepper %}

## Cómo se comporta FlyCode en Recharge

* FlyCode actúa sobre todos los cargos existentes y nuevos en estado de error.
* Reintenta cargos que fallaron por motivos de inventario o configuración, así como rechazos de tarjeta.
* No reintenta cargos que el procesador devolvió como rechazo definitivo; esos van a métodos de pago de respaldo o al contacto con el cliente.
* Una protección integrada nunca procesa el cargo de un mismo cliente más de 2 veces por hora.
* Los cargos recuperados y las actualizaciones de estado se escriben de vuelta en Recharge y Shopify, que siguen siendo los sistemas de registro.

## Lista de verificación para la puesta en marcha

* [ ] Aplicación FlyCode instalada desde Recharge App Marketplace
* [ ] Recharge Payments: permitir integración de terceros activado
* [ ] Recharge Payments: reintentos máximos establecidos en 8
* [ ] Recharge Payments: cuando se alcancen los reintentos máximos establecido en "No hacer nada"
* [ ] Se decidió quién es el responsable de la mensajería (FlyCode o Recharge/Retain) y se desactivaron los correos de pagos fallidos del otro lado
* [ ] Fecha de lanzamiento acordada; plan de pruebas superado

## Solución de problemas

**FlyCode no está reintentando los cargos.** Comprueba que "Permitir integración de terceros" esté activado en Recharge Payments y que la instalación de la aplicación se haya completado con los permisos confirmados.

**Recharge canceló o omitió suscripciones antes de que FlyCode terminara la recuperación.** "Cuando se alcancen los reintentos máximos" no está configurado en "No hacer nada", o los reintentos máximos son inferiores a 8.

**Los clientes recibieron correos electrónicos duplicados.** Tanto FlyCode como Recharge (o Retain) están enviando mensajes de pagos fallidos. Elige un solo responsable.

**Un cargo que falló por un motivo de inventario o configuración sigue fallando.** FlyCode lo reintentará, pero la causa subyacente (variante sin stock, tarifa de envío inválida) debe corregirse en Shopify o Recharge.

## Preguntas frecuentes

**¿Puedo conservar Recharge Retain?** Sí. Retain se encarga de las referidos, recompensas, prevención de cancelaciones y recuperación de clientes perdidos; FlyCode se encarga de la recuperación de pagos fallidos. Desactiva la recuperación de pagos fallidos de Retain para que solo un motor reintente.

**¿Necesito un desarrollador?** No. La instalación es simplemente instalar la app y configurar tres ajustes.

**¿Qué apps de Shopify admite FlyCode?** Recharge, Skio y Stay AI, además de los pagos nativos de suscripción de Shopify a través de otras apps compatibles. Ver [Plataformas de pago y suscripción compatibles](https://docs.flycode.com/docs/integrations/supported-payment-and-subscription-platforms).

## Recharge y FlyCode: mejor juntos

Recharge Retain te ofrece una suite de retención integrada en tu stack de suscripciones: referidos, recompensas, prevención de cancelaciones, recuperación de clientes perdidos y recuperación de pagos fallidos. FlyCode es el especialista en recuperación de pagos que se integra con Retain y concentra toda su inversión en IA en el diagnóstico granular de pagos fallidos (respuestas del emisor, patrones BIN, rutas de rechazo suave frente a rechazo definitivo, tokens de red, tiempo de cobranza según el motivo, personalización del mensaje y del canal por riesgo y LTV) y en la recuperación. Juntos obtienes crecimiento a lo largo del ciclo de vida y un rendimiento de pagos fallidos de primer nivel sin conflictos entre proveedores. Algunas de las marcas que usan ambos:

<figure><img src="https://857825088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FedoXR9BFShbgporwvi7n%2Fuploads%2F1GkHU6YJsEnTn2babTv5%2FFlycode%20x%20Recharge%20Logos%20(1).png?alt=media&#x26;token=2540520a-00c2-4dae-9606-29a2a8543806" alt=""><figcaption><p>Clientes compartidos de Recharge y FlyCode</p></figcaption></figure>

[Más sobre nuestros clientes](https://www.flycode.com/customers) o [solicita una auditoría de pagos gratuita](https://www.flycode.com/churn-audit-failed-payments).

## Relacionado

* [FlyCode y Shopify](https://help.flycode.com/flycode-and-shopify) en el Centro de ayuda
* [Cómo instalar FlyCode en Skio](https://docs.flycode.com/docs/integrations/how-to-install-flycode-on-skio)
* [Recupera pagos fallidos de suscripciones de Shopify con FlyCode](https://www.flycode.com/shopify/benefits)
* [Cómo gestiona FlyCode los pagos fallidos de suscripciones de Shopify](https://docs.flycode.com/docs/integrations/how-flycode-handles-shopify-subscription-failed-payments)


---

# 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/integrations/step-by-step-integrate-flycode-with-recharge.md?ask=<question>&goal=<endgoal>
```

`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.