# Ticto

> Veja como conectar a sua plataforma com a Ticto.

Com a integração da Ticto, cada venda aprovada libera o acesso do aluno aos cursos da entrega. Reembolso, chargeback e cancelamento removem o acesso.

## 1. Crie a entrega na sua plataforma

1. No painel, acesse **Vendas › Entregas** e clique em **Nova Entrega**.
2. Na tela **Selecione um Gateway**, clique em **Ticto** (fica no grupo **Principais**).
3. Dê um nome à entrega e escolha a **Modalidade de Venda**: **Venda única** ou **Assinatura**.
4. Em **Conexão com o gateway**, cole no campo **ID do Produto ou Oferta** o ID numérico do produto ou da oferta na Ticto (veja abaixo). Um por linha.
5. Em **Conteúdo entregue**, marque os cursos ou vitrines que a venda libera e, se quiser, o **Tempo de acesso** e a turma em **Liberação**. Em **Tags**, marque as tags que o aluno deve receber.
6. Clique em **Salvar**.
7. Copie o endereço completo do campo **URL de Postback**, no formato `https://<sua-plataforma>/api/postback/ticto/<token>`. Ele só aparece depois de salvar.

### Qual ID usar

1. No painel da Ticto, abra **Produtos** e entre no produto (e na oferta, se for o caso).
2. Olhe a URL do navegador, por exemplo: `dash.ticto.com.br/.../product/12345/offer/67890`.
   - `12345` (depois de `product/`) é o **ID do produto**.
   - `67890` (depois de `offer/`) é o **ID da oferta**.

Use o **ID do produto** quando todas as ofertas liberam o mesmo conteúdo. Use o **ID da oferta** quando uma oferta específica libera algo diferente (por exemplo, a oferta com bônus): crie uma entrega só para ela. Se a venda trouxer os dois, a plataforma procura primeiro uma entrega com o ID da oferta e, se não achar, usa a do produto.

:::aviso
Não confunda o **código da oferta** (letras e números, mostrado nas informações da oferta) com o **ID da oferta** (o número da URL). Na entrega, use sempre o ID numérico.
:::

## 2. Configure o webhook na Ticto

Use sempre a **versão 2.0** e o formato **JSON**.

1. No painel da Ticto, abra **Tictools › Webhooks** e clique em **Criar Novo Webhook**.
2. Se você usa Order Bump, marque a opção de enviar o combo **SEPARADAMENTE** da oferta principal. Assim cada produto comprado é identificado sozinho.
3. Selecione o produto. Os webhooks da Ticto são por produto: crie um para cada produto que você vai entregar.
4. Em **URL**, cole a URL de postback da entrega desse produto.
5. Selecione todos os eventos.
6. Clique em **Salvar** e repita para os outros produtos.

## 3. Teste

1. Faça uma compra de teste com um e-mail que **não** seja de administrador da plataforma (vendas com e-mail de administrador são recusadas).
2. Acesse **Vendas › Vendas**. A venda aparece em **Últimas** (enquanto é processada, fica em **Na Fila**).
3. Abra a venda (menu **···** › **Ver detalhes**) e confira o evento recebido, os **IDs de produto/oferta no payload** e, se houver, o **Motivo do erro**.
4. Se precisar ajustar a entrega, corrija e clique em **Reprocessar** na venda.

:::info Integração por leitura automática
A plataforma reconhece os campos mais comuns do envio da Ticto (e-mail, código da venda, status e IDs do produto e da oferta). Valide com uma venda real antes de abrir as vendas. Se algo não for reconhecido, a venda aparece em **Vendas › Vendas**, na aba **Com erro**, com o motivo.
:::