Proporcione maior flexibilidade para assinaturas

Você pode definir o seu modo preferido de faturamento para organizar suas faturas e assinaturas de acordo com as necessidades da sua empresa. Você pode configurar cada assinatura para usar um dos dois modos de cobrança:

• Flexível Recommended: fornece comportamento de faturamento preciso e previsível e novas funcionalidades. Para acessar essas melhorias, que só estão disponíveis no modo de faturamento flexível, é preciso criar novas assinaturas com o modo de faturamento flexível ou migrar as assinaturas existentes.
• Clássico: usa o comportamento de assinatura existente da Stripe. Essa configuração é mantida para compatibilidade com versões anteriores de integrações mais antigas.

É possível saber mais sobre as diferenças detalhadas entre o modo faturamento clássico e flexível e como escolher o modo de faturamento que melhor funciona para você.

Por que o modo de faturamento flexível

O modo de faturamento flexível fornece faturamento mais preciso para rateios, preços estabelecidos por uso, faturamento flexível e configurações de avaliação. Ele também desbloqueia novos recursos, comointervalos mistos na mesma assinatura. Essas melhorias estão disponíveis apenas no modo de faturamento flexível, e é por isso que recomendamos a criação de novas assinaturas com o modo de faturamento flexível emigrando os já existentes.

Recomendamos que os novos usuários do Faturamento usem o modo de faturamento flexível para assinaturas e faturas, embora não o exijamos.

Para usuários existentes, seu modo de faturamento padrão é preservado como clássico para manter a compatibilidade com versões anteriores com sua integração atual. No entanto, recomendamos migrar para o modo de faturamento flexível para aproveitar os recursos e melhorias de faturamento mais recentes. Saiba mais sobre odiferenças entre o modo faturamento clássico e flexível.

Comece a usar o modo de faturamento flexível

É possível definir ou atualizar o modo de faturamento por meio da API ou do Dashboard ao criar ou migrar assinaturas. Aplicamos um modo de faturamento padrão caso um não seja especificado.

• Se você criar ou atualizar uma assinatura por meio da API, o valor padrão para o modo de faturamento dependerá da seuversão da integração da API.
• Se você criar ou atualizar assinaturas por meio do Dashboard (incluindoLinks de Pagamento eTabelas de preços), o valor padrão depende dofaturamento você configura em Configurações > Billing > Subscriptions e e-mails.

Para usar o modo de cobrança flexível, sua integração precisa estar na versão 2025-06-30.basil ou posterior da API da Stripe. Saiba como atualizar sua versão da API.

Crie uma nova assinatura com modo de cobrança flexível

Dashboard

API

Você pode criar uma assinatura do modo de faturamento flexível ou atualizar uma assinatura do modo de faturamento clássico para ser flexível por meio do Dashboard, independentemente da versão da API da sua integração. Para modificar totalmente essas assinaturas no Stripe API, sua integração deve estar ativada2025-06-30.basil ou posterior. Para ver em qual versão você está, acesse a páginaWorkbench visão geral e veja a seção API versões. A partir daí, clique em Atualizar para atualizar para uma versão mais recente.

Siga as etapas abaixo para criar uma assinatura com modo de faturamento flexível por meio do editor de assinaturas:

1. Acesse a página Assinaturas no Dashboard.
2. Selecione +Criar assinatura.
3. Role para baixo até a seção Configurações avançadas.
4. Defina Modo de cobrança como Flexível.

O valor do modo de faturamento padrão depende das configurações da sua conta. Você pode personalizar as opções de modo de faturamento exibidas e a seleção padrão em Configurações avançadas configurando oconfiguração padrão do modo de faturamento em Configurações > Billing > Subscriptions e e-mails. No editor de assinatura, você pode optar por exibir as opções de modo de faturamento entre as seguintes:

• Clássico: Os modos de faturamento flexível e clássico são exibidos, com o clássico selecionado por padrão. Essa opção é recomendada se sua integração depender do modo de faturamento clássico e você ainda não puder migrar para o faturamento flexível.
• Flexível: Os modos de faturamento flexível e clássico são exibidos, com o flexível selecionado por padrão. Essa opção é recomendada se você estiver migrando ativamente para o modo de faturamento flexível.
• Flexível e ocultar clássico: Apenas o modo de faturamento flexível é exibido no editor de assinaturas. Essa opção é recomendada para novos usuários do Stripe Billing e para usuários existentes que utilizam exclusivamente o modo de faturamento flexível.

Configurações do modo de faturamento do Dashboard

A configuração padrão do modo de cobrança também determina o modo de cobrança para assinaturas criadas por meio de links de pagamento e tabelas de preços gerados pelo Dashboard. Por exemplo, se você definir o modo de cobrança padrão como flexível e, em seguida, criar um link de pagamento no Dashboard, qualquer assinatura gerada a partir desse link de pagamento usará o modo de cobrança flexível.

A configuração padrão do modo de faturamento só se aplica a novas assinaturas criadas no Dashboard. Ele não afeta as assinaturas criadas usando a API ou as assinaturas migradas para o modo 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.

Modo de faturamento e cronogramas de assinatura

Ao criar um cronograma de assinatura a partir de uma assinatura existente, não defina modo_de_faturamento se a assinatura já tiver um. A programação herda automaticamente o modo_de_faturamento da assinatura original. Se você definir modo_de_faturamento ao usar da_assinatura, Stripe retornará um erro. Se você precisar de um modo_de_faturamento, crie uma nova assinatura.

Itemizar os descontos pro rata

Se assinaturas flexíveis for usado, será possível definir o comportamento preferido para descontos pro rata em faturas e itens da fatura:

• Por item Recommended: permite que as faturas e os itens da fatura mostrem rateios com valores brutos e valores de desconto precisos, consistentes com os não rateados.
• Incluído: usa o comportamento de exibição de pro rata existente da Stripe, com valor líquido e valores de desconto monetário zero. Essa configuração é mantida para compatibilidade retroativa com integrações mais antigas.

Saiba mais sobre as diferenças entre por item e incluído.

Para ativar os descontos pro rata por item, é necessário atualizar a versão da API para 2025-06-30.basil ou posterior.

Crie ou migre uma assinatura a fim de definir proration_discounts para por item.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-06-30.basil" \
  -d "items[0][price]"=
"{{PRICE_ID}}" \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "billing_mode[type]"=flexible \
  -d "billing_mode[flexible][proration_discounts]"=itemized \
  -d payment_behavior=default_incomplete \
  -d "payment_settings[save_default_payment_method]"=on_subscription

O exemplo de código acima retorna a seguinte resposta:

{
  "id": "sub_JgRjFjhKbtD2qz",
  "object": "subscription",
  "billing_mode": {
    "flexible": {
      "proration_discounts": "itemized"
    },
    "type": "flexible",
    "updated_at": 1751071020
  },