Criar produto
Cria um produto, já pronto para vender. O status é gerido pela plataforma e é somente leitura: não pode ser enviado nem alterado pela API. Use is_active (padrão true) para criar o produto já ativo ou inativo. Escopo: products:write. Exige Idempotency-Key.
Authorizations
Token opaco no formato ticto_live_... (produção) ou ticto_test_... (sandbox). Enviado como Authorization: Bearer <token>.
Headers
UUID v4 único por operação. Garante que retries não criem recursos duplicados.
Body
Nome do produto.
255Tipo do produto (apenas digitais na v2). Recorrência é definida na oferta (charge_type: recurring), não no tipo.
course, ebook, consultancy, mentoring, artificial_intelligence, other 3 - 1000Categoria (opcional).
120Define se o produto nasce ativo (disponível) ou inativo. Opcional; padrão true.
Response
Produto criado.
"product"
Hash do produto — identificador canônico da API.
"PABC123"
ID numérico legado (reconcilia com a dashboard). Não é fronteira de segurança.
42
"Curso de Marketing Digital"
"course"
Status do produto, gerido pela plataforma. Somente leitura: não pode ser enviado nem alterado pela API.
"approved"
Se o produto está ativo (disponível). Controlado pelo produtor via is_active na criação.
true