> ## 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.

# Cobrar agora ou cadastrar o cartão

> Escolha o objeto certo para cobrar agora ou salvar um cartão para uso futuro.

Use um Payment Intent para movimentar dinheiro. Use um Cadastro de cartão
(`setup_intent`) para salvar um cartão e cobrar depois.

| Preciso...                                              | Use                | Resultado                                                                  |
| ------------------------------------------------------- | ------------------ | -------------------------------------------------------------------------- |
| Cobrar uma compra agora                                 | Payment Intent     | Um pagamento com estado financeiro e uma ou mais tentativas de cobrança.   |
| Autorizar um cartão e capturar depois                   | Payment Intent     | Uma autorização em `requires_capture`, seguida de captura ou cancelamento. |
| Gerar um QR Code PIX ou boleto                          | Payment Intent     | Uma instrução em `next_action` e conclusão assíncrona.                     |
| Salvar um cartão para uma assinatura ou cobrança futura | Cadastro de cartão | Um `payment_method` reutilizável associado ao customer.                    |
| Trocar o cartão padrão sem cobrar                       | Cadastro de cartão | Um novo `payment_method` salvo como padrão.                                |

<Info>
  Um Cadastro de cartão não possui `amount`, não cria Charge, não reserva limite
  e não movimenta dinheiro. Depois que ele termina em `succeeded`, use o Payment
  Method salvo em um Payment Intent ou em uma assinatura.
</Info>

## Quando usar Payment Intent

Use um Payment Intent quando a operação tem valor, moeda e resultado
financeiro. Ele acompanha a cobrança até um estado terminal e aponta a tentativa
mais recente em `latest_charge`.

O método determina o próximo passo:

| Método                        | Resultado inicial comum     | Conclusão                                                  |
| ----------------------------- | --------------------------- | ---------------------------------------------------------- |
| Cartão com captura automática | `succeeded` ou `failed`     | Normalmente na própria confirmação.                        |
| Cartão com captura manual     | `requires_capture`          | Quando seu servidor captura ou cancela a autorização.      |
| PIX ou boleto                 | `pending` com `next_action` | Quando a confirmação financeira chega de forma assíncrona. |

Consulte [Payment Intents](/payments/payment-intents) para estados, exemplos e
relações com Charges e Transactions.

## Quando cadastrar o cartão

Use um cadastro de cartão (`setup_intent`) quando o cliente autoriza guardar um
cartão para uso posterior. O fluxo é:

1. criar ou recuperar o customer;
2. iniciar o cadastro;
3. tokenizar o cartão no navegador;
4. concluir o cadastro;
5. guardar o `payment_method` retornado para cobranças futuras.

Uma falha não cria cobrança. O intent volta para `requires_payment_method`,
preenche `last_setup_error` e permite coletar outro cartão.

Consulte [Salvar cartão para cobrar depois](/payments/save-card-for-later) para implementar o
fluxo completo.

## Dois exemplos

### Cobrar agora

Seu cliente concluiu um pedido de R\$ 99. Crie um Payment Intent de `9900`
centavos, defina o método e confirme. Libere o pedido somente quando o intent
estiver em `succeeded`.

### Salvar agora e cobrar depois

Seu cliente iniciou um trial. Conclua o cadastro com o token gerado no
navegador. Quando o trial terminar, a assinatura usa o `payment_method` salvo na
cobrança automática. Em uma cobrança avulsa futura, seu backend cria um Payment
Intent usando esse mesmo cartão.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Payment Intents" icon="credit-card" href="/payments/payment-intents">
    Crie, confirme, acompanhe e cancele uma cobrança.
  </Card>

  <Card title="Cadastro de cartão" icon="shield" href="/payments/save-card-for-later">
    Salve um cartão para cobrar depois.
  </Card>
</CardGroup>