Primeira chamada em 5 minutos

O que você vai precisar

Uma conta ativa na Cakto. Cadastre-se aqui.
5 minutos.

Crie sua Chave de API

Acesse Painel Cakto → Integrações → Cakto API e crie uma chave com o escopo read products.Guarde o client_id e o client_secret — o client_secret só é exibido uma vez, no momento da criação.

Detalhes completos sobre escopos estão em Autenticação.

Troque suas credenciais por um token

curl

curl -X POST https://api.cakto.com.br/public_api/token/ \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "client_id=SEU_CLIENT_ID" \
  -d "client_secret=SEU_CLIENT_SECRET"

A resposta traz o access_token:

{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "expires_in": 36000,
  "token_type": "Bearer",
  "scope": "read products"
}

Faça sua primeira chamada

Use o access_token para listar seus produtos:

curl

curl https://api.cakto.com.br/public_api/products/ \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN"

Se você ainda não tem produtos cadastrados, a resposta vem com results vazio — e está tudo certo, sua integração já está autenticando corretamente:

{
  "count": 0,
  "next": null,
  "previous": null,
  "results": []
}

Recebeu uma resposta 200 com count, next, previous e results? Sua integração está funcionando. O resto é sobre quais dados buscar e quais ações tomar.

Erros comuns nesta etapa

Sintoma	Causa provável
`401` ao pedir o token	`client_id` ou `client_secret` errados, ou copiados com espaço extra
`400 invalid_scope` ao pedir o token	Escopo pedido não está entre os configurados na chave de API
`401` ao listar produtos	Token expirado (`expires_in`) ou header `Authorization` sem o prefixo `Bearer`

Próximos passos

Receber sua primeira venda

Crie um produto, configure um webhook e veja o evento chegar

Glossário

Entenda como produto, oferta, checkout e pedido se relacionam

Autenticação completa

Escopos, expiração de token e boas práticas de segurança

Referência da API

Explore todos os endpoints disponíveis

Comece aqui

Conceitos

Cakto SDK

CaktoMCP

Pagamentos

Pedidos

Webhooks

Produtos

Checkouts

Ofertas

Order Bumps

Clientes

Taxas e Prazos

Juro de Parcelamento

Assinaturas

Primeira chamada em 5 minutos

O que você vai precisar

Erros comuns nesta etapa

Próximos passos

Receber sua primeira venda

Glossário

Autenticação completa

Referência da API

​O que você vai precisar

​Erros comuns nesta etapa

​Próximos passos

Receber sua primeira venda

Glossário

Autenticação completa

Referência da API

O que você vai precisar

Erros comuns nesta etapa

Próximos passos