Definir a data do ciclo de cobrança de assinaturas
O ciclo de faturamento de uma assinatura depende de dois fatores:
- O intervalo recorrente do preço ou preços, como mensal, anual, semanal e assim por diante.
- A âncora do ciclo de faturamento é o ponto de referência que alinha datas futuras do ciclo de faturamento. Ela define o dia da semana para intervalos de
week
, o dia do mês para intervalos demonth
eyear
, e o mês do ano para intervalos deyear
. O valor padrão é a data de criação da assinatura ou a data final da avaliação (se você estiver usando um período de avaliação). Você também pode definir explicitamente esse valor no momento da criação da assinatura.
Observação
As âncoras do ciclo de faturamento são carimbos de data e hora do UNIX da época atual.
Exemplos
- Uma assinatura mensal com uma data âncora do ciclo de faturamento de 2 de setembro sempre é faturada no segundo dia do mês.
- Uma assinatura mensal com uma data âncora de ciclo de faturamento de 31 de janeiro fatura o último dia do mês mais próximo da data âncora, ou seja, 28 de fevereiro (ou 29 de fevereiro em um ano bissexto), depois 31 de março, 30 de abril e assim por diante.
- Uma assinatura semanal com uma data âncora do ciclo de faturamento de sexta-feira, 3 de junho fatura todas as sextas-feiras a partir de então.
Os períodos de faturamento completos começam na primeira data da fatura completa, que normalmente é a data da âncora do ciclo de faturamento e sempre está alinhada por intervalos.
Especificar a âncora do ciclo de faturamento para novas assinaturas
Existem duas formas de definir a âncora do ciclo de faturamento em novas assinaturas:
- Use
billing_cycle_anchor_config
para calcular o carimbo de data e hora para você (somente assinaturas mensais ou anuais). - Use
billing_cycle_anchor
para aceitar diretamente o carimbo de data e hora.
Se estiver criando uma assinatura mensal ou anual, recomendamos usar o parâmetro billing_cycle_anchor_config
, pois ele considera automaticamente os meses curtos e anos bissextos. Se estiver criando uma assinatura diária ou semanal, ou se preferir definir a data do ciclo da sua assinatura usando um carimbo de data e hora, use o parâmetro billing_cycle_anchor
diretamente.
Use billing_cycle_anchor_config
Para criar uma integração com assinaturas mensais ou anuais, use billing_cycle_anchor_config
em criar assinatura para especificar o dia do mês no qual a âncora será feita.
Defina day_of_month
como 31
para criar uma assinatura mensal com ciclo no final do mês, mesmo em meses com menos de 31 dias. Se um mês tiver menos de 31 dias, a assinatura reinicia o ciclo no último dia desse mês.
Você também pode especificar month
para controlar o mês do ano para a âncora em assinaturas de vários meses ou anuais.
Para definir suas assinaturas anuais no dia 1º de julho, crie uma assinatura anual com um month
de 7
e day_of_month
de 1
.
Para alinhar precisamente os períodos de faturamento com outra assinatura, forneça o mesmoday_of_month
que o original e os mesmos hour
, minute
e second
. Se você omitir os parâmetros hour
, minute
e second
, os valores derivarão do horário da criação da assinatura.
Por exemplo, se você tiver uma assinatura mensal existente com um carimbo de data e hora billing_cycle_anchor
que contém o dia do mês, a hora, o minuto e o segundo de 15, 12, 30 e 0, poderá alinhar uma nova assinatura mensal a ele. Para fazer isso, defina day_of_month
, hour
, minute
e second
para corresponder aos mesmos valores, respectivamente.
Se você usar billing_cycle_anchor_config
, poderá resultar em um billing_cycle_anchor
com mais de um período de faturamento no futuro. No entanto, a data da primeira fatura completa sempre ocorre em um período de faturamento desde a criação da assinatura ou do término de uma avaliação gratuita.
Por exemplo, suponhamos que você cria uma assinatura de intervalo de dois meses em fevereiro e a realiza no final de cada mês, definindo day_of_month
como 31
. O próximo mês, que tem 31 dias em intervalos de dois meses a partir de fevereiro, é agosto. Isso resulta em uma âncora de ciclo de faturamento em 31 de agosto. No entanto, a primeira data de fatura completa dessa assinatura ainda ocorre em fevereiro. Há um período inicial proporcional da criação da assinatura até 28 de fevereiro (ou 29 durante um ano bissexto), seguido por um período de faturamento completo de dois meses.
Use billing_cycle_anchor
Você pode criar uma assinatura com uma âncora de ciclo de faturamento explícita usando a API Subscriptions ou o Checkout.
Alterar o ciclo de faturamento em assinaturas pré-existentes
Você pode alterar a cobrança de uma assinatura existente de duas formas.
- Redefina a âncora do ciclo de faturamento para a hora atual.
- Adicione uma avaliação para definir automaticamente a data âncora para o final da avaliação. As avaliações normalmente começam quando você cria uma assinatura, mas também é possível aplicá-las a assinaturas existentes, permitindo creditar o cliente pelos dias restantes no ciclo anterior que ele já pagou.
Você pode executar qualquer uma dessas opções na API Subscriptions ou no Dashboard.
Redefinir o ciclo de faturamento para o tempo atual
Quando você redefine o ciclo de faturamento, a Stripe envia imediatamente uma fatura. Habilite a cobrança proporcional para creditar o cliente para qualquer dia já pago no período anterior. Desativar a cobrança proporcional pode resultar em cobranças excessivas do cliente.
Adicionar uma avaliação para alterar o ciclo de faturamento
Adicionar um período de avaliação não proporcional a uma assinatura existente permite configurar o ciclo de faturamento para qualquer data.
Normalmente, se estiver usando o período de avaliação para alterar o ciclo de faturamento sem emitir uma fatura proporcional, você desativa a cobrança proporcional porque a duração do período de avaliação considera a parte já paga do ciclo de faturamento anterior.
Por exemplo, se um cliente tiver uma assinatura ativa definida para faturar em 23 de julho e você introduzir um período de avaliação até 1º de agosto:
- O cliente recebe uma fatura de US$ 0 em 15 de julho.
- O cliente não é cobrado em 23 de julho.
- O cliente é cobrado em 1º de agosto, depois em 1º de setembro e assim por diante.
- O cliente já pagou até 23 de julho no ciclo anterior, então esse período “gratuito” não é realmente gratuito.
- O período entre 23 e 31 de julho não é cobrado.
- O novo ciclo faturado em 1º de agosto é um ciclo completo à taxa normal.
Faturamento por consumo
Com o faturamento por consumo, o preço pago pelo cliente varia em função do consumo durante o ciclo de faturamento. Quando a alteração do ciclo de faturamento antecipa o término de um intervalo de assinatura, você cobra o cliente pelo uso acumulado durante o ciclo reduzido.
Limites
Além do ciclo regular, é possível configurar assinaturas para cobrar sempre que o valor devido atingir um limite.
Se você tiver uma assinatura faturada desse modo, configure-a para redefinir o ciclo de assinatura quando atingir o limite.
Consulte os limites de cobrança para obter mais detalhes.