Skip to main content
Há duas formas de receber um pagamento pela Cakto, e a escolha entre elas define o resto da integração.

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.
O passo a passo:
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.
O passo a passo completo, com os comandos prontos, está em Criar um checkout. Para ajustar a aparência da página, veja Estrutura do Checkout.

​
Caminho 2 — cobrar diretamente pela API

POST /public_api/payments/ cria uma cobrança (Pix, Pix Automático 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

Cartão

Token de cartão obtido no front-end
Boleto saiu do contrato em 11/09/2026 e paymentMethod: "boleto" responde 400. Boleto já emitido segue com a mesma baixa; o que mudou foi a emissão de novos. Ver Changelog.
Cartão com autenticação do emissor tem endpoint próprio: Criar Cobrança 3DS.
O header X-Idempotency-Key é obrigatório nessa chamada: sem ele, a resposta é 400. Veja Idempotência.

​
Order bumps

Para oferecer um item complementar no mesmo checkout, sem um segundo fechamento:
O item aparece como oferta adicional, de um clique, antes do fechamento da compra principal. Veja Criar Order Bump.

​
Depois da aprovação

No checkout hospedado, o comprador vê a tela de aprovação e fica nela. Se você precisa trazê-lo de volta ao seu sistema — e saber qual compra é aquela —, veja Redirect pós-pagamento: a URL é cadastrada no produto e recebe um identificador que você mesmo manda no link do checkout. O recurso é liberado após análise do Compliance.

​
Próximos passos

Receber sua primeira venda

Do produto ao webhook de venda aprovada

Glossário

Como produto, oferta, checkout e pedido se relacionam