# Hubla

> Veja como conectar a sua plataforma com a Hubla.

Com esta integração, cada venda aprovada na Hubla libera o acesso do aluno aos cursos da entrega. Reembolso, chargeback e cancelamento removem o acesso daquela venda.

## 1. Crie a entrega na sua plataforma

1. No painel, abra **Vendas › Entregas** e clique em **Nova Entrega**.
2. Na tela **Selecione um Gateway**, escolha **Hubla**.
3. Dê um nome à entrega e escolha a **Modalidade de Venda**: **Venda única** ou **Assinatura**.
4. No campo **ID do Produto**, cole o ID do produto na Hubla. Para achar: no painel da Hubla, clique em **Produtos**, abra o produto e vá na aba **Ofertas**. O **ID do produto** aparece abaixo do nome da oferta. Se mais de um ID deve liberar a mesma coisa, coloque um por linha.
5. Em **Conteúdo entregue**, marque os cursos que a venda libera e defina o **Tempo de acesso** e a **Liberação** de cada um. Se quiser, marque também as **Tags** que o aluno ganha.
6. Clique em **Salvar**.
7. No bloco **Conexão com o gateway**, copie a **URL de Postback**. Ela aparece depois de salvar e termina com o token desta entrega: copie o endereço inteiro.

## 2. Configure o webhook na Hubla

1. No painel da Hubla, clique em **Integrações › Webhooks**.
2. Clique em **Adicionar Webhook**.
3. Na seção de configurações, clique em **Adicionar Regra**.
4. Preencha:
  - **Nome**: um nome que identifique a sua plataforma.
  - **URL**: a URL de Postback da entrega.
  - **Produtos**: todos, ou só os que serão entregues pela sua plataforma.
5. Em **Eventos**, marque:
  - Assinatura criada
  - Assinatura ativa
  - Assinatura desativada
  - Assinatura expirada
  - Renovação de assinatura desativada
  - Renovação de assinatura ativada
  - Pagamento da fatura realizado
  - Pagamento da fatura falhou
  - Fatura expirada
  - Fatura reembolsada
  - Solicitação de reembolso aceita
  - Solicitação de reembolso cancelada
  - Solicitação de reembolso rejeitada
  - Assinatura cancelada
  - Solicitação de reembolso
  - Venda cancelada
6. Clique em **Salvar**.

## 3. Teste

1. Na Hubla, em **Integrações › Webhooks**, clique nos três pontos da regra criada e em **Testar Configuração**. Preencha os campos com dados fictícios e clique em **Enviar Teste**.
2. Se o envio de teste do gateway aparecer **Com erro**, não se preocupe: o teste costuma trazer dados de exemplo, sem um produto seu. O importante é que ele chegou. A confirmação de verdade é uma compra real.
3. Antes de abrir as vendas, faça uma compra real de teste do produto.
4. No painel, abra **Vendas › Vendas** e confira se o envio chegou.
5. Se estiver como **Processada**, o acesso foi liberado. Se estiver **Com erro**, clique em **Ver detalhes** e leia o **Motivo do erro**. Corrija a causa (por exemplo, cadastrando na entrega o ID que veio no envio) e clique em **Reprocessar**.

Para a compra de teste, use um e-mail que não seja de um administrador da plataforma: vendas com e-mail de administrador não são processadas.

:::info Integração por leitura automática
A Hubla não tem integração dedicada: a plataforma lê o aviso enviado e reconhece sozinha os campos comuns, como e-mail, nome e CPF do cliente, código da venda, IDs de produto ou oferta e o status. Como cada gateway tem seus detalhes, valide com uma venda real antes de abrir as vendas. Se algum dado não for reconhecido, a venda aparece em **Vendas › Vendas** como **Com erro**, com o motivo, e os dados brutos ficam em **Ver detalhes**.
:::