Checkout hospedado
Você cria um produto e compartilha um link. A Cakto exibe a página de pagamento, coleta os dados do comprador e processa a transação.
Cobrança direta pela API
Você já tem o seu próprio formulário de pagamento e quer apenas processar a transação pela Cakto, sem passar pelo checkout hospedado.
Caminho 1 — criar produto já cria o checkout
Não existe um endpoint “criar checkout”. Ao criar um produto, a Cakto já gera automaticamente a oferta padrão, o checkout e o link de pagamento.
1
Crie o produto
POST /public_api/products/ — cria o produto e, junto, a oferta padrão, o checkout e o link.2
Liste os checkouts do produto
GET /public_api/products/{id}/checkouts/ — o checkout padrão vem com default: true.3
Abra o detalhe do checkout
GET /public_api/products/{id}/checkouts/{checkout_id}/ — traz a oferta vinculada, no campo offers.4
Compartilhe o link
O link público final é
https://pay.cakto.com.br/{id_da_oferta} — um domínio diferente de api.cakto.com.br.Caminho 2 — cobrar diretamente pela API
POST /public_api/payments/ cria uma cobrança (Pix, Pix Automático, boleto ou cartão) sem passar pelo checkout hospedado. É o caminho de quem já tem o próprio formulário de pagamento.
Os campos variam por método — cada um tem sua própria página de referência:
Pix
QR Code copia-e-cola
Pix Automático
Autorização de débito recorrente
Boleto
Linha digitável e PDF
Cartão
Token de cartão obtido no front-end
Pré-requisito: conta Cakto Banking para Pix e boleto
pix, pix_auto e boleto só são aceitos se o produtor tiver uma conta Cakto Banking com abertura concluída, ativa, marcada como principal e sem encerramento em curso — é nela que esses métodos liquidam. Sem isso, a cobrança volta 400 no campo paymentMethod, antes de chegar à adquirente.
credit_card e threeDs ficam fora desse gate e funcionam sem conta Banking.
A API pública não expõe endpoint para consultar o status dessa conta: os dois jeitos de descobrir são a resposta 400 da cobrança e o Painel Cakto. As quatro condições exatas estão em Pré-requisitos.
Order bumps
Para oferecer um item complementar no mesmo checkout, sem um segundo fechamento:Próximos passos
Receber sua primeira venda
Do produto ao webhook de venda aprovada
Glossário
Como produto, oferta, checkout e pedido se relacionam