# 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.

Use esta página para entender o que muda quando você migra uma assinatura do modo de faturamento clássico para o flexível. Cada seção descreve uma diferença específica de comportamento para que você possa avaliar o impacto na sua integração antes de realizar a migração.

## 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)
2. Uso em 5 de janeiro: 1000 chamadas de API
3. Em 15 de janeiro, o preço muda para  por 100 chamadas (Preço B)
4. 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

No modo de faturamento flexível, as atualizações de assinaturas preservam o [marco do ciclo de faturamento](https://docs.stripe.com/billing/subscriptions/billing-cycle.md), exceto quando você:

- Define explicitamente `billing_cycle_anchor` com um valor diferente de `unchanged`.
- Atualiza `trial_end`. Isso define o marco para o término do novo período de avaliação, mesmo que o marco anterior estivesse definido para uma data posterior.

| 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 | As alterações listadas na coluna Classic não redefinem o marco do ciclo de faturamento.

Quando um cliente muda de um plano gratuito para um plano pago, a Stripe cria itens da fatura pendentes e os inclui na fatura do próximo ciclo de faturamento. A Stripe não gera uma fatura nem tenta realizar uma cobrança imediatamente, dando a você tempo para coletar uma forma de pagamento, se necessário.

Para gerar uma fatura imediatamente em um upgrade de plano gratuito para pago, passe `proration_behavior=always_invoice` ou redefina explicitamente a âncora do ciclo de faturamento definindo `billing_cycle_anchor=now`. |

### Cancele pro rata equivalentes em redefinições da âncora do ciclo de faturamento

Quando você redefine a âncora do ciclo de faturamento sem alterar os itens da assinatura, a Stripe cancela créditos e débitos equivalentes, gerando apenas o débito líquido restante como um item da fatura pro rata.

Por exemplo, considere uma assinatura mensal criada em 1º de setembro cuja âncora do ciclo de faturamento é redefinida em 15 de setembro (sem alterações nos itens):

| `proration_behavior` | **Clássico** | **Flexível** |
| --- | --- | --- |
| `create_prorations` | - A Stripe gera um débito referente ao período completo de 15 de setembro a 15 de outubro como um item de linha da fatura
- A Stripe gera um crédito referente ao período de 15 de setembro a 1º de outubro
- A Stripe cria uma fatura imediatamente | - A Stripe cancela o crédito e o débito referentes ao período de 15 de setembro a 1º de outubro
- A Stripe gera um débito referente ao período de 1º de outubro a 15 de outubro como um item da fatura com `proration=true`
- A Stripe não cria uma fatura imediatamente |
| `always_invoice` | - A Stripe gera um débito referente ao período completo de 15 de setembro a 15 de outubro como um item de linha da fatura
- A Stripe gera um crédito referente ao período de 15 de setembro a 1º de outubro
- A Stripe cria uma fatura imediatamente | - A Stripe cancela o crédito e o débito referentes ao período de 15 de setembro a 1º de outubro
- A Stripe gera um débito referente ao período de 1º de outubro a 15 de outubro como um item da fatura com `proration=true`
- A Stripe cria uma fatura imediatamente |
| `nenhum` | - A Stripe gera um débito referente ao período completo de 15 de setembro a 15 de outubro como um item de linha da fatura
- A Stripe filtra o crédito referente ao período de 15 de setembro a 1º de outubro
- A Stripe cria uma fatura imediatamente | - A Stripe não gera nenhum item da fatura nem fatura |

Se você também alterar os itens da assinatura junto com a redefinição do BCA, de modo que os rateios não sejam totalmente cancelados, o modo flexível gerará um item de linha da fatura de período integral e criará uma fatura imediatamente, independentemente de `proration_behavior`.

### 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

Se você definir cancel_at ao criar uma assinatura e isso encurtar o primeiro período de cobrança, o efeito de [desabilitar a pro rata](https://docs.stripe.com/billing/subscriptions/prorations.md#disable-prorations) dependerá do modo de faturamento da assinatura.

| **Clássico** | **Flexível** |
| --- | --- |
| A Stripe não trata o período de cobrança encurtado como pro rata. Como resultado, definir `proration_behavior=none` não impede a Stripe de emitir uma fatura para esse período. A Stripe adiciona um item de linha da fatura correspondente ao valor total da assinatura, não ao valor pro rata. | O período encurtado é tratado como pro rata. `proration_behavior=none` suprime o item de linha inteiramente, de modo que nenhuma fatura é criada e `latest_invoice` fica como `null`. |

Para atualizações de assinatura, a Stripe aplica esse comportamento apenas quando a atualização cria uma fatura. Por exemplo, quando você redefine explicitamente o `billing_cycle_anchor` ou quando um [período de avaliação gratuita](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md) termina.

## 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). |

### Comportamento de pro rata subsequente após data retroativa sem uma cobrança inicial

Quando você cria uma assinatura com data retroativa usando `proration_behavior: 'none'` para suprimir o faturamento dos períodos retroativos (por exemplo, ao [migrar para a Stripe](https://docs.stripe.com/billing/subscriptions/backdating.md#backdating-no-charge)), o modo de faturamento flexível e o modo de faturamento clássico lidam com as atualizações e os cancelamentos subsequentes de maneira diferente.

| **Clássico** | **Flexível** |
| --- | --- |
| Quando você atualiza ou cancela a assinatura posteriormente, a Stripe gera um crédito pro rata para o tempo não utilizado restante no período com data retroativa, mesmo que nenhuma fatura tenha sido criada para esses períodos de faturamento. | Como o modo de faturamento flexível calcula créditos pro rata estabelecidos em valores debitados anteriormente, a ausência de débito para os períodos com data retroativa significa que nenhum crédito pro rata é gerado para esse tempo no caso de atualizações ou cancelamentos subsequentes. |

## 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

### Fature cobranças avulsas adicionadas durante uma atualização

Quando você usa add_invoice_items para adicionar apenas cobranças avulsas durante uma atualização de assinatura no meio do período ou uma transição de fase do cronograma de assinatura, o comportamento de proration_behavior=always_invoice depende do modo de faturamento. Essa diferença se aplica apenas se nenhuma alteração de item de assinatura, preço ou quantidade fizer a Stripe criar uma fatura.

| **Clássico** | **Flexível** |
| --- | --- |
| A Stripe cria uma fatura de atualização que inclui os itens de fatura adicionados. | A Stripe cria itens de fatura pendentes. Configurar apenas `proration_behavior=always_invoice` não cria uma fatura de atualização imediata. Os itens pendentes podem aparecer em uma fatura qualificada posterior, incluindo a fatura de renovação da assinatura. |

Essa diferença não se aplica quando outra parte da atualização faz a Stripe criar uma fatura, quando você cria uma assinatura ou quando ocorre uma transição de fase do cronograma na renovação.

Para faturar os itens adicionados para uma assinatura com modo de faturamento flexível, aguarde a próxima fatura da assinatura. Para faturá-los antes, [crie uma fatura](https://docs.stripe.com/api/invoices/create.md) após a atualização ou transição de fase e defina `subscription` com o ID da assinatura. A fatura inclui todos os itens de fatura pendentes para essa assinatura, não apenas aqueles adicionados durante a atualização ou transição de fase.

### Incluir itens de fatura pendentes de forma consistente

O modo de faturamento flexível inclui todos os itens da fatura que estão pendentes e disponíveis em faturas geradas por uma atualização em que `proration_behavior=always_invoice` e `payment_behavior` não está definido como `pending_if_incomplete`.

| **Clássico** | **Flexível** |
| --- | --- |
| A redefinição da âncora do ciclo de faturamento incluem itens pendentes elegíveis Todas as outras faturas de atualização geradas com `proration_behavior=always_invoice` excluem itens pendentes preexistentes quando a própria atualização produz itens da fatura, como pro rata. | O modo de faturamento flexível inclui itens da fatura pendentes qualificados quando a atualização de uma assinatura gera uma fatura, incluindo atualizações com `proration_behavior=always_invoice` e redefinições da âncora do ciclo de faturamento.

As atualizações que usam `payment_behavior=pending_if_incomplete` são uma exceção porque suas faturas excluem itens da fatura pendentes preexistentes. Esses itens permanecem pendentes para faturamento posterior. |

## 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. |

## Limites de itens de assinatura

O modo de faturamento flexível comporta mais itens de assinatura do que o modo de faturamento clássico.

| **Clássico** | **Flexível** |
| --- | --- |
| Comporta até 20&nbsp;itens de assinatura. | Comporta até 100&nbsp;itens de assinatura. |
