Skip to main content
Este guia liga as pontas entre criar um checkout e o guia de webhooks: ao final, você terá um produto vendável e sua aplicação vai saber, em tempo real, quando alguém comprar.
Para cobrar pela API (POST /public_api/payments/) com Pix, Pix Automático ou Boleto, o produtor precisa de uma conta Cakto Banking aberta e ativa — é nela que esses métodos liquidam. Sem ela a chamada volta 400. Cartão (credit_card, threeDs) não exige. Detalhes em Pré-requisitos.
1

Crie o produto

Criar o produto já cria a oferta padrão, o checkout e o link de pagamento — não existe um endpoint separado de “criar checkout”. Veja o passo a passo em Criar um checkout.Guarde o id do produto retornado: você vai precisar dele no próximo passo.
2

Cadastre um webhook para o produto

Sua chave de API precisa do escopo write webhooks. Crie o webhook informando products (o Id do produto do passo anterior) e o evento purchase_approved:
curl
products é obrigatório: o webhook só recebe eventos dos produtos informados. Detalhes em Criar Webhook.
A resposta traz o id do webhook e um secret — guarde o secret, é com ele que você valida a origem de cada entrega. Veja como em Guia de Webhooks.
3

Teste antes de esperar por uma venda real

Envie um evento de teste para o mesmo webhook e confirme que sua aplicação recebe e responde corretamente:
curl
Detalhes em Testar Webhook.
4

Compartilhe o link de pagamento

Pegue o link do checkout (formato https://pay.cakto.com.br/{id_da_oferta}, obtido no passo 3 de Criar um checkout) e compartilhe com um comprador.Quando o pagamento for aprovado, a Cakto envia purchase_approved para a URL cadastrada — automaticamente, sem chamada adicional da sua parte.
5

Confirme a entrega

Se sua aplicação não receber o evento, consulte o que a Cakto tentou entregar:
curl
Detalhes em Histórico de Eventos. Se uma entrega falhou e você já corrigiu o problema na sua aplicação, reenvie com Reenviar Evento.

​
Próximos passos

Guia de Webhooks

Catálogo de eventos, retentativas e validação de origem

Vender vários itens

Adicione order bumps ao mesmo checkout

Pedidos

Consulte os detalhes do pedido por trás de cada venda

Erros

O que fazer quando algo não sai como esperado