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

# Encontre seu caso de uso

> Escolha a integração de pagamentos que combina com o que você vende, como o comprador paga e quanto da experiência sua equipe quer controlar.

Você não precisa começar pela API. Comece pelo resultado financeiro que quer
criar: vender uma oferta, concluir um pedido, cobrar um cliente específico ou
manter uma relação recorrente. Depois escolha quanto da experiência de pagamento
sua equipe quer controlar.

<Tip>
  **Regra rápida:** a mesma oferta usa **Link de pagamento**; cada pedido usa
  uma **Checkout Session**; uma cobrança pontual vinculada a um cliente usa uma
  **fatura avulsa**; uma relação recorrente usa uma **assinatura**. Use um
  **Payment Intent** diretamente apenas quando sua aplicação já controlar o
  checkout e precisar coordenar a cobrança.
</Tip>

## Comece pelo que você quer cobrar

| Seu cenário                                                                     | Melhor ponto de partida                                           | O que esse caminho resolve                                                                        |
| ------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| Quero compartilhar a mesma oferta por mensagem, e-mail, QR Code ou rede social. | [Link de pagamento](/payments/create-payment-link)                | Publica uma URL reutilizável sem criar um pedido no backend a cada acesso.                        |
| Meu site já tem carrinho ou pedido e cada compra nasce com dados próprios.      | [Checkout hospedado](/payments/create-hosted-checkout-page)       | Separa itens, comprador, desconto, prazo e resultado em uma Checkout Session própria.             |
| Preciso criar uma cobrança pontual para um cliente específico.                  | [Fatura avulsa](/payments/invoices#criar-uma-fatura-avulsa)       | Registra itens e saldo em aberto, entrega uma URL de pagamento e acompanha a cobrança até o fim.  |
| Quero cobrar automaticamente por mês, trimestre, ano ou outra cadência.         | [Assinatura](/payments/subscriptions)                             | Gera e cobra cada fatura do ciclo, mantém o estado da relação e recupera renovações que falharem. |
| Quero salvar um cartão agora para cobrar ou renovar depois.                     | [Cadastro de cartão](/payments/save-card-for-later)               | Cria uma credencial reutilizável sem o número completo do cartão passar pelo seu servidor.        |
| Já tenho o valor final e preciso cobrar sem modelar um carrinho.                | [Payment Intents](/payments/accept-payments-with-payment-intents) | Acompanha somente a tentativa financeira e deixa itens, interface e regras sob seu controle.      |

## Use a Chargefy como motor de cobrança

Checkout resolve a experiência de compra. Faturas e assinaturas resolvem o que
acontece quando existe um valor devido por um cliente — uma vez ou ao longo do
tempo.

<CardGroup cols={3}>
  <Card title="Criar uma fatura avulsa" icon="file-invoice" href="/payments/invoices#criar-uma-fatura-avulsa">
    Crie uma cobrança pontual para um cliente, compartilhe a página hospedada e
    acompanhe pagamento, nova tentativa, cancelamento ou baixa.
  </Card>

  <Card title="Criar uma assinatura" icon="arrows-rotate" href="/payments/subscriptions">
    Defina cliente, itens e cadência uma vez. A Chargefy gera a fatura, cobra e
    avança cada ciclo automaticamente.
  </Card>

  <Card title="Recuperar cobranças recorrentes" icon="rotate-right" href="/payments/revenue-recovery">
    Use retentativas automáticas, avisos ao assinante, atualização de cartão e
    uma ação final configurável quando uma renovação falhar.
  </Card>
</CardGroup>

## Escolha quanto da interface quer controlar

<CardGroup cols={2}>
  <Card title="Compartilhar uma oferta sem código" icon="link" href="/payments/create-payment-link">
    Monte a oferta no Dashboard, publique a URL e compartilhe. Cada abertura
    gera uma tentativa de compra independente.
  </Card>

  <Card title="Usar uma página pronta" icon="cart-shopping" href="/payments/create-hosted-checkout-page">
    Seu backend cria o pedido e redireciona o comprador para um checkout que a
    Chargefy mantém e sua organização configura.
  </Card>

  <Card title="Criar a experiência no seu produto" icon="code" href="/payments/build-white-label-checkout">
    Sua interface coleta os dados com segurança e apresenta os estados de
    pagamento; seu backend mantém a regra do pedido.
  </Card>

  <Card title="Controlar diretamente a cobrança" icon="sliders" href="/payments/payment-intents">
    Use quando sua aplicação já resolveu itens, preço e comprador e precisa
    acompanhar apenas o movimento financeiro.
  </Card>
</CardGroup>

## Decida pela responsabilidade de cada parte

| Decisão                                   | A Chargefy coordena                                              | Sua aplicação coordena                                      |
| ----------------------------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------- |
| **Link de pagamento**                     | Oferta publicada, checkout e uma sessão para cada acesso.        | Onde divulgar o link e o que fazer depois do pagamento.     |
| **Checkout Session com página hospedada** | Página, métodos, coleta de dados e ciclo daquela compra.         | Itens do pedido, criação da sessão e entrega.               |
| **Checkout white-label**                  | Tokenização, credenciais e ciclo financeiro.                     | Todas as telas, mensagens, retomadas e validações de UI.    |
| **Fatura avulsa**                         | Documento, página de pagamento, saldo e tentativas de cobrança.  | Cliente, itens, vencimento e ações sobre o saldo em aberto. |
| **Assinatura**                            | Renovações, faturas, trials, pró-rata e recuperação de cobrança. | Regras comerciais, acesso ao produto e reação aos webhooks. |
| **Payment Intent direto**                 | Ciclo financeiro e próxima ação do método.                       | Itens, preço final, interface, tentativas e experiência.    |

<Warning>
  O retorno do comprador para o seu site não é confirmação financeira. Em todos
  os caminhos, conclua o pedido no backend a partir do webhook e trate a mesma
  entrega mais de uma vez sem duplicar o efeito.
</Warning>

## Chargefy for Platforms

<Warning>
  Esta seção só se aplica a contas com o produto **Chargefy for Platforms**
  habilitado. Nesse produto, uma plataforma opera pagamentos para **suas
  organizações filhas**.
</Warning>

Use esse modelo quando seu marketplace, software vertical, franquia ou produto
precisa manter vendedores, clientes empresariais ou unidades como operações
financeiras separadas. Cada organização filha é dona de seus clientes,
produtos, Links de pagamento, Checkout Sessions, pagamentos, faturas,
assinaturas e histórico financeiro.

| O que a plataforma faz                       | Resultado para a organização filha                                             |
| -------------------------------------------- | ------------------------------------------------------------------------------ |
| Cria e ativa a organização filha             | O participante recebe cadastro e operação financeira próprios.                 |
| Seleciona a organização ao chamar a API      | Clientes, catálogo, checkouts e cobranças nascem no contexto correto.          |
| Cria Links de pagamento ou Checkout Sessions | Cada organização filha vende com sua própria oferta e identidade.              |
| Cria faturas ou assinaturas                  | Cobranças avulsas e recorrentes permanecem isoladas por organização filha.     |
| Recebe eventos das organizações filhas       | A plataforma identifica quem vendeu e atualiza seu sistema sem misturar dados. |

<CardGroup cols={2}>
  <Card title="Entender o modelo de Platforms" icon="building" href="/platforms/overview">
    Veja quando criar organizações filhas e como os recursos financeiros ficam
    separados entre elas.
  </Card>

  <Card title="Operar organizações filhas" icon="code" href="/platforms/connected-organizations">
    Crie, ative e selecione cada organização para operar checkouts, pagamentos e
    cobranças pela mesma integração central.
  </Card>
</CardGroup>

## Próximo passo

Se ainda houver dúvida entre a URL reutilizável e uma sessão criada por pedido,
veja a [diferença entre Link de pagamento e Checkout
Session](/payments/payment-link-vs-checkout-session). Se a cobrança pertence a
um cliente ao longo do tempo, comece por [Faturas](/payments/invoices) ou
[Assinaturas](/payments/subscriptions). Depois teste o caminho escolhido no
ambiente de testes antes de ativar pagamentos reais.