Cobranças proporcionais
Alterações a uma assinatura como atualizar ou voltar a uma versão anterior pode resultar em cobranças proporcionais. Por exemplo, se um cliente atualizar de uma assinatura mensal de 10 USD para uma opção de 20 USD, serão cobrados valores proporcionais pelo tempo gasto em cada opção. Se a alteração ocorrer na metade do período de faturamento, o cliente recebe uma cobrança adicional de 5 USD: -5 USD pelo tempo não utilizado no preço inicial, e 10 USD pelo tempo restante no novo preço.
O valor proporcional é calculado assim que a API atualiza a assinatura. As datas de início e término do período de faturamento atual são usadas para calcular o custo da assinatura antes e depois da alteração.
Observação
Cobranças proporcionais são criadas somente para assinaturas licenciadas (por assento) porque são faturadas no início de cada período de faturamento.
Para saber como funcionam impostos com cobranças proporcionais, consulte Recolher impostos para pagamentos recorrentes.
Exibir uma cobrança proporcional
É possível acessar uma fatura futura para visualizar alterações na assinatura. Essa chamada de API não modifica a assinatura, ela retorna a fatura futura a partir dos parâmetros que você passar. Alterar o price
ou a quantity
resultam em cobrança proporcional. Este exemplo altera o price
e define uma data para a cobrança proporcional.
Você pode expandir a resposta de exemplo abaixo para ver:
- O crédito pelo tempo não utilizado no preço anterior nas linhas 36 a 38.
- O custo pelo tempo gasto no novo preço nas linhas 107 a 109.
- O novo subtotal e o total pela fatura nas linhas 276 a 279.
{ "account_country": "US", "account_name": "Test account", "amount_due": 3627, "amount_paid": 0, "amount_remaining": 3627, "application_fee_amount": null, "attempt_count": 0, "attempted": false, "billing_reason": "upcoming",
Você pode usar essas informações para confirmar as alterações junto ao cliente antes de modificar a assinatura. Como a Stripe faz a cobrança proporcional para a segunda, valores proporcionais podem mudar entre o momento que são visualizados e o momento em que a atualização é feita. Para evitar que isso ocorra, passe uma subscription_proration_date
na fatura quando visualizar uma alteração. Quando atualiza a assinatura, é possível passar a mesma data usando o parâmetro proration_date
em uma assinatura para que a cobrança proporcional seja calculada ao mesmo tempo.
Desativar cobranças proporcionais
A distribuição proporcional é controlada pelo parâmetro proration_behavior
e o padrão é create_prorations
.
É possível desativar as taxas proporcionais por solicitação, definindo o parâmetro proration_behavior
como none
. Não há parâmetro que desative todas as cobranças proporcionais futuras de uma assinatura. Se quiser desativar as cobranças proporcionais indefinidamente, você precisará definir proration_behavior
como none
para cada solicitação que gerar cobranças proporcionais:
Quando as cobranças proporcionais são desativadas, os clientes são cobrados no valor total no novo preço quando a próxima fatura é gerada.