# Ticto API ## Docs - [Introdução](https://docs.ticto.com.br/introduction.md): A Ticto API v2 permite criar e gerenciar produtos e ofertas programaticamente. Integre sua central, ERP ou plataforma diretamente à Ticto. - [Quickstart](https://docs.ticto.com.br/quickstart.md): Comece a integrar com a Ticto API v2: obtenha seu token Bearer, autentique suas requisições e crie um produto com oferta passo a passo. - [Autenticação](https://docs.ticto.com.br/authentication/overview.md): Saiba como gerar tokens Bearer no painel da Ticto, incluí-los corretamente nas requisições e tratar erros de autenticação da API v2. - [Escopos](https://docs.ticto.com.br/authentication/scopes.md): Configure permissões granulares no seu token da Ticto API v2. Veja quais escopos cada endpoint exige e como lidar com erros de escopo insuficiente. - [Ciclo de vida do token](https://docs.ticto.com.br/authentication/token-lifecycle.md): Aprenda a criar, revogar e rotacionar tokens da Ticto API v2 sem interromper sua integração em produção. Boas práticas de segurança. - [Ambientes](https://docs.ticto.com.br/concepts/environments.md): Entenda a diferença entre o sandbox e a produção da Ticto API v2, como obter acesso a cada um e como migrar sua integração do teste para o mundo real. - [Idempotência](https://docs.ticto.com.br/concepts/idempotency.md): Aprenda a usar o header Idempotency-Key em requisições POST para garantir que retries não criem recursos duplicados na Ticto API. - [Erros](https://docs.ticto.com.br/concepts/errors.md): Referência completa de códigos de status HTTP e slugs de erro da Ticto API v2, com o formato do envelope de erro e exemplos de validação. - [Rate limits](https://docs.ticto.com.br/concepts/rate-limits.md): A Ticto API v2 permite 120 leituras e 30 escritas por minuto, por token. Saiba como lidar com o 429 e implementar retry com backoff. - [Criar um produto](https://docs.ticto.com.br/guides/create-product.md): Guia completo para criar cursos, ebooks, assinaturas e outros tipos de produto na Ticto usando a API v2. Inclui payload, resposta e próximos passos. - [Criar uma oferta](https://docs.ticto.com.br/guides/create-offer.md): Crie ofertas de pagamento único para seus produtos na Ticto API v2. Defina preço em centavos, configure o checkout e obtenha o link de venda. - [Ofertas recorrentes](https://docs.ticto.com.br/guides/recurring-offers.md): Configure assinaturas e planos recorrentes na Ticto API v2. Defina intervalo de cobrança, período trial e número de ciclos com exemplos prontos. - [Listar produtos](https://docs.ticto.com.br/api-reference/produtos/listar-produtos.md): Lista os produtos do produtor autenticado, paginados. Escopo: `products:read`. - [Criar produto](https://docs.ticto.com.br/api-reference/produtos/criar-produto.md): 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`. - [Buscar produto](https://docs.ticto.com.br/api-reference/produtos/buscar-produto.md): Retorna um produto pelo seu `hash`. Escopo: `products:read`. Retorna `404` se o produto não for do produtor autenticado. - [Listar ofertas](https://docs.ticto.com.br/api-reference/ofertas/listar-ofertas.md): Lista as ofertas de um produto. Escopo: `offers:read`. - [Criar oferta](https://docs.ticto.com.br/api-reference/ofertas/criar-oferta.md): Cria uma oferta para um produto. Você envia apenas o essencial; a Ticto preenche os ~80 campos internos com padrões seguros a partir de um preset. Escopo: `offers:write`. Exige `Idempotency-Key`. - [Buscar oferta](https://docs.ticto.com.br/api-reference/ofertas/buscar-oferta.md): Retorna uma oferta pelo seu `code`, dentro de um produto. Escopo: `offers:read`. - [Listar pedidos](https://docs.ticto.com.br/api-reference/pedidos/listar-pedidos.md): Histórico de pedidos do produtor, paginado. Escopo: `orders:read`. - [Resumo de pedidos](https://docs.ticto.com.br/api-reference/pedidos/resumo-de-pedidos.md): Totais consolidados dos pedidos do produtor. Escopo: `orders:read`. - [Buscar pedido](https://docs.ticto.com.br/api-reference/pedidos/buscar-pedido.md): Retorna um pedido pelo seu `hash`. Escopo: `orders:read`. Retorna `404` se o pedido não for do produtor autenticado — o isolamento é garantido por construção. - [Listar assinaturas](https://docs.ticto.com.br/api-reference/assinaturas/listar-assinaturas.md): Histórico de assinaturas do produtor, paginado. Escopo: `subscriptions:read`. - [Resumo de assinaturas](https://docs.ticto.com.br/api-reference/assinaturas/resumo-de-assinaturas.md): Totais consolidados das assinaturas do produtor. Escopo: `subscriptions:read`. - [Buscar assinatura](https://docs.ticto.com.br/api-reference/assinaturas/buscar-assinatura.md): Retorna uma assinatura pelo seu `id`. Escopo: `subscriptions:read`. Retorna `404` se não for do produtor autenticado. - [Cancelar assinatura](https://docs.ticto.com.br/api-reference/assinaturas/cancelar-assinatura.md): Cancela uma assinatura. **Ação irreversível.** - [Listar saques](https://docs.ticto.com.br/api-reference/saques/listar-saques.md): Histórico de saques (cashouts) do produtor, paginado. Escopo: `cashouts:read` (dado financeiro — escopo próprio, opt-in). - [Resumo de saques](https://docs.ticto.com.br/api-reference/saques/resumo-de-saques.md): Totais consolidados dos saques do produtor. Escopo: `cashouts:read`. - [Buscar saque](https://docs.ticto.com.br/api-reference/saques/buscar-saque.md): Retorna um saque pelo seu `id`. Escopo: `cashouts:read`. Retorna `404` se não for do produtor autenticado. - [Introdução](https://docs.ticto.com.br/webhooks/introduction.md): Guia de referência da API de webhooks (postbacks) da Ticto - [Ambiente de Testes](https://docs.ticto.com.br/webhooks/testing-environment.md): Ambiente mirror (espelho de produção com dados fictícios) para testar o envio dos webhooks. - [Eventos de Venda](https://docs.ticto.com.br/webhooks/v2.md): Atributos e payload dos eventos de venda (compra, reembolso, chargeback e afins, pelo campo status) no formato 2.0, o recomendado. - [Carrinho Abandonado](https://docs.ticto.com.br/webhooks/abandoned-cart-v2.md): Atributos e payload do evento de carrinho abandonado no formato 2.0, o recomendado. - [Afiliação](https://docs.ticto.com.br/webhooks/new-affiliation.md): Atributos e payload do evento de afiliação (criada, solicitada, aprovada). - [Migrar da v1 para a v2](https://docs.ticto.com.br/webhooks/migracao.md): Como sair do webhook (postback) legado 1.0 para a versão 2.0 recomendada: o que muda, de-para dos campos e como trocar a versão. - [Eventos de Venda](https://docs.ticto.com.br/webhooks/v1.md): Atributos e payload dos eventos de venda no formato legado 1.0, descontinuado. Para novas integrações use a 2.0. - [Carrinho Abandonado](https://docs.ticto.com.br/webhooks/abandoned-cart-v1.md): Atributos e payload do evento de carrinho abandonado no formato legado 1.0, descontinuado. Para novas integrações use a 2.0. ## OpenAPI Specs - [openapi](https://docs.ticto.com.br/api-reference/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.