Criar um checkout

Não existe um endpoint “criar checkout”. O checkout é a vitrine de um produto: ao criar o produto, a Cakto já gera automaticamente a oferta padrão, o checkout e o link de pagamento (https://pay.cakto.com.br/{id_da_oferta}).Em resumo: criou o produto = criou o checkout.

Pré-requisitos

Uma conta ativa na Cakto. Cadastre-se aqui.
Suas chaves de API (client_id e client_secret) com os escopos write products e write offers. Veja o guia de autenticação.

Passo a passo

Autentique-se

Troque suas credenciais por um token de acesso. Detalhes em Autenticação.

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, que você usará no header Authorization: Bearer {access_token} das próximas requisições.

Crie o produto (isso já cria o checkout)

Envie um POST para /products/. Os campos obrigatórios são name, description, price, type e salesPage.

curl

curl -X POST https://api.cakto.com.br/public_api/products/ \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Curso de Fotografia",
    "description": "Curso completo de fotografia para iniciantes",
    "price": 197.00,
    "type": "unique",
    "salesPage": "https://meusite.com.br/curso-fotografia"
  }'

Use "type": "unique" para venda única ou "type": "subscription" para assinatura. A lista completa de campos está na referência Criar Produto.

Nesse único passo, a Cakto cria o produto e a oferta padrão, o checkout e o link de pagamento. A resposta retorna o produto criado, incluindo seu id e short_id.

Obtenha o link do checkout

Liste os checkouts do produto para encontrar o checkout padrão (default: true):

curl

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

Abra o detalhe do checkout para ver a oferta vinculada (campo offers):

curl

curl https://api.cakto.com.br/public_api/products/{id_do_produto}/checkouts/{id_do_checkout}/ \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN"

O link público do checkout segue o formato:

https://pay.cakto.com.br/{id_da_oferta}

Pronto — é só compartilhar esse link com seus compradores.

Vender vários itens num único checkout

Hoje cada checkout exibe uma oferta principal. Para oferecer itens adicionais no mesmo fechamento, use order bumps: produtos complementares que o comprador adiciona com um clique antes de pagar.

curl

curl -X POST https://api.cakto.com.br/public_api/products/{id_do_produto}/bumps/ \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "bump_product_id": "ID_DO_PRODUTO_COMPLEMENTAR" }'

Veja todas as opções em Order Bumps.

Personalizar o checkout

Você pode ajustar a aparência e a configuração do checkout pelo campo config. Veja Atualizar Checkout.

Próximos passos

Criar Produto

Referência completa dos campos de criação de produto

Ofertas

Crie ofertas adicionais para o mesmo produto

Order Bumps

Ofereça itens complementares no checkout

Webhooks

Receba eventos de venda em tempo real

Comece aqui

Cakto SDK

Pagamentos

Pedidos

Webhooks

Produtos

Checkouts

Ofertas

Order Bumps

Clientes

Assinaturas

Pré-requisitos

Passo a passo

Vender vários itens num único checkout

Personalizar o checkout

Próximos passos

Criar Produto

Ofertas

Order Bumps

Webhooks

​Pré-requisitos

​Passo a passo

​Vender vários itens num único checkout

​Personalizar o checkout

​Próximos passos

Criar Produto

Ofertas

Order Bumps

Webhooks

Pré-requisitos

Passo a passo

Vender vários itens num único checkout

Personalizar o checkout

Próximos passos