Os itens de assinatura podem ter ciclos em diferentes intervalos usando os parâmetros current_period_start e current_period_end. Por exemplo, um item pode ter um ciclo mensal e outro anual. Dependendo de como você estiver ouvindo os eventos de webhook customer.subscription.updated, pode ser necessário atualizar sua integração para determinar se um evento foi para um ciclo de assinatura.

Determinar o ciclo de uma assinatura

Quando termina um ciclo de assinatura e um novo período de cobrança se inicia, a Stripe gera um evento customer.subscription.updated. No entanto, nem todos os eventos de atualização de assinatura indicam um ciclo. Para determinar de forma confiável se um ciclo terminou, examine as mudanças específicas na data do evento.

O ciclo de uma assinatura termina quando todas as condições a seguir são verdadeiras no evento customer.subscription.updated:

• O parâmetro previous_attributes do evento contém uma alteração no campo latest_invoice.
• Quando a matriz items está presente em previous_attributes, para cada item:
  • O current_period_end do item no parâmetro previous_attributes corresponde ao novo current_period_start.
  • O novo current_period_start é posterior ao current_period_start em previous_attributes.

Armadilhas comuns para evitar

• Não presuma que todos os itens tenham o mesmo ciclo.
• Não verifique somente o primeiro item da assinatura.
• Não deixe de verificar o campo latest_invoice.
• Não verifique apenas se os itens existem em previous_attributes.