2011
[MANUAL DE INTEGRAÇÃO PARA
SITES DE MEMBROS]
Destinado a usuários que desejam vender conteúdo premium, disponível em sites de membros, através da
plataforma Hotmart. Versão do documento: 1.0, 11/04/2011.
Índice
Pré-requisitos para usar este Manual ............................................................................... 3
Introdução ................................................................................................................................ 4
O que são Sites de Membros? ............................................................................................. 4
Cadastrando o Produto ............................................................................................................ 5
Configurações de Integração com seu Site de Membros ........................................................ 7
1)
Onde fica a Página de Cadastro ................................................................................. 8
Definindo as Preferências da sua Página de Vendas ............................................................ 13
Integração com a Plataforma ................................................................................................. 15
Integração Manual .............................................................................................................. 15
Integração Fraca ................................................................................................................ 16
Integração Forte ................................................................................................................. 17
1º Passo: Importar o Lote de Seriais .............................................................................. 17
2º Passo: Implementar a Validação ................................................................................ 17
Integração de Descadastro Automático (opcional) ............................................................. 18
Guia Rápido ........................................................................................................................... 20
Passo a Passo rápido para Integração com Hotmart ......................................................... 20
Parâmetros Enviados pelo Hotmart .................................................................................... 20
Informações enviadas por email pelo Hotmart ................................................................... 21
Apêndice A: Como obter seu Hotlink de Pagamento Direto ............................................... 21
Dúvidas? ............................................................................................................................ 22
2
Como usar este Manual?
Se você quer informações detalhadas sobre a integração de Sites de Membros com o
Hotmart, simplesmente leia o manual na ordem natural em que ele está disposto.
Se você é um usuário familiarizado com o Hotmart, e avançado em termos de programação
web, fique à vontade para seguir para o
3
Guia Rápido, disponível no final deste manual.
Pré-requisitos para usar este Manual
Para o bom entendimento e uso deste manual é necessário que o leitor tenha uma conta
criada e pronta para ser usada no Hotmart e tenha conhecimentos de programação web
(HTML, Javascript e Banco de Dados).
4
Introdução
Conteúdo Digital pode existir livre nos blogs e sites da internet, pode exisitir na forma de
arquivos para download, ou pode existir em sites de acesso restrito, onde apenas pessoas
autorizadas podem ter acesso.
Uma das possibilidades que o Hotmart oferece é a venda de Conteúdo Digital Premium em
Sites de Membros. O objetivo deste manual é explicar ao usuário do Hotmart como integrar
o seu sistema com a nossa plataforma, e assim vender os acessos ao seu Site de Membros
utilizando nosso programa de afiliados e demais recursos do Hotmart.
O que são Sites de Membros?
Sites de Membros são sistemas que permitem que pessoas autorizadas (membros),
acessem conteúdo restrito. Muitos empreendedores vendem conteúdo desta forma, ou seja,
apenas compradores que já tiveram seus pagamentos confirmados, podem então se
cadastrar e acessar o conteúdo do site.
Exemplos de sites de membros:




Clubes Privados
Sites de Coaching Online
Cursos e Treinamentos Online
Fóruns de conteúdo restrito
Trazendo para um exemplo mais real, imagine que você ofereça vídeo-aulas sobre como
Tocar Violão, e este conteúdo esteja disponível em uma parte restrita somente a membros
no seu site. Assim, para se tornar um membro, o usuário deve fazer um pagamento
(Adesão). Este é o tipo de Cenário onde a solução para Sites de Membros do Hotmart se
encaixa.
5
Cadastrando o Produto
Se você pretende utilizar a integração com Site de Membros do Hotmart, o primeiro Passo é
cadastrar o seu produto em nossa plataforma. Acesso o Hotmart, vá no menu “Produtos ->
Criar Novo Produto”.
Siga o fluxo de cadastro lendo atentamente as informações que vão sendo solicitadas.
Quando chegar no passo 3/3 você verá uma tela que apresentará a opção “Que tipo de
Produto será entregue?”, conforme mostra a imagem a seguir.
6
Note que você deverá marcar a segunda opção, ou seja, marque Acesso. Este é o tipo de
produto que define um Site de Membros no Hotmart. Depois de marcar a opção acesso, a
tela irá mudar e irá apresentar novas opções como mostra a imagem a seguir.
7
Configurações de Integração com
seu Site de Membros
Antes de iniciarmos a parte específica para configurações de sites de Membros, é
interessante darmos uma olhada em uma visão geral de como funciona a integração com
Sites de Membros do Hotmart. Para isto, veja a imagem a seguir:
Vamos analisar cada um destes passos:
1) Comprador visita o seu site: O comprador encontra o seu site na internet, através
de um anúncio ou divulgação que você ou um de seus afiliados fez.
2) Comprador clica no botão para comprar acesso ao seu Site de Membros: note
que este botão de compra contém o Hotlink de Pagamento Direto do seu produto. Isto
significa que você deve pegar seu link de Pagamento Direto para este produto dentro
do Hotmart e deve então apontar o seu botão de compra para ele em seu site. Se
você tem dúvidas sobre como obter o seu Hotlink de Pagamento Direto, veja o
Apêndice A deste manual.
8
3) Comprador faz pagamento para adesão ao seu Site de Membros: O Hotmart irá
processar este pagamento. Se for uma indicação de um afiliado, as comissões
também já serão distribuídas automaticamente entre Você e seu Afiliado. Após a
confirmação do pagamento, o produto será entregue conforme mostra o próximo
passo.
4) Hotmart envia um link e-mail contendo o link de cadastro para o seu site de
membros. Este link está associado a um código serial: este é o e-mail de entrega
do produto para o seu cliente. Seu cliente irá clicar no link contido no email, e irá cair
diretamente na página de Cadastro para se tornar um membro em seu site.
5) Comprador clica no link e vai para o seu site finalizar o cadastro. Seu site valida
o serial e autoriza o cadastro do membro: No URL desta página estarão os
parâmetros que você irá precisar para validar se este visitante é de fato um
comprador ou não. Esta validação será explicada mais adiante mais adiante na seção:
Validando o Cadastro do Membro.
Isto lhe dá uma visão geral de como é o fluxo do seu cliente. Com isto em mente, voltemos
as configurações de cadastro do seu Site de Membros.
A partir de agora você definir 3 coisas:
1) Onde fica a Página de Cadastro
Neste passo você irá informar o URL da página de cadastro do seu site, ou seja, a página
onde o comprador irá informar seus dados para se tornar membro.
Note que, quando o comprador acessar esta página através do link entregue a ele pelo
Hotmart, este link irá conter alguns parâmetros que podem ser usados por você até mesmo
para acelerar o cadastro do usuário.
Por exemplo, você receberá o parametro email (contendo o endereço de email usado na
compra) e o parâmetro name (contendo o Nome informado pelo comprador no momento da
compra). De posse destas duas informações, você poderia lê-las do Request e preencher
estes itens no seu formulário com um javascript.
9
2) Será utilizado Descadastro Automático?
(Opcional)
Há casos em que alguns compradores solicitam o reembolso referente a compra. Isto pode
acontecer por diversos motivos, sendo o mais comum a insatisfação do comprador com o
produto adquirido.
Nestas situações onde o Hotmart precisa processar o cancelamento da compra e o
reembolso do pagamento para o cliente, duas coisas acontecem:


Um email de alerta de reembolso é disparado: Tanto você quando seu afiliado
(caso a venda tenha sido feita por um afiliado) receberão um email alertando sobre o
reembolso e portanto sobre o congelamento das comissões daquela venda. Este
email contém os dados do Comprador que solicitou o reembolso, dessa forma você
pode bloquear o acesso deste comprador no seu site manualmente.
Um POST é feito em um endereço que você determinar, contendo as
informações do comprador que solicitou reembolso: Dessa forma você pode
implementar um código para receber este post e bloquear de forma automática o
comprador em seu sistema.
Para definir o URL de Descadastro, ou seja, o URL para onde o Hotmart irá enviar o POST,
preencha o campo indicado. (Vale lembrar que esta informação é opcional, e só precisa ser
preenchida caso haja interesse de se implementar o descadastro automático).
10
3) Gere os Códigos Seriais
Como você viu anteriormente, a solução do Hotmart para Sites de Membros funciona com
base em Códigos Seriais. Cada venda está associada a um Código Serial único, que fica
indisponível depois de ser adquirido por um comprador.
Portanto, vamos agora gerar um lote de códigos seriais.
No primeiro campo você irá definir um nome para o lote de seriais. Esta é uma informação
meramente descritiva.
No segundo campo você irá definir quantos seriais deseja gerar. Esta é uma informação
importante, pois ela é também o número máximo de vendas que você poderá fazer deste
produto. Quando os seriais se esgotarem, não será mais possível fazer vendas. No entanto,
você poderá voltar até esta tela e gerar novos seriais, antes mesmo que isto aconteça.
A última opção é um parâmetro extra (xparam), opcional, que será “anexado” a cada serial
gerado. Isto significa que quando o comprador chegar até o seu site para se cadastrar, este
valor que está sendo atribuído ao atributo xparam estará no Request juntamente com os
outros dados da venda. Dessa forma você pode usar o xparam para implementar controles
adicionais ou alternativos se preferir. Veremos mais sobre isto depois.
Uma vez que você preencheu estas informações, clique em “Gerar Seriais” e você verá algo
parecido com a tela a seguir.
11
A tela acima teve alguns pontos marcados com cores diferentes para destacar as
informações relevantes que vamos apresentar aqui. Portanto, acompanhe a legenda de
acordo com as cores.
Seriais Disponíveis: indica quantos seriais ainda estão livres para serem vendidos. Toda
vez que você acessar esta página, poderá ver se é necessário gerar mais seriais ou não.
Exportar Seriais (CSV): permite que você exporte todos os seriais em um arquivo CSV. Isto
será importante para que você faça a importação destes seriais em seu banco de dados
depois.
Código Serial: este é o serial propriamente dito, o código único que será associado a cada
venda e que servirá para identificar se um visitante é comprador confirmado ou não.
Endereço Completo: é o endereço final montado pelo Hotmart e que será entregue ao
comprador através do email enviado após a confirmação de pagamento.
xparam: é o parâmetro extra que pode ser adicionado opcionalmente por você para
controles próprios. Note que todos os códigos seriais possuem o mesmo xparam.
12
Ok, agora que todos os seriais estão gerados, basta você Salvar e Ir Para Preferências, para
fecharmos a última parte do cadastro.
Depois de clicar em Salvar e Ir para Preferências, chegou a hora definirmos os últimos
ajustes para o cadastro seu site de membros. Estes ajustes finais são relacionados à
Páginas envolvidas na venda do seu produto.
13
Definindo as Preferências da sua
Página de Vendas
A primeira coisa que devemos definir é se você irá utilizar uma Página gerada pelo Hotmart
para vender seu produto, ou se irá utilizar uma página própria, em seu site. Uma vez que
você está vendendo acesso ao seu site, é natural que a página de vendas fique em seu site.
Portanto, crie uma página no seu site onde ficarão as informações do seu produto (talvez
uma Carta de Vendas) para o comprador e o Botão Comprar para que o visitante inicie o
processo de pagamento pelo Hotmart.
É indispensável que o Botão Comprar aponte para o Hotlink de Pagamento Direto do seu
produto. (Se quiser mais informações sobre como obter o Hotlink de Pagamento Direto,
acesse o Apêndice A deste manual).
Na oção LOCAL DA PÁGINA DE VENDAS, marque “Página de vendas em Meu Site (fora
do Hotmart)”. Então informe o URL da sua Página de Vendas conforme indicado no campo.
14
Verifique se o endereço da Página de Vendas está correto e funcionando. É para este
endereço que os links de Afiliados irão apontar depois.
A próxima opção é definir uma Página de Obrigado. Você não precisa fazer isto, mas é
interessante que o faça, pois o visitante irá retornar ao seu site após a compra e irá cair
nesta página. Caso você não defina uma página de obrigado, ele será redirecionado para
uma página padrão do Hotmart.
Finalmente clique em Salvar Preferências.
Ok! Seu produto está cadastrado.
Agora vamos dar uma olhada em como implementar a integração com o Hotmart.
15
Integração com a Plataforma
Uma vez que seu produto já está devidamente cadastrado, e você já gerou pelo menos 1
lote de seriais para seu produto, é possível iniciar a integração.
Basicamente é possível implementar a integração de três formas diferentes.
A primeira delas é a Integração Manual. Esta é a mais simples de todas as formas, porém
como o nome já diz, ela exigirá um esforço operacional seu ou da sua equipe, a cada vez
que uma nova venda for realizada.
Outra forma é a chamada de Integração Fraca, pois apesar de sem muito simples de ser
implementada, ela oferece menos segurança.
A últiam delas é a Integração Forte. Esta integração exige um esforço de desenvolvimento
maior, porém é bastante segura com relação a aprovação automática do Cadastro de Novos
Membros.
Integração Manual
A integração manual funciona da seguinte forma. O seu formulário de cadastro de membros
fica disponível em seu site para que os membros se cadastrem. Todos os cadastros de
membros são por padrão iniciados como INATIVOS, ou seja, mesmo que alguém se
cadastre no formuário, esta pessoa precisa ser ATIVADA manualmente por você ou sua
equipe.
Neste caso, você entraria no Hotmart e verificaria se tal pessoa já um de seus clientes. Para
isto basta ir em “Vendas -> Meus Clientes”, ou verificar ela está listada no seu Histórico de
Vendas (“Vendas -> Histórico de Vendas”). Caso a pessoa já estiver com seu pagamento
confirmado, você poderia ativá-la em sua base para que ela pudesse acessar o seu
conteúdo.
16
Integração Fraca
A integração fraca pode ser feita através do parâmetro extra (xparam). Se você não está
lembrado do que é o xparam, volte na seção “Configurações de Integração com Seu Site de
Membros”.
Para implementar a integração Fraca, defina no xparam dos seus lotes um String que servirá
como uma Chave. Por exemplo, veja a imagem abaixo:
O xparam da imagem contém o valor “lote1_liberado_568932”.
Na Integração Fraca, o que pode ser feito é verificar na Página de Cadastro de membros, se
o parâmetro xparam=lote1_liberado_568932 está no request. Caso esteja no request, o
seu site libera o cadastro. Caso não esteja no request, o seu site redireciona o visitante para
outra página ou simplesmente impede que seu usuário seja gravado no banco de dados.
A Integração Fraca é utilizada por alguns produtores do Hotmart, no entanto, ela não é a
mais segura de toda, pois não garante que somente portadores de um serial único podem se
cadastrar em seu site. Muitas vezes, esta integração usada em conjunto com a Integração
Manual, para complementar o grau de segurança que não foi implementado.
17
Integração Forte
Se você tem a disposição alguém conhecimento bom técnico em programação a seu dispor,
então esta é a forma de integração mais indicada.
1º Passo: Importar o Lote de Seriais
Você deve exportar os seriais do seu produto em forma de arquivo CSV, e então importá-los
em seu banco de dados em uma tabela própria. Você pode modelar esta tabela da forma
que achar melhor, no entanto é importante que você tenha pelo menos duas colunas, uma
para guardar o Código Serial e outra para armazenar o Status daquele serial.
2º Passo: Implementar a Validação
Quando um novo usuário se registrar em sua página de cadatro, você irá ler o request
buscando pelos parâmetros que o validam como um comprador. O código serial estará
armazenado na variável hotkey. Os outros parâmetros que você irá receber são:

hotkey: código serial selecionado pelo Hotmart para este comprador. Esta é uma
chave única de 30 caracteres.
xparam: parâmetro extra (opcional), que pode ter sido informado por você durante a
geração dos códigos seriais.
email: email do comprador
name: nome do comprador



A estratégia de implementação é:
1)
2)
18
Recupere os parâmetros listados acima.
Tente obter no seu banco de dados, um serial DISPONÍVEL que seja idêntico a
hotkey recebida.
a. Caso encontre um serial válido e disponível igual a hotkey:
i. Registre o usuário como sendo um comprador ativo.
ii. Atualize o status do serial em seu banco de dados, e torne-o usado.
b. Caso contrário:
i. Não grave o usuário em seu banco, ou grave-o como inativo.
ii. Exiba uma mensagem de serial inválido. Vale a pena também indicar
a sua página de vendas, onde ele poderá adquirir um serial válido para
se cadastrar em seu site.
Integração de Descadastro Automático (opcional)
O Hotmart oferece a possibilidade de descadastro automático, para casos onde o comprador
peça o cancelamento da compra e consequentemente o reembolso do dinheiro.
Nestas situações é interessante que você bloqueie o acesso do usuário. Você poderá fazer
isto manualmente, pois irá receber um email notificando-o do reembolso, porém também é
possível automatizar este processo.
Sempre que o Hotmart processa um reembolso, ele pode enviar um POST para um URL
definido por vocês durante o cadastro do produto (URL de Descadastro, vide seção de
Configurações do Seu Site de Membros )
Os parâmetros enviados via POST para este URL de Descadastro são:





hottok: um token único, gerado pelo Hotmart para você produtor. Cada conta
possuirá o seu próprio token, e esta é a garantia que o post está sendo feito pelo
Hotmart.
hotkey: código serial selecionado pelo Hotmart para este comprador. Esta é uma
chave única de 30 caracteres.
xparam: parâmetro extra (opcional), que pode ter sido informado por você durante a
geração dos códigos seriais.
email: email do comprador
name: nome do comprador
O token (hottok) pode ser obtido em “Minha Conta -> Configurações Avançadas e API”.
19
A estratégia de implementação é:
1)
2)
3)
20
Ao receber o POST verifique se o hottok é de fato o seu hottok que está
associado a sua conta do Hotmart.
Em caso positivo, recupere o comprador através do email e bloquei-o em sua
base.
Mantenha o serial eliminado, ou se preferir atualize-o para o status “Reembolsado”.
Isto poderá lhe servir de estatísticas mais adiante.
Guia Rápido
Esta seção é destinada para aqueles usuários que já estão familiarizados com o Hotmart e
também possuem conhecimento de programação. É uma seção que contém os principais
aspectos da integração de forma sumarizada.
Passo a Passo rápido para Integração com Hotmart
1)
Cadastre seu produto selecionado no passo 3/3 a opção de tipo de produto
entregue como “Acesso” (ou site de membros).
a. Defina suas configurações de Sites de Membros e suas Preferências de
Página de Vendas
Gere os Códigos Seriais para seu produto
Importe os Códigos Seriais em seu banco de dados
Implemente a validação dos usuários que se cadastrarem em seu site, sempre
verificando se no request existe um serial válido de acordo com o seu banco de
dados.
a. Após cada cadastro bem sucedido, atualize o serial em sua base.
2)
3)
4)
Parâmetros Enviados pelo Hotmart





hotkey: código serial selecionado pelo Hotmart para este comprador. Esta é uma
chave única de 30 caracteres.
xparam: parâmetro extra (opcional), que pode ter sido informado por você durante a
geração dos códigos seriais.
email: email do comprador
name: nome do comprador
hottok: um token único, gerado pelo Hotmart para você produtor. Cada conta
possuirá o seu próprio token, e esta é a garantia que o post está sendo feito pelo
Hotmart. (este parâmetro é enviado apenas no Descadastro de usuários)
21
Informações enviadas por email pelo Hotmart


Quando algum comprador tiver sua venda confirmada:
o Email para o produtor (e afiliado, caso aplicável), avisando da venda e
quanto de comissão recebeu.
o Email para o comprador, contendo o link com o serial e outros parâmetros do
Hotmart, apontando para a página de cadastro do site de membros.
Quando algum comprador solicitar reembolso:
o Email para o Produtor (e afiliado, caso aplicável), avisando-o que o pedido
de reembolso do comprador foi processado.
o Email para o Comprador, avisando que seu reembolso foi processado e o
dinheiro já foi devolvido.
Apêndice A: Como obter seu Hotlink de Pagamento
Direto
Para conseguir o seu link de Pagamento Direto, vá em “Produtos -> Meus Produtos”. Na
listagem dos produtos, acesse o link “Hotlink e Ferramentas de Venda” que está relacionado
ao seu produto.
Você então irá visualizar o seu Hotlink de Página de Vendas, o seu Hotlink de Pagamento
Direto e o seu Hotlink de Recrutamento. Use o Hotlink de Pagamento Direto no seu botão
comprar do site.
22
Dúvidas?
Entre em contato com nosso suporte:
[email protected]
www.hotmart.com.br
23