Skip to main content
O Checkout Builder é o recurso da Chargefy para configurar e personalizar suas páginas de checkout hospedadas. Em um único lugar, você define identidade visual, conteúdo, campos do comprador, meios de pagamento, descontos, parcelamento e o template usado para apresentar a compra.

Abrir o Checkout Builder

Entre no Dashboard, escolha a organização e abra Configurações → Checkout para editar e salvar a configuração.
Preview do checkout com painel aberto para configurar desconto, campos obrigatórios, cores, tema, cantos e fonte

Preview interativo com campos obrigatórios, cores, tema, cantos e fonte configurados lado a lado.

Cada organização mantém uma única configuração. Checkout Sessions e Payment Links carregam as escolhas atuais quando a página é aberta, inclusive quando o link ou a sessão já existia antes da alteração.

O que você pode configurar

Ao habilitar boleto, documento e endereço de cobrança passam a ser obrigatórios. O Builder aplica essa dependência automaticamente.

O que fica no Builder e o que fica na venda

O Builder controla a experiência compartilhada pela organização. A Checkout Session ou o Payment Link continua descrevendo a compra específica. Não existem configurações visuais por sessão ou por link. Assim, a página e a validação usam sempre a mesma política da organização.

Templates

Templates mudam a composição do resumo da compra. O formulário, os meios de pagamento, o parcelamento, os campos obrigatórios e a confirmação continuam seguindo as demais escolhas do Checkout Builder.

Minimal

Checkout minimal em azul com desconto, cartão, Pix, documento e telefoneProduto, resumo e pagamento no caminho mais direto.

Booking

Checkout booking em verde com estadia, noites, adicionais e endereço do compradorDestaca reserva, período, adicionais e taxas sem misturar essas informações com o formulário.

Subscription

Checkout subscription roxo em tema escuro com plano anual, período de teste e pagamento por cartãoExplica período de teste, ciclo de cobrança, renovação e valor recorrente.
Clique em qualquer imagem para abrir o preview e testar cores, campos, meios de pagamento e outras escolhas ao vivo.

Como os dados da venda alimentam cada template

O template é escolhido no Checkout Builder — não existe um campo template no request. O payload define os dados da compra que cada composição vai apresentar.
Veja todas as variantes de line_items em Criar uma Checkout Session.

Como uma alteração chega ao checkout

1

Edite a configuração

Abra Configurações → Checkout, ajuste o Builder e salve.
2

O comprador abre a página

Uma Checkout Session ou um Payment Link carrega a configuração atual da organização.
3

A mesma política valida o pagamento

A confirmação respeita os métodos, os campos obrigatórios e o parcelamento exibidos na tela.
Se você desabilitar um meio de pagamento ou tornar um dado obrigatório, a mudança passa a valer no próximo carregamento da página. Não é necessário recriar links ou sessões.

Próximos passos

Criar o primeiro checkout

Crie uma Checkout Session, redirecione o comprador e confirme o resultado.

Entender Checkout Sessions

Veja itens, customer, expiração, estados e métodos de pagamento.

Criar e aplicar descontos

Combine desconto predefinido com códigos informados pelo comprador.

Criar um Link de pagamento

Publique uma URL reutilizável com a mesma configuração de checkout.