> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral

> O objeto Payment Preview

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.

<Tip>
  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.
</Tip>

<ResponseField name="object" type="string">
  Sempre `payment_preview`.
</ResponseField>

<ResponseField name="amount" type="integer">
  Valor informado, em centavos. Com `has_surcharge: true`, é o que a
  organização recebe líquido.
</ResponseField>

<ResponseField name="currency" type="string">
  Sempre `brl`.
</ResponseField>

<ResponseField name="has_surcharge" type="boolean">
  Ecoa o valor enviado. Quando `false`, todo `surcharge_amount` é `0`.
</ResponseField>

<ResponseField name="livemode" type="boolean">
  Ambiente da API key usada na chamada.
</ResponseField>

<ResponseField name="payment_methods" type="object">
  Um bloco por método solicitado.

  <Expandable title="propriedades">
    <ResponseField name="boleto" type="object">
      `amount_total` (o que o comprador paga) e `surcharge_amount`.
    </ResponseField>

    <ResponseField name="credit_card" type="object">
      `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`.
    </ResponseField>

    <ResponseField name="pix" type="object">
      `amount_total` (o que o comprador paga) e `surcharge_amount`.
    </ResponseField>
  </Expandable>
</ResponseField>