Pular para o conteúdo
Criar conta ou Entrar
O logotipo da documentação da Stripe
/
Pergunte à IA
Criar contaLogin
Comece já
Pagamentos
Receita
Plataformas e marketplaces
Gestão de valores
Recursos para desenvolvedores
APIs e SDKsAjuda
Visão geral
Controle de versão
Changelog
    Visão geral
    Clover
    Basil
    Acacia
    Versões anteriores
Atualize sua versão da API
Faça upgrade da sua versão do SDK
Essentials
SDKs
API
Testes
Stripe CLI
Projetos de exemplo
Ferramentas
Stripe Dashboard
Workbench
Dashboard de desenvolvedores
Stripe para Visual Studio Code
Terraform
Recursos
Fluxos de trabalho
Destinos de evento
Alertas de integridade da StripeCarregamento de arquivos
Soluções de IA
Kit de ferramentas para agentes
Protocolo de contexto do modeloCrie fluxos de cobrança SaaS com IA agentiva
Segurança e privacidade
Segurança
Rastreador da Web Stripebot
Amplie a Stripe
Desenvolva aplicativos da Stripe
Usar os aplicativos da Stripe
Parceiros
Ecossistema de parceiros
Certificação de parceiro
Estados Unidos
Português (Brasil)
Página inicialRecursos para desenvolvedoresChangelogBasil2025-08-27.basil

Adds support for invoice items metadata and period in subscriptions and schedules

Novidades

We introduced a new way to customize the metadata and period fields for one-off invoice items generated by subscriptions and subscription schedules:.

  • You can directly attach metadata when configuring add_invoice_items, eliminating the need to add this information later in subsequent and separate API calls.

  • You can specify custom period.start and period.end dates that override the default subscription billing cycle dates. This gives you precise control over revenue recognition periods for one-off charges. We’ve also included timestamp indicators (such as max_item_period_start and min_item_period_end for subscriptions, phase_start and phase_end for schedules). This helps you align dates to important timestamps such as subscription billing periods or subscription schedule phase dates.

Impacto:

Specify the metadata or the period field for add_invoice_items using the following API endpoints:

  • Create or Update subscriptions.
  • Create or Update schedules.
  • Create a preview invoice by specifying the schedule_details.

Alterações

ParâmetrosAlterarRecursos ou endpoints
metadataperiodAdicionado
Invoice#create_preview.schedule_details.phases[].add_invoice_items[]Subscription#create.add_invoice_items[]Subscription#update.add_invoice_items[]
 + 3 mais
SubscriptionSchedule.phases[].add_invoice_items[]SubscriptionSchedule#create.phases[].add_invoice_items[]SubscriptionSchedule#update.phases[].add_invoice_items[]

Upgrade

  1. View your current API version in Workbench.
  2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
    • If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-08-27.basil
  3. Upgrade the API version used for webhook endpoints.
  4. Test your integration against the new version.
  5. If you use Connect, test your Connect integration.
  6. In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Related changes

  • Adds a name field to the customer portal configuration object
  • Adds support for third-party tax on flexible billing mode subscriptions
Esta página foi útil?
SimNão
  • Precisa de ajuda? Fale com o suporte.
  • Confira nosso changelog.
  • Dúvidas? Fale com a equipe de vendas.
  • LLM? Read llms.txt.
  • Powered by Markdoc