Cambia el precio de las suscripciones existentes

Aprende a cambiar de categoría de suscripción cambiando el precio.

Cuando un cliente cambia su suscripción, tú debes cambiar el ítem de suscripción para que refleje la nueva selección. Por ejemplo, un cliente puede cambiar a un nivel prémium o a un plan inferior de nivel básico, lo que te pedirá que reemplaces el precio subyacente de ese ítem de suscripción. Puedes hacerlo usando varios métodos diferentes.

Recuperar los identificadores

Independientemente del método que elijas, deberás proporcionar identificadores para los objetos que estás actualizando. Usa el método de suscripciones de listas con un filtro pertinente (como la ID de cliente) para encontrar la suscripción y el ítem que se actualizará.

Devuelve el conjunto de suscripciones para el cliente especificado, desde donde puedes recuperar el ID de suscripción (id), cualquier ID de ítem de suscripción (items.data.id) y el ID de precio de los ítems de suscripción (items.data.price.id).

Retrieve subscriptions response sample
{
  "object": "list",
  "url": "/v1/subscriptions",
  "has_more": false,
  "data": [
    {
      "id": "su_1NXPiE2eZvKYlo2COk9fohqA",
      "object": "subscription",
      "application": null,
      "application_fee_percent": null,
      "automatic_tax": {
        "enabled": false
      },
      "items": {
        "object": "list",
        "data": [
          {
            "id": "si_OK3pbS1dvdQYJP",
            "object": "subscription_item",
            "billing_thresholds": null,
            "created": 1690208774,
            "metadata": {},
            "price": {
              "id": "price_1NOhvg2eZvKYlo2CqkpQDVRT",
              "object": "price"
            }
          }
        ]
      }
    }
  ]
}

Actualizar la suscripción

Actualiza una suscripción e incluye los siguientes parámetros:

item ID: debes especificar el ítem de suscripción para reemplazar el precio actual por el nuevo precio. De lo contrario, si actualizas la suscripción con un nuevo precio, se agregará un nuevo ítem de suscripción y ambos precios estarán activos en la suscripción.
item price: proporciona el identificador del precio de reemplazo.
item quantity: la actualización de un precio de suscripción revierte automáticamente la cantidad al valor predeterminado de 1. Si la cantidad de suscripción vigente es distinta de 1 y deseas conservar ese valor, debes incluirla en la actualización.

Errores habituales

Debes especificar el ítem de suscripción para reemplazar el precio actual por el nuevo. De lo contrario, se agregará el nuevo precio, por lo que ambos precios estarán activos para la suscripción.

Como alternativa, puedes eliminar el ítem de suscripción actual y crear un nuevo ítem de suscripción con el precio actualizado.

Actualizar el ítem de la suscripción

Actualiza una suscripción con el siguiente parámetro:

item price: proporciona el identificador del precio de reemplazo.
item quantity: la actualización de un precio de suscripción revierte automáticamente la cantidad al valor predeterminado de 1. Si la cantidad de suscripción vigente es distinta de 1 y deseas conservar ese valor, debes incluirla en la actualización.

Usa esta opción si no tienes que hacer ningún otro cambio a nivel de la suscripción.

Períodos de facturación

Si ambos precios tienen los mismos períodos de facturación (combinación de interval e interval_count), la suscripción conserva las mismas fechas de facturación. Si los precios tienen diferentes períodos de facturación, el nuevo precio se factura en el nuevo intervalo, a partir del día del cambio. Por ejemplo, cambiar a un cliente de una suscripción mensual a otra no cambia las fechas de facturación. Sin embargo, cambiar a un cliente de una suscripción mensual a una anual cambia la fecha de facturación a la fecha del cambio. Cambiar a un cliente de una suscripción mensual a otra mientras se introduce un período de prueba, también mueve la fecha de facturación (hasta la finalización de la prueba).

Calendarios de suscripciones

Si vas a cambiar una suscripción al final de su ciclo de facturación, considera la posibilidad de usar un calendario de suscripciones para gestionar la transición. Cuando utilices los calendarios de suscripciones, asegúrate de seguir las prácticas recomendadas para evitar sobreescribir suscripciones.

Cobro por uso con medidores de cobro

Los detalles sobre las actualizaciones de mitad de ciclo de los precios asociados a un medidor de cobro se describen en la sección de modelos de precios. Especificar clear_usage cuando se actualiza un precio con un medidor de cobro no tiene ningún efecto.

Cobro por uso con registros de consumo Legacy

Si tienes un precio por consumo medido respaldado por registros de consumo heredados y actualizas a un nuevo precio de registros de consumo, el consumo se transfiere al precio nuevo.

Prorrata

Cambiar de suscripción suele implicar un prorrateo para aplicar el nuevo precio a los días restantes del período de cobro. Puedes anticiparle a tu cliente los gastos adicionales que pudieran resultar de un cambio de precio. Para ello, facilítale la vista previa de un prorrateo. Como alternativa, puedes deshabilitar los prorrateos.

Pago inmediato

Stripe intenta inmediatamente el pago ante los siguientes cambios de suscripción:

De una suscripción que no exige pago (por ejemplo, un período de prueba o una suscripción gratuita) a una suscripción paga
Cuando cambia el período de facturación

Si la facturación se hace de inmediato, pero el pago requerido falla, la solicitud de cambio de suscripción se realizará correctamente y el estado de la suscripción será past_due.

Para cobrar a un cliente de inmediato por un cambio en una suscripción en el mismo ciclo de cobro, establece proration_behavior como always_invoice. Esta configuración calcula el prorrateo y genera de inmediato una factura después de hacer el cambio. Combina esta configuración con las actualizaciones pendientes para que la suscripción no se actualice a menos que el pago se realice correctamente en la nueva factura.

Créditos por rebajas de categoría

Al facturar inmediatamente por un cambio a una categoría inferior, es posible que al cliente se le deba un crédito, que se agregará a su saldo acreedor y se aplicará a futuras facturas. Para reembolsar a tu cliente, emite reembolsos y, luego, ajusta el saldo de su cuenta a cero. Obtén más información sobre los reembolsos a los clientes en nuestra página dedicada al soporte.

Manejo de precios y cantidades de importe cero

Si realizaste la suscripción de un cliente a un precio de importe cero (por ejemplo, como prueba), cambiar el precio a un importe distinto de cero genera una factura y restablece el período de facturación a la fecha del cambio.

Si realizaste la suscripción de un cliente a un precio con un importe distinto de cero y una cantidad de cero, cambiar la cantidad a un número distinto de cero no genera una factura ni restablece el período de facturación.