Assinaturas Stripe podem incluir itens avulsos na primeira fatura
A primeira cobrança de uma assinatura pode levar itens extras, como um produto comprado junto. Um ajuste garante que o cupom do plano não desconte duas vezes.
Quem assina um plano e compra um produto na mesma hora espera pagar tudo de uma vez. A função que cria a assinatura passou a aceitar itens avulsos, que entram na primeira fatura junto com o plano.
Como funciona
O código que usa a biblioteca informa, para cada item, o produto, o valor, a moeda e a quantidade. A biblioteca converte para o formato que o Stripe espera. Item incompleto é ignorado, e sem itens o pedido enviado é o mesmo de antes.
O ajuste do cupom
O teste de ponta a ponta mostrou uma cobrança menor do que a devida. Com itens avulsos, o cupom informado na assinatura era aplicado pelo Stripe à fatura inteira, incluindo o item extra, que já chegava com o próprio desconto.
O cupom passou a ser aplicado ao item do plano, e não à assinatura como um todo. O item avulso fica com o valor que o projeto calculou.
Os testes cobrem a conversão dos itens, os itens inválidos, o caso sem itens e a separação do cupom. A integração foi validada no ambiente de testes do Stripe.
Origem: Core · req-195 · BATCH-199