Assinaturas com vários produtos

Crie assinaturas com vários produtos cobrados em uma única fatura.

Se você oferece vários produtos ou pretende cobrar valores diferentes pelo mesmo produto, pode associar vários produtos a uma assinatura. É gerada uma única fatura por período de faturamento, que combina todos os preços. A fatura exige um único pagamento, reduzindo os custos e o número de cobranças recebidas pelo cliente.

Criar assinaturas com vários produtos

Crie assinaturas de vários produtos para um cliente usando o parâmetro items. Informe price e quantity (quando o valor for diferente de 1) para cada produto:

A resposta inclui uma lista de todos os itens, preços e quantidades de assinaturas:

{
  "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 faturamento com vários preços

Os preços convencionais que cobram um valor fixo por intervalo são faturados no início de cada ciclo de faturamento. A cada fatura, o cliente paga pelo próximo intervalo de serviço. Com o faturamento por consumo, o valor pago pelo cliente varia conforme o consumo durante o ciclo de faturamento. Em outras palavras, o cliente paga pelo uso efetivo ao final do ciclo.

Quando uma assinatura combina uma taxa fixa com uso medido, o consumo do ciclo de faturamento anterior é cobrado com a taxa fixa do novo ciclo de faturamento no início de cada intervalo. O faturamento por consumo e a taxa fixa são combinados em uma única fatura.

Restrições

Como o uso de vários produtos em uma assinatura gera uma única fatura e um único pagamento, todos os preços desses produtos precisam usar a mesma moeda e ter o mesmo intervalo de faturamento. Além disso, você está limitado a 20 produtos em uma única assinatura.

Descontos, impostos e períodos de avaliação

Quando você usa vários produtos, pode criar descontos, cobrar impostos e usar períodos de avaliação da mesma forma que com uma assinatura de um único produto. Esses dados devem ser informados como argumentos de nível superior na chamada de criação ou atualização de assinatura, pois se aplicam à assinatura em geral:

Quando você cria uma assinatura passando preços no atributo items, todos os períodos de avaliação especificados nos preços individuais são ignorados. O período de avaliação só é respeitado se você criar uma assinatura com um único preço usando o atributo de plano antigo.

Várias assinaturas para um cliente

Você pode criar simultaneamente várias assinaturas para um único cliente. Esse recurso é útil quando você deseja que os clientes assinem vários produtos com intervalos distintos. Cada assinatura tem seu próprio ciclo de faturamento, fatura e cobrança, mesmo que os preços associados tenham o mesmo intervalo de faturamento.

Crie várias assinaturas para um cliente usando o mesmo código de criação de assinatura:

Você pode criar uma assinatura com vários produtos ou com um único produto várias vezes para um cliente. Cada assinatura tem um ID exclusivo e um estado independente das demais assinaturas do cliente. Além disso, cada assinatura tem seu próprio ciclo de faturamento independente baseado na âncora do ciclo de faturamento da assinatura.

Quando um cliente tem várias assinaturas, a propriedade subscriptions do objeto Customer fornece uma lista de cada assinatura:

{
  "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,
          ...
        }
      }
    ]
    ...
  }
  ...
}