Suscripciones con varios productos
Si ofreces varios productos o desea cobrar diferentes importes por el mismo producto, puedes adjuntar varios productos a una suscripción. Esto genera una única factura en cada período de facturación que combina cada precio. Solo se requiere un única pago para esa factura, lo que reduce tus costos y la cantidad de cargos que ve tu cliente.
Cómo crear suscripciones con varios productos
Crea suscripciones para varios productos para un cliente utilizando el parámetro items
. Proporciona el precio
y, como alternativa, una quantity
(cuando utilices un valor distinto de 1) para cada producto:
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": { "aggregate_usage": null, "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 facturación. En la práctica, con cada factura, el cliente paga el siguiente intervalo de servicio. Con la facturación según uso, el importe abonado por el cliente varía según el uso que tenga durante el ciclo de facturación, de manera que el cliente paga por el uso al final.
Cuando una suscripción combina una tasa fija con facturación por uso, se cobra el consumo de ese uso del ciclo de facturación anterior junto con la tasa fija para el nuevo ciclo de facturaciónal inicio de cada intervalo. La facturación por uso y la tasa fija se combinan en una única factura.
Restricciones
Debido a que usar varios productos en una suscripción genera una factura y pago únicos, todos los precios de esos productos deben utilizar la misma moneda y tener el mismo intervalo de facturación. Además, estás limitado a 20 productos en una sola suscripción.
Descuentos, impuestos y períodos de prueba
Cuando uses varios productos, también podrás crear descuentos, cobrar impuestos y utilizar períodos de prueba de la misma manera que con una suscripción para un solo producto. En la llamada de creación o actualización de la suscripción, deberás especificar que estos argumentos son de nivel superior, ya que se aplican a la suscripción en general:
When you create a subscription by passing prices into the items
attribute, it will ignore any trial period that is specified on the individual prices. The trial period is only respected if you create a subscription with a single price using the legacy plan attribute.
Varias suscripciones para un cliente
Puedes crear simultáneamente varias suscripciones para un solo cliente. Esta funcionalidad es útil cuando quieres hacer posible que tus clientes se suscriban a varios productos con intervalos separados. Cada suscripción tiene su propio ciclo de facturación, factura y cargo, aunque los precios subyacentes tengan el mismo intervalo de facturación.
Crea varias suscripciones para un cliente utilizando el mismo código de creación de suscripción:
Un cliente puede suscribirse a varios productos o incluso a un solo producto varias veces. Cada suscripción tiene un ID único y su estado se gestiona independientemente del resto de suscripciones del cliente. Cada suscripción también tiene su propio ciclo de facturación independiente, que se basa en la delimitación del ciclo de facturación 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, ... } } ] ... } ... }