O caminho geral está em Como eu conecto a minha plataforma de checkout. Aqui ficam só as partes que são específicas da Hotmart.
Passo a passo
- No painel, abra Configurações → Integrações, clique no card da Hotmart e
copie o campo URL do webhook. Confira que ela termina em
hotmartv2. - Na Hotmart, vá na área de webhooks e notificações das ferramentas do produto, crie uma configuração nova, cole a URL e escolha a versão de envio mais recente oferecida.
- Marque a compra aprovada e também todos os eventos de baixa: cancelada, reembolsada, expirada, chargeback e assinatura cancelada.
- Copie o código do produto na Hotmart. Se você vende o mesmo produto em ofertas diferentes, copie o código de cada oferta.
- De volta às Integrações da Nichoos, cadastre o produto colando esse valor no campo ID do produto — uma integração por oferta, quando for o caso.
Com as duas metades no lugar, a compra aprovada na Hotmart libera o acesso em alguns minutos.
O resto deste guia explica o que cada evento faz, como tratar várias ofertas e o que acontece na recompra.
A URL
No painel, em Configurações → Integrações, clique no card da Hotmart e copie o
campo URL do webhook. Ela termina em hotmartv2:
https://nichoos.top/integration/hotmartv2?...
Onde colar na Hotmart
Na Hotmart, procure a área de webhooks e notificações dentro das ferramentas do produto. O nome exato do menu muda conforme a versão do painel dela. Crie uma configuração nova, cole a URL e escolha a versão de envio mais recente que a Hotmart oferecer.
Quais eventos marcar
Marque a aprovação e todos os eventos de baixa. É aqui que a maioria dos problemas nasce: quem marca só a compra aprovada acaba com gente cancelada ainda dentro da comunidade.
- Compra aprovada (
PURCHASE_APPROVED) — abre o acesso - Compra cancelada (
PURCHASE_CANCELED) - Compra reembolsada (
PURCHASE_REFUNDED) - Compra expirada (
PURCHASE_EXPIRED) - Chargeback (
PURCHASE_CHARGEBACK) - Assinatura cancelada (
SUBSCRIPTION_CANCELED)
Os cinco últimos fecham o acesso. Um deles se comporta diferente dos outros: remove o membro inteiro da comunidade, não só o produto comprado. Vale entender a diferença em O que acontece quando o cliente cancela ou pede reembolso.
O ID do produto
Na Hotmart, é o código do produto — o mesmo que aparece na URL quando você abre o produto no painel dela. Cole exatamente esse valor no campo ID do produto do cadastro na Nichoos.
Produtos com várias ofertas
A Hotmart permite ofertas diferentes do mesmo produto: preços, prazos e condições distintas com um código de oferta cada. A Nichoos consegue casar a compra pelo código da oferta, além do código do produto.
Isso importa quando você vende o mesmo produto com durações diferentes — por exemplo, anual e vitalício. Nesse caso, cadastre uma integração por oferta, cada uma com a sua expiração, usando o código da oferta como identificador. Se você cadastrar só o produto, todas as ofertas herdam a mesma duração.
Comprou duas vezes o mesmo produto
Acontece com renovação e com recompra. Antes de fechar o acesso por um cancelamento, a Nichoos procura se existe outra compra aprovada do mesmo produto ainda ativa. Se existir, o acesso é mantido.
Ou seja: cancelar um pedido antigo de quem já recomprou não derruba a pessoa.