Suscripciones con varios productos

Si ofreces varios productos o quieres cobrar diferentes importes por el mismo producto, puedes adjuntar varios productos a una suscripción. En cada período de facturación, se generará una única factura con todos los precios combinados. Solo es necesario pagar esa factura, lo que reduce tus costos y la cantidad de cargos que ve el cliente.

Cómo crear suscripciones a varios productos

Crea suscripciones a varios productos para un cliente utilizando el parámetro items. Proporciona el price y, alternativamente, una quantity para cada producto (si utilizas un valor distinto de 1):

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=price_CBXbz9i7AIOTzr \
  -d "items[1][price]"=price_IFuCu48Snc02bc \
  -d "items[1][quantity]"=2

La respuesta incluye una lista de todos los ítems, precios y cantidades de la suscripción:

{
  "id": "sub_CZEpS1Zt9QLxdo",
  "object": "subscription",
  ...
  "items": {
    "object": "list",
    "data": [
      {
        "id": "si_H1yPnAVzP9vDRW",
        "object": "subscription_item",
        "billing_thresholds": null,
        "created": 1585939321,
        "metadata": {
        },
        "price": {
          "id": "price_H1c8v1liEvrfcd",
          "object": "price",
          "active": true,
          "billing_scheme": "per_unit",
          "created": 1585856460,
          "currency": "usd",
          "livemode": false,
          "lookup_key": null,
          "metadata": {
          },
          "nickname": null,
          "product": "prod_H1c7exjJHbC4sr",
          "recurring": {
            "interval": "month",
            "interval_count": 1,
            "trial_period_days": null,
            "usage_type": "licensed"
          },
          "tiers": null,
          "tiers_mode": null,
          "transform_quantity": null,
          "type": "recurring",
          "unit_amount": 1000,
          "unit_amount_decimal": "1000"
        },
        "quantity": 1,
        "subscription": "sub_H1yPRslJXa4TUt",
        "tax_rates": [
        ]
      },

Períodos de facturación con varios precios

Los precios convencionales con un importe fijo en cada intervalo se facturan al inicio de cada ciclo de cobro. En la práctica, con cada factura, el cliente paga el siguiente intervalo de servicio. Con el cobro por uso, el importe que debe abonar el cliente varía según el consumo que tenga durante el ciclo de cobro, de manera que el cliente paga por el consumo al final.

Cuando una suscripción combina una tarifa fija con facturación por uso, se cobra el consumo medido del ciclo anterior junto con la tarifa fija, correspondiente al nuevo ciclo de facturación, al inicio de cada intervalo. La facturación por uso y la tarifa fija se combinan en una única factura.

Restricciones

El uso de varios productos en una misma suscripción genera una sola factura e implica un solo pago, por lo que todos los precios de los productos deben estar expresados en la misma moneda y tener el mismo intervalo de facturación. Además, tienes un límite de 20 productos por suscripción.

Descuentos, impuestos y períodos de prueba

Si usas varios productos, también podrás crear descuentos, cobrar impuestos y utilizar períodos de prueba como si fuera una suscripción de un solo producto. En la llamada para crear o actualizar la suscripción, deberás especificarlos como argumentos de nivel superior, ya que se aplican a la suscripción en conjunto:

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "discounts[0][coupon]"=free-period \
  -d "default_tax_rates[0]"=txr_1EO66sClCIKljWvs98IiVfHW \
  -d trial_end=1610403705 \
  -d "items[0][price]"=price_CBXbz9i7AIOTzr \
  -d "items[1][price]"=price_IFuCu48Snc02bc \
  -d "items[1][quantity]"=2

Cuando crees una suscripción especificando precios en el atributo items, no se tomará en cuenta ningún período de prueba especificado en ninguno de los precios. El período de prueba solo se respeta si creas una suscripción con un solo precio usando el atributo del plan heredado.

Varias suscripciones para un cliente

Puedes crear simultáneamente varias suscripciones para un solo cliente. Esta posibilidad es muy útil si quieres que tus clientes puedan suscribirse a varios productos con intervalos separados. Cada suscripción tiene su propio ciclo de facturación, factura y cargo, aun cuando los precios básicos tengan el mismo intervalo de facturación.

Crea varias suscripciones para un solo cliente utilizando el mismo código de creación de suscripción:

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=cus_4fdAW5ftNQow1a \
  -d "items[0][price]"=price_CZB2krKbBDOkTS

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=cus_4fdAW5ftNQow1a \
  -d "items[0][price]"=price_CZB1AX3KOacNJw

Se puede suscribir a un cliente a varios productos e incluso a un solo producto varias veces. Cada suscripción tiene una ID única y su estado se gestiona independientemente de las otras suscripciones de los clientes. Cada suscripción también tiene su propio ciclo de cobro que se basa en la delimitación del ciclo de cobro de la suscripción.

Cuando un cliente tiene varias suscripciones, la propiedad subscriptions del objeto Customer proporciona una lista de cada suscripción:

{
  "id": "cus_4fdAW5ftNQow1a",
  "object": "customer",
  "subscriptions": {
    "object": "list",
    "data": [
      {
        "id": "sub_9RRl3XywPg2P5H",
        "object": "subscription",
        ...
        "price": {
          "id": "price_CZB2krKbBDOkTS",
          "object": "price",
          "amount": 2995,
          ...
        }
      },
      {
        "id": "sub_9RRlIq2t9obFLI",
        "object": "subscription",
        ...
        "price": {
          "id": "price_CZB1AX3KOacNJw",
          "object": "price",
          "amount": 1295,
          ...
        }
      }
    ]
    ...
  }
  ...
}