Proporcione maior flexibilidade para assinaturas
Use o modo de cobrança flexível para oferecer funções aprimoradas e acessar recursos adicionais.
O modo de faturamento flexível oferece um comportamento de faturamento preciso e previsível, além de recursos adicionais para o gerenciamento de assinaturas. Definir billing_ em uma assinatura altera o comportamento dos objetos de Assinatura ao longo de seu ciclo de vida e em resposta a upgrades, downgrades e cancelamentos.
O modo de faturamento flexível oferece recursos diferentes para gerenciar assinaturas em comparação ao modo de faturamento clássico. Consulte Diferenças entre o modo de faturamento clássico e o flexível para obter mais detalhes.
Para usar o modo de faturamento flexível, sua integração precisa estar na versão 2025-06-30.basil ou posterior da API do Stripe. Saiba como atualizar a versão da sua API. Não é possível fazer downgrade do modo de faturamento flexível para o modo de faturamento clássico.
Limitações
O modo de faturamento flexível não é compatível com todos os recursos do Stripe Billing. Os seguintes recursos são incompatíveis e retornam um código de status 400 quando você cria e atualiza uma assinatura com o modo de faturamento flexível habilitado:
- Avaliações pagas
- Cobrança por uso antiga
- Integrações legadas de impostos de terceiros usando '
pay_immediately=false - Pré-cobrança Prévia privada
retry_específico da assinatura Private previewsettings - O uso do parâmetro obsoleto
max_occurences
Configurar modo de cobrança
Crie uma nova assinatura com modo de cobrança flexível
Migrar assinaturas existentes para o modo de cobrança flexível
Você pode migrar suas assinaturas existentes para o modo de faturamento flexível. Os comportamentos flexíveis se aplicam a todas as novas atividades na assinatura após a migração. No entanto, a Stripe não recalcula recursos criados antes da migração, incluindo a pro rata pendente Invoice Items.
Diferenças entre o modo de faturamento clássico e flexível
Cálculos de divisão proporcional de crédito
Os pro rata de crédito são emitidos quando os clientes rebaixam suas assinaturas ou cancelam itens da assinatura antes do final do período de cobrança. O modo de cobrança flexível calcula os pro rata de crédito com base no valor original debitado anteriormente ao cliente.
Para obter uma visão geral completa dos cálculos pro rata de crédito, consulte Pro rata de crédito.
| Clássico | Flexível |
|---|---|
| Quando uma atualização de uma assinatura gera um pro rata de crédito, os valores de pro rata de crédito são calculados com base no valor do preço atual do item da assinatura, imposto, quantidade e os últimos descontos usados. | Quando a atualização de uma assinatura gera um pro rata de crédito, esses pro rata usam o valor debitado original em vez dos valores atuais da assinatura. |
Aplicação de desconto proporcional para rateios
Aplicamos descontos proporcionais a cada item da assinatura durante cálculos de pro rata em vez de distribuí-los uniformemente. Isso resulta em mais pro rata, especialmente ao faturar por item ou cancelar itens com descontos distribuídos de forma desigual.
| Clássico | Flexível |
|---|---|
| Distribuímos os descontos uniformemente por todos os itens de assinatura. | Aplicamos descontos proporcionalmente a cada item de assinatura durante os cálculos proporcionais. |
Preços por consumo
Suprimir itens de linha de valor zero ao adicionar itens baseados em uso
O modo de faturamento flexível não cria itens de linha de valor zero quando você adiciona itens baseados em uso a uma assinatura. Se a fatura estiver vazia, não geraremos uma.
Por exemplo, ao adicionar um item baseado no uso mensal durante a criação ou a atualização da assinatura:
| Clássico | Flexível |
|---|---|
Um item de linha 0 USD é gerado na fatura para o item baseado em uso. Isso também se aplica ao atualizar uma assinatura sem precisar adicionar um item baseado em uso usando proration_. | Um item de linha 0 USD não é adicionado à fatura referente ao item baseado no uso. Se a fatura resultante não contiver nenhum item, não geraremos uma. |
Itens de fatura com base no uso com base no preço no momento do relatório
O modo de cobrança flexível cobra pelo uso com base no preço que estava em vigor quando o uso foi relatado, e não no preço mais recente.
Por exemplo, o uso de um cliente é relatado como:
- Uso em 5 de janeiro: 1000 chamadas de API a 0.1 USD por 100 chamadas (Preço A).
- Mudança de preço em 15 de janeiro: o preço muda para 0.15 USD por 100 chamadas (Preço B).
- Uso em 20 de janeiro: 500 chamadas de API.
| Clássico | Flexível |
|---|---|
A Stripe só cobra pelo uso que foi informado desde a mudança para o preço atual.
Valor total da fatura = 0.75 USD. | A Stripe cobra por todo o uso no período atual pelo preço em vigor no momento em que é declarado.
Valor total da fatura = 1.75 USD. |
Cobrar pelo uso não faturado ao remover itens baseados no uso
O modo de faturamento flexível gera um item da fatura para uso não faturado ao remover um item de assinatura baseado em uso. Isso se aplica a remoções usando a API ou durante transições de fase de agendamento.
| Clássico | Flexível |
|---|---|
| Nenhum item da fatura é gerado para uso não faturado ao remover um item assinatura baseado em uso. | Um item de fatura é gerado para uso não faturado ao remover um item de assinatura baseado em uso. |
Redefinir a âncora do ciclo de cobrança
O modo de cobrança flexível só redefine sua âncora do ciclo de cobrança em atualizações de assinatura quando você define explicitamente billing_ para um valor diferente de unchanged.
| Clássico | Flexível |
|---|---|
O billing_ é redefinido automaticamente para a data atual quando uma assinatura muda para um preço diferente com um intervalo recorrente diferente, de preços com valor zero para preço diferente de zero, ou quando o cancel_at é transferido para uma data anterior à próxima vez que o ciclo da assinatura é reiniciado. | O billing_ nunca é redefinido automaticamente. |
Faturamento consolidado para transições de fase de programação de assinatura com itens baseados no uso
O modo de faturamento flexível gera consistentemente uma única fatura quando uma assinatura faz seu ciclo. Essa mudança elimina faturas separadas para itens removidos com base no uso e melhora a consistência do faturamento.
Quando sua assinatura com itens baseados no uso transita entre fases:
| Clássico | Flexível |
|---|---|
| Duas faturas são geradas. | Uma única fatura consolidada é gerada. Essa fatura inclui itens baseados no uso e licenciados, aplica os descontos da fase anterior à cobrança por uso e utiliza as alíquotas da fase seguinte. |
Cancelamento de assinatura agendado
Você pode desabilitar pro rata para um primeiro período de assinatura truncado (ao definir cancel_ na criação) usando o parâmetro proration_.
| Clássico | Flexível |
|---|---|
| Cobranças proporcionais são aplicadas ao primeiro período de assinatura. | Os pro rata não são aplicados ao primeiro período de assinatura. |
Definir assinaturas retroativamente
Quando a retrodatação é consistente com o faturamento regular, o modo de faturamento flexível cria itens de linha de fatura separados para cada período de cobrança dentro do intervalo retrodatado. Ele também alinha automaticamente a âncora do ciclo de faturamento à backdate_ quando não definida explicitamente. A retrodatação não será compatível se a fatura resultante tiver mais de 250 itens de linha.
Por exemplo, uma assinatura precisa ter uma data retroativa devido a uma fatura não paga nos dois últimos ciclos de cobrança. O cliente foi faturado por dois períodos retroativos diferentes:
- Período de cobrança 1 (1º de março a 31 de março):
- Uso relatado: 100 GB de armazenamento usados.
- Preço: 10 USD por 10 GB.
Período de cobrança 2 (1º de abril a 30 de abril):
- Uso relatado: 150 GB de armazenamento usado.
- Preço: 10 USD por 10 GB.
O prestador de serviços decide atribuir uma data retroativa à fatura para cobrir os dois períodos de cobrança: 1º de março a 30 de abril.
| Clássico | Flexível |
|---|---|
As cobranças para todo o período retroativo são calculadas coletivamente como um único item de linha. Total de cobranças:
| Intervalos de tempo retroativos são divididos em vários itens de linha de fatura, de acordo com os limites do período de assinatura. Total de cobranças:
|
Avaliações
Atualizar data de início de avaliações subsequentes
O modo de cobrança flexível usa a data de início da avaliação mais recente para assinaturas com avaliações subsequentes.
Por exemplo, quando você tem:
- Período de teste de 1º de janeiro a 1º de fevereiro
- Período de cobrança normal de 1º de fevereiro a 1º de março
- Período de teste de 1º de março a 1º de abril
| Clássico | Flexível |
|---|---|
O subscription. sempre se refere à primeira avaliação iniciada por uma assinatura. | O subscription. se refere ao início da avaliação mais recente de uma assinatura. |
Preservar a data final da avaliação original quando a assinatura for cancelada
O modo de cobrança flexível preserva a data trial_ se você modificar a data cancel_.
| Clássico | Flexível |
|---|---|
Se a data de trial_ for posterior a cancel_, trial_ será definida como a data de cancelamento. Se cancel_ for atualizado ou removido posteriormente, trial_ não será definido como seu valor original. | Agendar o cancelamento de uma assinatura usando cancel_ não altera mais a data trial_. Isso garante que as avaliações sejam executadas por toda a duração pretendida, independentemente das atualizações da data de cancelamento. |
Padronizar a descrição do item de linha do período de avaliação
O modo de faturamento flexível usa um formato de descrição consistente para itens baseados no uso e licenciados durante os períodos de teste.
Por exemplo, quando você tem uma assinatura mensal de café (licenciada) e uma assinatura alpaca_ (baseada no uso), a descrição da assinatura é exibida da seguinte maneira:
| Clássico | Flexível |
|---|---|
Itens licenciados usam o modelo
| O mesmo formato,
|
Nova fatura para itens de linha de teste
O modo de cobrança flexível só gera itens de linha para alterações feitas durante uma avaliação. Os itens existentes sem alterações não são cobrados novamente.
Por exemplo, quando você faz uma atualização para adicionar outro item de avaliação de price_ a uma assinatura de avaliação com price_:
| Clássico | Flexível |
|---|---|
| As alterações feitas durante uma avaliação resultam em nenhuma fatura ou em uma fatura que restaura todo o estado da assinatura. | As alterações feitas durante uma avaliação resultam consistentemente em itens de linha comparáveis às alterações fora de uma avaliação. Por exemplo, se um novo preço for adicionado a uma assinatura, um item de linha que representa essa adição também será adicionado. |
Itens de fatura pendentes
Incluir itens de fatura pendentes de forma consistente
O modo de cobrança flexível inclui todos os itens pendentes disponíveis em faturas geradas por uma redefinição da âncora do ciclo de cobrança, em que proration_
| Clássico | Flexível |
|---|---|
As faturas de redefinição da âncora do ciclo de cobrança incluem itens pendentes, enquanto as faturas always_ não. | Os itens pendentes da fatura sempre são incluídos em todas as faturas geradas por uma assinatura. |
Intervalos mistos na mesma assinatura Prévia privada
O modo de cobrança flexível permite acessar assinaturas de intervalo misto. Você pode cobrar por vários preços recorrentes com intervalos diferentes em uma única assinatura, usando assinaturas de intervalo misto. Isso permite combinar diferentes estruturas de preços em uma única assinatura.
| Clássico | Flexível |
|---|---|
| Incompatível. Todos os itens em uma assinatura precisam ter preços com o mesmo intervalo e contagem de intervalos. | Crie assinaturas de intervalo misto, nas quais os itens da assinatura podem ter preços recorrentes com intervalos ou contagens de intervalos diferentes. Por exemplo, um preço mensal e um preço anual podem existir na mesma assinatura. |