Skip to main content
Esta página cubre todo lo específico del uso de Stay AI con las Mejoras de suscripción, incluidas sus limitaciones particulares. Para una descripción completa de cómo funcionan las Mejoras de suscripción, consulta Mejoras de suscripción.

​
Funciones compatibles

Stay AI admite todos los tipos de Mejora de suscripción:
  • Cambiar la frecuencia de entrega o facturación (se aplica a toda la suscripción)
  • Reemplazar por un producto diferente
  • Ambos: cambiar la frecuencia y reemplazar el producto
  • Añadir otro artículo suscribible a la suscripción (consulta Añadir un artículo). Si el cliente ya está suscrito a ese producto, Stay aumenta su cantidad en lugar de añadir una línea nueva (esto tiene una condición de coincidencia de precio; consulta las limitaciones más abajo).
  • Frecuencias pospagadas (pago por entrega), incluido el paso de una suscripción pospagada a un plan de pago por adelantado (con las condiciones que se indican más abajo)
Los cambios de producto son compatibles excepto a un producto que solo se vende con planes de pago por adelantado; consulta la limitación sobre prepago más abajo.

​
Pasar una suscripción a un plan de pago por adelantado

Cambiar una suscripción pospagada a un plan de pago por adelantado (prepagado) es compatible, con dos condiciones:
  • El plan de pago por adelantado debe existir de antemano en Stay AI y estar asignado al producto. Aftersell no puede crear uno; la oferta solo te permite elegir entre los planes ya configurados en Stay AI.
  • El cambio crea una nueva suscripción y cancela la anterior. Stay realiza este cambio creando una nueva suscripción en el plan de pago por adelantado y cancelando la original, por lo que la suscripción obtiene una nueva referencia. Las herramientas de almacén, 3PL o informes que hacen seguimiento de las suscripciones por referencia deben volver a sincronizarse. Consulta Cumplimiento y mapeo 3PL.

​
Limitaciones específicas de Stay AI

  • Las suscripciones prepagadas (de pago por adelantado) no se pueden modificar. Stay no permite ningún cambio en una suscripción que el cliente ha pagado por adelantado, sea cual sea el tipo de mejora. Si un cliente con un plan prepagado acepta una oferta de mejora, la mejora se cancela y se le reembolsa, por lo que la suscripción queda intacta. Por el mismo motivo, no puedes cambiar una suscripción a un producto que solo se vende con planes de pago por adelantado.
  • Las cancelaciones se limitan a una app por cuenta. Stay envía las actualizaciones de cancelación a una sola app por cuenta. Si otra app o integración se registró en el webhook de cancelación de Stay antes que Aftersell, Aftersell no puede recibir esas actualizaciones, y el gráfico de suscripciones canceladas no reflejará las cancelaciones de Stay. La clave de API que conectes debe incluir el permiso Webhooks (consulta más abajo) para que el seguimiento de cancelaciones funcione.
  • Un cambio de frecuencia se aplica a toda la suscripción. Stay tiene un único calendario por suscripción, así que cambiar la frecuencia con la que llega mueve todos los productos que contiene. Cuando la suscripción contiene dos o más productos, debes activar Keep on existing subscription en la oferta; de lo contrario, la mejora de frecuencia se rechaza y se reembolsa al comprador. Esto solo es necesario para los cambios de frecuencia: los cambios de producto y los complementos no se ven afectados y funcionan sin ello.
  • Añadir más unidades de un producto al que el cliente ya está suscrito requiere un precio coincidente. Cuando el complemento es un producto que el cliente ya tiene, Stay aumenta su cantidad en lugar de añadir una línea, pero solo si el precio de la oferta coincide con lo que el cliente ya paga por él. Si los precios difieren (por ejemplo, el complemento ofrece un 20% de descuento mientras que su plan tiene un 10%), la mejora se rechaza y la suscripción no se modifica. Dale al complemento el mismo descuento que el plan del cliente u ofrece un producto diferente (un producto diferente no se ve afectado).
  • La moneda debe coincidir con los precios de tu tienda. Si la suscripción del cliente se factura en una moneda en la que tu tienda no tiene precios, la mejora se rechaza.
  • Las suscripciones duplicadas de un mismo pedido no se pueden distinguir. Si un solo pedido inició dos suscripciones de Stay que contienen el producto de la oferta, Aftersell no puede saber a cuál se refería el cliente, y la mejora se rechaza en lugar de aplicarse al contrato equivocado.
  • Los límites de solicitudes limitan el rendimiento. Stay permite 60 solicitudes por minuto por cuenta. Una mejora requiere de cuatro a seis solicitudes, por lo que una tienda alcanza un máximo de entre 10 y 15 mejoras por minuto en momentos de máxima actividad.

​
Generar tu clave de API de Stay AI

  1. En tu panel de Stay AI, ve a Account → API tokens → Add API key.
  2. Al crear la clave, selecciona All permissions. Aftersell necesita acceso a Subscriptions, Orders, Selling Plan Groups y Webhooks. El permiso Webhooks es el que permite a Aftersell enterarse de las cancelaciones.
  3. Copia la clave y guárdala en un lugar seguro. Trátala como una contraseña.
Para más detalles, consulta la documentación de autenticación de la API de Stay AI.

​
Conectar Stay AI en el asistente de configuración

Cuando llegues al Paso 1: Conectar proveedor en el asistente de Mejora de suscripción:
  1. Selecciona Stay AI en el desplegable Subscription provider.
  2. Pega tu clave de API en el campo API key.
  3. Haz clic en Test API key. Aftersell valida la clave, comprobando que se autentica correctamente 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 dos estados:
  • Marca verde: “API key verified”. La clave se autenticó y pertenece a tu tienda. Continue queda ahora habilitado. Si a la clave le falta el permiso Webhooks, la prueba igualmente pasa, pero avisa de que no se registrarán las cancelaciones de suscripciones; vuelve a crear la clave en Stay AI con All permissions si quieres hacer seguimiento de las cancelaciones.
  • Icono rojo de cancelación. La comprobación no salió limpia. Lee el mensaje junto al icono: o bien la clave fue rechazada, o bien Aftersell no pudo completar la comprobación (“Could not verify the API key. Please try again.”), que es una llamada fallida y no una clave defectuosa; en ese caso, simplemente prueba de nuevo.
Un resultado de no-se-pudo-verificar se ve exactamente igual que un rechazo, así que guíate por el mensaje y no por el icono. Continue permanece deshabilitado hasta que la comprobación vuelva en verde, y editar el proveedor o la clave borra el resultado anterior.

​
Verificar una mejora en Stay AI

Después de realizar un pedido de prueba y aceptar la oferta de mejora: Ve a Subscriptions en tu panel de Stay AI y busca la suscripción del cliente. La frecuencia de facturación, el producto o la fecha del próximo cargo deberían reflejar el cambio. El cambio en sí se aplica en cuanto Aftersell procesa la aceptación, pero Stay puede tardar en incorporar un pedido nuevo: la mejora suele aparecer en cuestión de minutos, y hasta en 24 horas en los casos más lentos. Si el cambio aún no está ahí, espera un poco antes de tratarlo como un fallo.

​
Si no se puede aplicar una mejora

Las mejoras de Stay AI son seguras por diseño: nunca se cobra a un comprador por una mejora que no se realizó:
  • Las mejoras fallidas se reintentan automáticamente. Si una llamada a Stay AI falla, Aftersell la reintenta en un flujo en segundo plano.
  • Si aun así no se puede aplicar, se reembolsa al comprador. Una Mejora de suscripción solo cobra una pequeña línea provisional en el pedido de Shopify (no un producto que el comprador conserva), por lo que Aftersell reembolsa ese cargo cuando la mejora no se puede completar.
  • Todo lo que no se puede confirmar se marca para revisión manual en lugar de suponerse, de modo que nunca se cobra a un comprador por una mejora que no se realizó.
Para conocer el mecanismo completo de reintentos y conciliación (compartido entre proveedores), consulta Cómo funcionan las Mejoras de suscripción.

​
Solución de problemas específicos de Stay AI

La mejora fue aceptada pero la suscripción no se modificó Las causas más comunes:
  • El cliente tiene un plan prepagado (de pago por adelantado). Stay no permite modificar contratos prepagados, por lo que la mejora se cancela y se reembolsa. Esto es lo esperado.
  • La suscripción se factura en una moneda en la que tu tienda no tiene precios, por lo que la mejora fue rechazada.
  • La suscripción tiene dos o más productos y cambiaste la frecuencia sin activar Keep on existing subscription.
  • Un pedido inició dos suscripciones de Stay que contienen el producto de la oferta, por lo que Aftersell no pudo saber cuál mejorar.
  • Tu clave de API pertenece a otra tienda o le falta un permiso requerido (Subscriptions, Orders o Selling Plan Groups). Vuelve a crear o selecciona de nuevo la clave en Stay AI, ve al Paso 1: Conectar proveedor y vuelve a probarla.
  • 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. Las cancelaciones de Stay no aparecen en la analítica Stay envía las actualizaciones de cancelación a una sola app por cuenta. Si otra app se registró en el webhook de cancelación de Stay antes que Aftersell, Aftersell no puede recibirlas. Confirma que ninguna otra integración tiene el webhook de cancelación de Stay y asegúrate de que la clave de API conectada incluye el permiso Webhooks.
← Volver a la Descripción general de las mejoras de suscripción · Configuración inicial · ¿Qué son las integraciones?