> ## 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. # Pagamentos online > Conheça as opções de integração para receber pagamentos online com PIX, cartão e boleto na Chargefy. Escolha quanto da experiência de compra você quer entregar pronta e quanto quer controlar no seu produto. A Chargefy oferece desde uma URL compartilhável sem backend por pedido até uma integração white-label em que sua aplicação desenha todos os estados do pagamento. Para a maioria das integrações, comece com uma **Checkout Session** e use a página hospedada. Ela coordena itens, comprador, métodos de pagamento, parcelamento, expiração e webhooks, enquanto seu backend decide o que será vendido e quando o pedido pode ser liberado. Crie uma Checkout Session no backend e redirecione o comprador para uma página pronta para PIX, cartão ou boleto. ## Escolha a experiência de pagamento Use a forma que combina com a origem da compra e com o nível de controle que a sua equipe precisa manter. **Sem backend por compra.** Configure uma oferta reutilizável no Dashboard ou pela API e compartilhe a mesma URL quantas vezes precisar. **Esforço de integração:** baixo. **Recomendado.** Crie uma Checkout Session para cada pedido e redirecione o comprador para uma página configurada pela sua organização. **Esforço de integração:** médio. **Controle total.** Crie a interface dentro do seu produto com Chargefy.js, cartão tokenizado no navegador e cobranças coordenadas pelo seu backend. **Esforço de integração:** maior. Decida entre uma URL reutilizável para a mesma oferta e uma tentativa criada sob demanda para cada pedido. ## Escolha a API A **Checkout Sessions API** modela a compra completa. A **Payment Intents API** modela somente a tentativa financeira. Prefira Checkout Sessions quando a Chargefy também deve coordenar itens, dados do comprador, métodos, aparência e expiração. Use Payment Intents quando a sua aplicação já resolveu o checkout e precisa controlar diretamente a cobrança. | Decisão | [Checkout Sessions](/payments/create-checkout-page) | [Payment Intents](/payments/payment-intents) | | ----------------------- | ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- | | **Recomendado para** | Carrinhos, ofertas e assinaturas com menos código de checkout. | Cobranças server-to-server, cartão salvo ou fluxo financeiro totalmente controlado por você. | | **Entrada principal** | Itens, comprador, desconto e URLs de retorno daquele pedido. | Valor final, moeda, método de pagamento e opções da cobrança. | | **Interface** | Página hospedada pela Chargefy ou frontend próprio autenticado pelo `client_secret`. | Interface criada e mantida pela sua equipe. | | **Formas de pagamento** | Cartão, PIX e boleto, conforme a configuração da organização. | Cartão e PIX na criação direta; boleto nasce em checkout hospedado ou invoice. | | **Assinaturas** | Itens recorrentes materializam a assinatura quando o checkout termina. | O intent processa a cobrança; assinatura e invoice coordenam a recorrência. | | **Complexidade** | Aumenta com as regras da compra, mas preserva o mesmo ciclo de Checkout Session. | Exige que sua aplicação mantenha os estados, a apresentação e as regras do checkout. | ### Comparação de recursos | Recurso | Checkout Session | Payment Intent | | ---------------------------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | **Resumo e itens da compra** | Mantém `line_items`, quantidade, subtotal, desconto e total. | Recebe o valor final; sua aplicação mantém os itens. | | **Página hospedada** | Entrega uma `url` pronta para redirecionamento. | Não entrega página de checkout. | | **Dados do comprador** | Coleta os campos mínimos do método e os adicionais definidos no Checkout Builder. | Sua aplicação coleta e vincula o customer ou payment method. | | **Descontos** | Aplica desconto pré-configurado ou código informado pelo comprador. | Sua aplicação resolve o valor antes de criar ou atualizar o intent. | | **Parcelamento** | Apresenta as opções válidas no checkout conforme a configuração da organização. | Sua interface apresenta as opções e envia a escolha em `payment_method_options`. | | **Expiração** | Expira automaticamente depois de 24 horas se não for confirmada. | O ciclo depende do status da cobrança e, nos métodos assíncronos, da validade da próxima ação. | | **Confirmação do resultado** | Emite eventos de `checkout.session.*` e reflete o Payment Intent relacionado. | Emite eventos de `payment.intent.*` para cada transição financeira. | | **Nível de manutenção** | A Chargefy mantém a experiência e o ciclo da compra. | Sua equipe mantém a experiência, o retry e a tradução dos estados para o comprador. | ## Formas de pagamento O checkout hospedado oferece os métodos habilitados no [Checkout Builder](/payments/configure-checkout-page). Cartão costuma concluir na própria confirmação; PIX e boleto continuam assíncronos até a compensação financeira. | Forma de pagamento | O que o comprador faz | Quando seu sistema confirma o pedido | Onde usar | | --------------------- | ------------------------------------------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------ | | **PIX** | Escaneia o QR Code ou usa o código copia e cola. | Depois da confirmação assíncrona recebida por webhook. | Checkout hospedado ou cobrança direta com Payment Intent. | | **Cartão de crédito** | Informa o cartão e escolhe o parcelamento quando essa opção estiver habilitada. | Após a aprovação; o webhook continua sendo a fonte de verdade. | Checkout hospedado, checkout white-label ou cartão já salvo. | | **Boleto** | Abre o documento e paga pela linha digitável ou pelo código de barras. | Depois da compensação bancária recebida por webhook. | Checkout hospedado ou cobrança documentada por uma fatura. | Você não precisa escolher uma única forma de pagamento para toda a operação. No checkout hospedado, habilite os métodos e o parcelamento no [Checkout Builder](/payments/configure-checkout-page). Em uma integração própria, a disponibilidade depende do fluxo financeiro implementado. A presença do comprador na página de sucesso não comprova o pagamento. Para métodos assíncronos, libere o pedido somente depois do evento de pagamento confirmado. ## Recursos que acompanham o checkout Use os mesmos recursos em pagamentos avulsos e recorrentes para manter catálogo, promoções e operação financeira consistentes. Organize o que você vende, valores de cobrança única e cadências recorrentes. Aplique regras automáticas ou códigos resgatáveis no checkout e nos Links de pagamento. Inicie cobranças recorrentes, trials, pró-rata, faturas e recuperação de receita. Defina métodos, campos obrigatórios, parcelamento, identidade e template da página hospedada. Ofereça um item adicional depois de uma compra aprovada no cartão. Acompanhe abertura, tentativa, recusa, expiração e venda aprovada no seu funil. ## Depois do pagamento Seu backend deve reagir ao estado financeiro confirmado, executar cada efeito uma única vez e manter a ligação entre pedido, cobrança e recebimento. Conecte o pedido, a página de retorno e os webhooks sem mostrar um sucesso prematuro. Libere produto ou acesso de forma idempotente depois da confirmação. Explique quanto foi pago, quais valores foram descontados e quando o saldo liquida. Devolva total ou parcialmente sem apagar o histórico financeiro da compra.