Skip to main content
A API v2 da Ticto permite que você crie e gerencie produtos de forma programática, integrando sua plataforma diretamente ao seu fluxo de desenvolvimento ou ferramentas de automação. Com um único endpoint, você registra cursos, ebooks, mentorias e muito mais, sem precisar acessar o painel para cada cadastro.

​
Tipos de produto

Antes de criar um produto, escolha o tipo que melhor descreve o que você está vendendo. O campo type define como a Ticto trata o produto internamente, incluindo quais métodos de pagamento e configurações são aplicados automaticamente.
A v2 cobre apenas produtos digitais. Físico e evento (que exigem frete/lote) ficam no painel. Cobrança recorrente não é um tipo de produto. Ela é definida na oferta, com charge_type: recurring.

​
Criando um produto digital

1

Prepare o payload

Monte o corpo da requisição com o nome e o tipo do produto. Para produtos digitais, apenas esses campos básicos são necessários. A Ticto preenche automaticamente os métodos de pagamento e outras configurações padrão.
2

Envie a requisição

Faça um POST para /api/v2/products, incluindo o header de autenticação e um Idempotency-Key único para garantir que a requisição não seja processada mais de uma vez.
3

Verifique a resposta

Uma resposta 201 Created confirma que o produto foi registrado. Anote o campo hash, você vai precisar dele para criar ofertas vinculadas a este produto.
4

Pronto para vender

O produto nasce aprovado e ativo, pronto para vender. Se você quiser criar o produto já indisponível (por exemplo, para configurar as ofertas antes de divulgar), envie is_active: false na criação e ative depois pelo painel.

​
Campos do produto

​
string
required
Nome do produto exibido no painel e no checkout. Deve ser claro e descritivo para seus clientes.
​
string
required
Tipo do produto. Valores aceitos: course, ebook, consultancy, mentoring, artificial_intelligence, other. Define as configurações padrão aplicadas automaticamente pela Ticto.
​
string
Descrição detalhada do produto. Aparece na página de checkout e na área de membros. Opcional, mas recomendado para melhorar a conversão.
​
boolean
default:"true"
Define se o produto nasce ativo (disponível) ou inativo. Opcional; padrão true. É o único campo de estado que você controla pela API, funciona como um interruptor de disponibilidade. Envie false para criar o produto oculto e ativá-lo depois pelo painel.
O campo status é gerido pela plataforma e é somente leitura: não pode ser enviado nem alterado pela API. Enviar status no corpo retorna erro 422. Para tornar um produto indisponível, use is_active.

​
Próximos passos

Com o produto criado e o hash em mãos, o próximo passo é configurar uma oferta, que define o preço e as condições de pagamento que seus clientes verão no checkout.

Criar Oferta Única

Defina um preço de pagamento único para o seu produto e obtenha o link de checkout.

Criar Oferta Recorrente

Configure planos de assinatura com intervalo, trial e ciclos para o seu produto.