> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mejoras de suscripción con Recharge

> Guía paso a paso para conectar Recharge y configurar las Mejoras de suscripción en Aftersell.

Esta página cubre todo lo específico del uso de **Recharge** con las Mejoras de suscripción. Para una descripción completa de cómo funcionan las Mejoras de suscripción, consulta [Mejoras de suscripción](/es/aftersell/subscription-upgrades).

<div id="supported-features">
  ## Funciones compatibles
</div>

Recharge admite todos los tipos de Mejora de suscripción:

* Cambiar la frecuencia de entrega o facturación
* Reemplazar por un producto de suscripción diferente
* Cambiar la frecuencia y reemplazar el producto
* Añadir otro artículo suscribible a la suscripción (consulta [Añadir un artículo](/es/aftersell/subscription-upgrades-add-item))
* Frecuencias prepagadas y pospagadas

<div id="generating-your-recharge-api-token">
  ## Generar tu token de API de Recharge
</div>

1. Inicia sesión en tu portal de comerciante de Recharge.
2. Ve a **Tools & Apps → API Tokens**.
3. Haz clic en **Create an API Token**.
4. Introduce un nombre y un correo electrónico de contacto.
5. Establece los siguientes permisos en **Read and Write**: Orders, Subscriptions, Plans. Habilita también **Read** en Products.
6. Haz clic en **Save** y copia la clave de API.

El token debe tener los cuatro alcances: `read_orders`, `read_subscriptions`, `write_subscriptions` y `read_plans`. Aftersell comprueba los cuatro cuando pruebas la clave e indica en el mensaje de error los que falten.

Para más detalles, consulta la [documentación de la API de Recharge](https://docs.rechargepayments.com/).

<div id="connecting-recharge-in-the-setup-wizard">
  ## Conectar Recharge en el asistente de configuración
</div>

Cuando llegues al **Paso 1: Conectar proveedor** en el asistente de Mejora de suscripción:

1. Selecciona **Recharge** en el desplegable **Subscription provider**.
2. Pega tu token de API en el campo **API token**.
3. Haz clic en **Test API key**. Aftersell valida el token, comprobando que se autentica correctamente, que tiene todos los alcances requeridos y que pertenece a tu tienda.
4. Una vez que la prueba pase (marca verde), haz clic en **Continue** para pasar al Paso 2.

El resultado de la prueba muestra uno de tres estados:

* **Marca verde (válido)** — el token se autenticó, todos los alcances requeridos están presentes y el token pertenece a tu tienda.
* **X roja (inválido)** — el token fue rechazado o le faltan alcances requeridos. El mensaje indica los alcances faltantes específicos. Corrige el token en Recharge y prueba de nuevo.
* **Advertencia (no se pudo verificar)** — Aftersell no pudo comunicarse con Recharge para completar la comprobación. Prueba la clave de nuevo. No puedes guardar hasta que la comprobación pase o se resuelva.

<div id="verifying-an-upgrade-in-recharge">
  ## Verificar una mejora en Recharge
</div>

Después de realizar un pedido de prueba y aceptar la oferta de mejora:

Ve a **Customers** en tu panel de Recharge, busca al cliente y abre **Subscriptions**. La suscripción activa debería reflejar la nueva frecuencia, producto o descuento de inmediato.

Recharge se actualiza casi en tiempo real tras la aceptación.

<div id="troubleshooting-recharge-specific-issues">
  ## Solución de problemas específicos de Recharge
</div>

**La mejora fue aceptada pero la suscripción no se modificó**

Las causas más comunes:

* Tu token de API ha caducado o carece de los permisos requeridos. El token debe tener `read_orders`, `read_subscriptions`, `write_subscriptions` y `read_plans`. Ve al **Paso 1: Conectar proveedor**, vuelve a probar tu clave y revisa el mensaje de error para ver los alcances faltantes específicos.
* El producto elegible en el funnel no coincide con lo que el cliente realmente suscribió.

Aftersell reintenta automáticamente las llamadas fallidas al proveedor en un flujo en segundo plano. Si todos los reintentos fallan, contacta con soporte con la URL de tu tienda, el ID del pedido de Shopify, el correo electrónico del cliente, la hora aproximada en que se aceptó la mejora y el proveedor que usas.

**El desplegable de planes de venta está vacío**

La opción "Use an existing selling plan" obtiene los planes directamente de Recharge. Si el desplegable está vacío:

* Confirma que los planes de venta están configurados en tu panel de Recharge.
* Asegúrate de que tu token de API tiene el alcance `read_plans`.
* Vuelve al **Paso 1: Conectar proveedor**, vuelve a probar tu clave de API y continúa.

***

← Volver a la [Descripción general de las mejoras de suscripción](/es/aftersell/subscription-upgrades) · [Configuración inicial](/es/aftersell/subscription-upgrades-setup) · [¿Qué son las integraciones?](/es/aftersell/subscription-upgrades-integrations)
