Compare o modo de faturamento clássico e flexível
Recomendamos o uso de modo de faturamento flexível 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.
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.
| 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 a atualização de uma assinatura gera um pro rata de crédito, esses pro rata usam o valor debitado original em vez dos valores atuais da assinatura. |
Aplicação de desconto proporcional para rateios
Aplicamos descontos proporcionais a cada item da assinatura durante cálculos de pro rata 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_. | 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. |
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:
- Inicialmente, o preço é por 100 chamadas de API (Preço A)
- Uso em 5 de janeiro: 1000 chamadas de API
- Em 15 de janeiro, o preço muda para por 100 chamadas (Preço B)
- 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.
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.
Valor total da fatura = 1.75 USD. |
Cobrar pelo uso não faturado ao remover itens baseados no uso
Dependendo do valor de proration_, 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_, 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_ da fase de entrada:
|
Redefinir a âncora do ciclo de cobrança
O modo de cobrança flexível só redefine sua âncora do ciclo de cobrança em atualizações de assinatura quando você define explicitamente billing_ para um valor diferente de unchanged.
| Clássico | Flexível |
|---|---|
O billing_ é 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 movercancel_at a uma data anterior à próxima vez que a assinatura for renovada | O billing_ nunca é redefinido automaticamente. |
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
O modo de faturamento flexível permite desativar rateios para um primeiro período de cobrança truncado (ao definircancel_ na criação) usando o parâmetropro rata_.
| Clássico | Flexível |
|---|---|
| Os rateios são aplicados ao primeiro período de cobrança. | Os rateios não são aplicados ao primeiro período de cobrança. |
Definir assinaturas retroativamente
Quando a retrodatação é 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_ 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:
| 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:
|
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. sempre se refere à primeira avaliação iniciada por uma assinatura. | O subscription. 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_ se você modificar a data cancel_.
| Clássico | Flexível |
|---|---|
Ambiente cancel_ para uma data anterior atrial_ data altera automaticamentetrial_ para correspondercancel_. No entanto, removercancel_ ou alterá-lo para uma data posterior àtrial_ a data, não altera automaticamentetrial_, mesmo quetrial_ fosse originalmente uma data posterior. | Agendar o cancelamento de uma assinatura usando cancel_ não altera mais a data trial_. 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 `alpaca_ai_tokens`` (baseada no uso), a descrição da assinatura é exibida da seguinte maneira:
| Clássico | Flexível |
|---|---|
Itens licenciados usam o modelo
| O mesmo formato,
|
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_ a uma assinatura de avaliação com price_:
| 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
Incluir itens de fatura pendentes de forma consistente
O modo de cobrança flexível inclui todos os itens pendentes disponíveis em faturas geradas por uma redefinição da âncora do ciclo de cobrança, em que proration_
| Clássico | Flexível |
|---|---|
As faturas de redefinição do ciclo de faturamento incluem itens pendentes apenas quandoo comportamento de rateio não éalways_. | Os itens pendentes da fatura sempre são incluídos em todas as faturas geradas por uma assinatura. |
Intervalos mistos na mesma assinatura
O modo de faturamento flexível permite criar assinaturas de intervalo misto, 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 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. |