Definir quantidades de assinaturas

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 faturamento por uso: faturamento por consumo e licenciamento por usuário. Você pode ativar esses modelos de faturamento definindo o valor do atributo recurring[usage_type] quando cria um preço. Somente é possível especificar uma quantidade em assinaturas criadas com recurring[usage_type] definido como licensed. Para faturar preços específicos que variam dentro de um intervalo de faturamento, considere usar faturamento por consumo em vez de quantidades.

Definir quantidade maior que 1

Para definir a quantidade em uma assinatura, informe o valor de quantity ao criar ou atualizar a assinatura:

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

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 de acordo com a 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.

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.

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d nickname="Standard Cost Per 5 Users" \
  -d "transform_quantity[divide_by]"=5 \
  -d "transform_quantity[round]"=up \
  -d unit_amount=1000 \
  -d currency=usd \
  -d "recurring[interval]"=month \
  -d "recurring[usage_type]"=licensed \
  -d product={{PRODUCTIVITY_SUITE_ID}}

No momento, a única transformação disponível é a divisão, usando o parâmetro divide_by com o parâmetro round.

Você só pode usar transform_quantity 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_quantity em conjunto com o faturamento por consumo. Essa transformação se aplica a preços com recurring[usage_type]=metered no final de um período de faturamento da mesma forma que se aplica a quantity para preços com recurring[usage_type]=licensed.

Um serviço de e-mail de marketing que cria um preço por consumo para cobrar US$ 0,10 por 1.000 e-mails enviados pode ficar assim:

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d nickname="Metered Emails" \
  -d "transform_quantity[divide_by]"=1000 \
  -d "transform_quantity[round]"=down \
  -d unit_amount=10 \
  -d currency=usd \
  -d "recurring[interval]"=month \
  -d "recurring[usage_type]"=metered \
  -d product={{MARKETING_EMAILS_ID}}

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.