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, count, installment_interest_amount,
per_installment_amount e surcharge_amount. Vale sempre
payment_preview.amount + option.surcharge_amount + option.installment_interest_amount = option.amount.
