Requisição 193 — Ativação de parcelamento no PaymentIntent Stripe

Origem: REQ-072 do conn2flow-site (BATCH-066), que precisa oferecer parcelamento na etapa de pagamento avulso. Lote Vinculado: BATCH-197. Status: approved.

Escopo

Estender stripe_criar_payment_intent() para permitir que um chamador habilite parcelamento de cartão na criação do PaymentIntent. A configuração comercial (limite de parcelas e responsabilidade pelos juros) pertence ao projeto consumidor; esta biblioteca apenas encaminha a opção suportada pela API Stripe.

Contrato

1. Um parâmetro opcional installments pode solicitar a ativação com ['enabled' => true].

2. Quando solicitado, a biblioteca inclui no payload do endpoint /v1/payment_intents o campo payment_method_options.card.installments.enabled como true.

3. Quando omitido ou desabilitado, o payload enviado permanece idêntico ao comportamento anterior.

4. O novo parâmetro aplica-se apenas a stripe_criar_payment_intent(); a criação de assinaturas e outros fluxos não muda.

5. A documentação PT-BR e EN da biblioteca Stripe descreve o parâmetro.

Critérios de aceite

1. Testes unitários capturam o payload com e sem a opção; o caso sem opção não contém payment_method_options e mantém os campos preexistentes.

2. A opção habilitada produz a estrutura aninhada que http_build_query() serializa como payment_method_options[card][installments][enabled]=true.

3. A suíte PHPUnit focada passa e os arquivos PHP alterados passam em php -l.

Fora do escopo

• Persistência de configuração ou interface CRUD de gateways, que pertencem ao conn2flow-site.

• Seleção de plano, número máximo de parcelas, cálculo do preço e definição de quem assume juros.

• Alterações a PaymentIntents de assinatura, SetupIntents ou a outros métodos Stripe.