# TMB

> Veja como conectar a sua plataforma com a TMB.

Com a integração da TMB, cada venda aprovada libera o acesso do aluno aos cursos da entrega. Reembolso, chargeback, cancelamento e atraso de pagamento 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**, digite "Tmb" no filtro e clique em **Tmb**.
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** o código do produto na TMB (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/tmb/<token>`. Ele só aparece depois de salvar.

### Onde encontrar o ID do produto na TMB

No painel da TMB, abra **Produtos › Produtos**. Abaixo do nome do produto aparece um código, normalmente com 5 ou 6 dígitos. É ele que vai na entrega.

:::dica
No cadastro do produto na TMB, preencha o campo **Link de acesso dos alunos** com a página de login da sua plataforma: `https://<sua-plataforma>/auth/login`.
:::

## 2. Configure o webhook na TMB

1. No painel da TMB, abra **Produtos**.
2. Clique nos três pontos ao lado do produto e escolha **Mais Opções do Produto › Integrações › Webhook Financeiro**.
3. Preencha:
   - **URL:** a URL de postback copiada da entrega
   - **Chave:** se a TMB exigir, preencha qualquer valor. Quem autoriza a venda na sua plataforma é o token que já está no fim da URL.
   - **Valor:** opcional
   - **ID Externo:** não precisa preencher
   - **Status:** ative quando a plataforma estiver pronta para receber alunos
4. Clique em **Atualizar**.

:::aviso
Se o produto usa **boleto parcelado**, use o **Webhook Financeiro**: ele traz os eventos que acompanham a situação da assinatura do cliente.
:::

## 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 TMB (e-mail, código da venda, status e IDs do produto). 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.
:::