Definir quantidade de produtos ou assinaturas
Assine um cliente para vários produtos ou para várias quantidades de um único produto, todos faturados em uma única fatura.
Talvez você precise criar assinaturas para vários produtos ou para várias quantidades do mesmo produto. Você também pode criar várias assinaturas para pessoas físicas.
Assinaturas com vários produtos
Se você oferece vários produtos ou deseja cobrar valores diferentes pelo mesmo produto, pode criar uma assinatura para vários produtos. Isso gera uma única fatura a cada período de cobrança, combinando todos os preços, e o cliente só precisa fazer um único pagamento.
Criar uma assinatura de 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,
Períodos de cobrança com vários preços
Assinaturas com tarifa fixa por intervalo são cobradas no início de cada período de cobrança (ciclo). Com cada fatura, o cliente paga efetivamente pelo próximo intervalo de serviço. Com a cobrança por uso, o valor pago pelo cliente varia de acordo com o consumo durante o período de cobrança, de modo que o cliente paga pelo uso no final.
Quando uma assinatura combina uma tarifa fixa com cobrança por uso, o uso medido do período de cobrança anterior é cobrado juntamente com a tarifa fixa do novo período de cobrança no início de cada renovação. A cobrança por uso e a tarifa fixa são combinadas em uma única fatura.
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. Além disso, você está limitado a 20 produtos em uma única assinatura.
Para lidar com vários produtos em uma assinatura que podem ter períodos de cobrança diferentes, você pode criar uma assinatura de intervalo misto .
Descontos, impostos e períodos de avaliação
Ao usar vários produtos, você também pode criar descontos, cobrar impostos e usar períodos de teste da mesma forma que faria com uma assinatura de produto único.
Forneça esses argumentos quando você criar ou atualizar uma assinatura para aplicá-los à assinatura inteira ou forneça-os no nível do item para descontar apenas um item específico.
Várias quantidades de uma assinatura
Por padrão, cada assinatura é para um produto, mas a Stripe permite que o cliente assine quantidades múltiplas de um item. Por exemplo, digamos que você administra uma empresa de hospedagem e seus clientes hospedam sites com um custo mensal de US$ 9,99 por site. A maioria dos clientes hospeda um único site e alguns hospedam vários. Você pode criar preços para um site (US$ 9,99), dois sites (US$ 19,98) e assim por diante, mas uma abordagem melhor é os clientes assinarem uma quantidade de sites pelo preço unitário de US$ 9,99.
As assinaturas têm dois tipos de cobrança por uso: licenciamento por consumo e por usuário. Você pode ativar esses modelos de cobrança definindo o valor do atributo recurring[usage_ quando cria um preço. Somente é possível especificar uma quantidade em assinaturas criadas com recurring[usage_ definido como licensed. Para cobrar preços específicos que variam dentro de um intervalo de cobrança, considere usar cobrança por uso em vez de quantidades.
Definir várias quantidades
Para definir a quantidade em uma assinatura, informe o valor de quantity ao criar ou atualizar a assinatura:
Você pode cobrar quantidades múltiplas em uma fatura, e elas são cobradas proporcionalmente quando a assinatura muda, inclusive quando as quantidades são alteradas.
Cobrar valores diferentes com base na quantidade
Em alguns casos, pode ser necessário ajustar o custo por usuário de acordo com o número de usuários em uma assinatura. Por exemplo, você pode oferecer descontos de licenciamento por volume para assinaturas que excedam certos limites de quantidade. Para ajustar o preço por usuário, use níveis.
Transformação de quantidades
Pode ser necessário acompanhar o uso em uma unidade de consumo diferente da utilizada para o faturamento. Por exemplo, considere um pacote de software de produtividade que cobra US$ 10 por grupo de 5 usuários ou menos que usam o produto. Sem a transformação de quantidade, a quantity do item de assinatura deveria ser aumentada em 1 a cada 5 usuários.
| Número de usuários | Quantidade de itens de assinatura informada à Stripe | Total |
|---|---|---|
| 1 | 1 | US$ 10 |
| 3 | 1 | US$ 10 |
| 5 | 1 | US$ 10 |
| 6 | 2 | US$ 20 |
| 7 | 2 | US$ 20 |
O parâmetro transform_quantity permite que você especifique que a Stripe deve transformar a quantidade antes de aplicar o custo unitário. A assinatura a seguir permite informar naturalmente o número atual de usuários como o valor de quantity para o item de assinatura. O sistema de faturamento da Stripe divide a quantidade por 5 e arredonda o resultado para cima antes de calcular pelo custo unitário.
Você só pode usar transform_ com billing_scheme=per_unit, pois é incompatível com preços escalonados.
Arredondamento
O exemplo anterior mostrou uma assinatura que cobra por 5 usuários com arredondamento para cima, ou seja, 6 dividido por 5 resulta em uma quantidade de 2. Se você não quiser cobrar por utilização parcial (por exemplo, cobrar por gigabyte completo consumido em um serviço de Internet de banda larga), pode definir round como down.
Uso medido
Você também pode aplicar transform_ em conjunto com a cobrança por uso. Essa transformação se aplica a preços com recurring[usage_ no final de um período de cobrança da mesma forma que se aplica a quantity para preços com recurring[usage_.
Um serviço de e-mail de marketing que cria um preço por consumo para cobrar US$ 0,10 por 1000 e-mails enviados pode ficar assim:
Com esta assinatura, o uso pode ser relatado por e-mail e você pode cobrar US$ 0,10 do cliente por 1.000 e-mails enviados.
Várias assinaturas
Você pode criar simultaneamente várias assinaturas para um único cliente. Essa funcionalidade é útil quando você deseja que os clientes assinem vários períodos de serviço distintos. Cada assinatura tem seu próprio período de cobrança, fatura e cobrança, mesmo que os preços associados tenham o mesmo período de cobrança.
Observação
Quando você cria várias assinaturas com o mesmo preço, cada assinatura é independente, incluindo seus pagamentos e períodos de cobrança. Se isso não é o que você deseja, crie uma única assinatura usando várias quantidades.
Criar várias assinaturas para um só cliente
Crie várias assinaturas para um cliente usando a API create subscription:
Um cliente pode assinar vários produtos, ou até mesmo um único produto, várias vezes. Cada assinatura possui um ID exclusivo e seu status é gerenciado independentemente das outras assinaturas do cliente. Cada assinatura também tem seu próprio período de cobrança independente, com base no 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, ... } } ] ... } ... }