# Compare o modo de faturamento clássico e flexível Conheça as diferenças entre os vários modos de faturamento Recomendamos o uso de [modo de faturamento flexível](https://docs.stripe.com/billing/subscriptions/billing-mode.md) porque proporciona um melhor comportamento de faturamento e acesso a novos recursos. No entanto, mudar para o modo de faturamento flexível pode alterar o comportamento da sua integração. Analise as diferenças a seguir para entender o impacto na sua integração e tomar uma decisão informada. > Não é possível migrar uma assinatura do modo de faturamento flexível para o modo de faturamento clássico. ## 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](https://docs.stripe.com/billing/subscriptions/prorations.md#credit-prorations). | **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 uma atualização de uma assinatura gera uma pro rata de crédito, essas pro rata usam o valor original debitado em vez dos valores atuais da assinatura. Se o período a ser creditado foi originalmente faturado em vários débitos, a Stripe gera várias pro rata de crédito: uma para cada débito original correspondente. | ### Aplicação de desconto proporcional para rateios Aplicamos descontos proporcionais a cada item da assinatura durante [cálculos de pro rata](https://docs.stripe.com/billing/subscriptions/prorations.md#prorations-and-discounts) 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_behavior=always_invoice`. | 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. | No entanto, isso não se aplica a faturas geradas durante o ciclo de renovação. A fatura contém todos os itens baseados no uso, incluindo os itens de linha 0 USD. ### 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: 1. Inicialmente, o preço é por 100 chamadas de API (Preço A) 1. Uso em 5 de janeiro: 1000 chamadas de API 1. Em 15 de janeiro, o preço muda para por 100 chamadas (Preço B) 1. 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. - 500 chamadas da API no preço B (0.15 USD por 100 chamadas) = 0.75 USD 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. - 1000 chamadas da API no preço A (0.1 USD por 100 chamadas) = 1 USD - 500 chamadas da API no preço B (0.15 USD por 100 chamadas) = 0.75 USD Valor total da fatura = 1.75 USD. | ### Cobrar pelo uso não faturado ao remover itens baseados no uso Dependendo do valor de `proration_behavior`, o modo de faturamento flexível pode gerar um item da fatura para uso não faturado ao remover um item de assinatura estabelecida por uso. Isso se aplica a remoções usando a API ou durante transições de fase de programação que ocorrem no meio do período. Para transições de fase que coincidem com qualquer item de assinatura `current_period_end`, uma fatura é criada com um item de linha da fatura de uso estabelecido por assinatura. | **Cenário** | **Clássico** | **Flexível** | | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Atualizar assinatura ou cronograma usando a API | Nenhuma fatura ou item da fatura é gerado para uso não faturado ao remover um item assinatura baseada em uso. | Um item de fatura é gerado para uso não faturado ao remover um item de assinatura baseado em uso. | | Agendar transição de fase | Uma fatura (mas nenhum item de fatura) é gerado para uso não faturado ao remover um item de assinatura baseado em uso. | Dependendo do `proration_behavior` da fase de entrada: - `create_prorations`: um item da fatura é criado para uso não faturado ao remover um item de assinatura baseado em uso. - `always_invoice`: um item da fatura para uso não faturado é criado e faturado imediatamente. - `none`: nenhum item da fatura foi criado. | ### Redefinir a âncora do ciclo de cobrança O modo de cobrança flexível só redefine sua [âncora do ciclo de cobrança](https://docs.stripe.com/billing/subscriptions/billing-cycle.md) em atualizações de assinatura quando você define explicitamente `billing_cycle_anchor` para um valor diferente de `unchanged`. | Clássico | Flexível | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | | O `billing_cycle_anchor` é automaticamente redefinido para a data atual ao mudar uma assinatura para um preço diferente com um intervalo recorrente diferente, mudar de preços de valor zero para preços diferentes de zero ou mover[cancel_at](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-cancel_at) a uma data anterior à próxima vez que a assinatura for renovada | O `billing_cycle_anchor` 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 é renovada. 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 ### Cancelamentos no portal do cliente Quando um cliente agenda um cancelamento pelo [portal do cliente](https://docs.stripe.com/customer-management/cancellation-page.md), o modo de faturamento flexível usa `cancel_at` diretamente em vez de `cancel_at_period_end`. Para mais informações sobre as diferenças entre `cancel_at` e `cancel_at_period_end`, consulte [o changelog](https://docs.stripe.com/changelog/basil/2025-07-30/cancel-at-enums.md). | **Clássico** | **Flexível** | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `cancel_at_period_end` é definido como `true`, e `cancel_at` é definido com o timestamp de `current_period_end`. Como `cancel_at_period_end` está como `true`, `cancel_at` é atualizado sempre que `current_period_end` muda. | `cancel_at_period_end` é definido como `false`, e `cancel_at` é definido como o maior `current_period_end` entre todos os itens da assinatura. Quando o `current_period_end` de um item muda, a data de cancelamento (`cancel_at`) não é atualizada. | ### Exclusão de pro rata no primeiro período de cobrança truncado O modo de faturamento flexível permite desativar pro rata no primeiro período de cobrança truncado (ao definir `cancel_at` na criação) usando o parâmetro `proration_behavior` definido como `none`. | **Clássico** | **Flexível** | | --------------------------------------------------------- | ------------------------------------------------------------- | | Os rateios são aplicados ao primeiro período de cobrança. | Os rateios não são aplicados ao primeiro período de cobrança. | ## Definir assinaturas retroativamente Quando a [retrodatação](https://docs.stripe.com/billing/subscriptions/backdating.md) é 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_start_date` 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 ser retroativa devido a uma fatura não emitida nos últimos dois períodos de cobrança. O cliente recebeu faturas referentes a 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: - 250 GB = 25 x 10 USD = 250 USD - Esse valor aparece como um único item de linha na fatura. | Os intervalos de tempo retroativos são divididos em vários itens de linha da fatura, de acordo com os limites do período de cobrança. Cobranças totais: - Período de cobrança 1 (março): - 100 GB = 10 x 10 USD = 100 USD (como um item de linha separado). - Período de cobrança 2 (abril): - 150 GB = 15 x 10 USD = 150 USD (como um item de linha separado). | ## 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.trial_start` sempre se refere à primeira avaliação iniciada por uma assinatura. | O `subscription.trial_start` 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_end` se você modificar a data `cancel_at`. | Clássico | Flexível | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Ambiente `cancel_at` para uma data anterior a`trial_end` data altera automaticamente`trial_end` para corresponder`cancel_at`. No entanto, remover`cancel_at` ou alterá-lo para uma data posterior à`trial_end` a data, não altera automaticamente`trial_end`, mesmo que`trial_end` fosse originalmente uma data posterior. | Agendar o cancelamento de uma assinatura usando `cancel_at` não altera mais a data `trial_end`. 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 de `hypernian_tokens` (com base no uso), a descrição da assinatura é exibida da seguinte forma: | **Clássico** | **Flexível** | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Itens licenciados usam o modelo `Trial period for {product name}`, enquanto itens baseados no uso usam `{quantity} x {product name} (Free trial)`. - Para itens licenciados: - `Trial period for monthly coffee subscription` - Para itens com base no uso: - `10 x monthly hypernian_tokens (Free trial)` | O mesmo formato, `Free trial for {quantity} x {product name}`, se aplica a todos os tipos de itens, o que proporciona uma apresentação mais uniforme das informações da avaliação. Essas descrições também estão localizadas. - Para itens licenciados: - `Free trial for 1 x monthly coffee subscription` - Para itens com base no uso: - `Free trial for 10 x monthly hypernian_tokens subscription` | ### 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_b` a uma assinatura de avaliação com `price_a`: | 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 durante um período de avaliação resultam consistentemente em itens comparáveis às alterações fora do período de avaliação. Por exemplo, se um novo preço for adicionado a uma assinatura, um item representando esse preç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_behavior = always_invoice` | **Clássico** | **Flexível** | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- | | As faturas de redefinição do ciclo de faturamento incluem itens pendentes apenas quando `proration behavior` não é `always_invoice`. | Os itens pendentes da fatura sempre são incluídos em todas as faturas geradas por uma assinatura. | ## Intervalos mistos na mesma assinatura O modo de faturamento flexível permite criar[ assinaturas de intervalo misto](https://docs.stripe.com/billing/subscriptions/mixed-interval.md), que pode faturar para vários preços recorrentes com intervalos diferentes. 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. | Itens em um [intervalo misto de assinatura](https://docs.stripe.com/billing/subscriptions/mixed-interval.md) pode ter preços recorrentes com diferentes intervalos ou contagens de intervalos. Por exemplo, um preço mensal e um preço anual podem existir na mesma assinatura. |