No Brasil, o payment preview serve basicamente para uma coisa: montar, no seu
checkout, a tabela de parcelas do cartão com o acréscimo já calculado — quantas
parcelas, e o valor exato de cada uma. PIX e boleto vêm no mesmo payload, mas
o motivo do objeto existir é resolver o parcelamento sem você calcular juro na
mão. Use antes de criar o Payment Intent.Com has_surcharge: true, os totais incluem o repasse da taxa
(surcharge_amount): o comprador cobre a taxa da organização e a organização
recebe líquido exatamente o amount informado.
A preview é efêmera: não cria recurso, não tem id e nada é persistido. O
Payment Intent recalcula tudo no servidor e é a fonte da verdade na cobrança.
installments.max_count e installments.options[], uma opção por
quantidade de parcelas: amount_total, count, interest_amount,
per_installment_amount e surcharge_amount. Vale sempre
amount + surcharge_amount + interest_amount = amount_total.
