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) Recupere os parâmetros listados acima. 2) 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. 18
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) Ao receber o POST verifique se o hottok é de fato o seu hottok que está associado a sua conta do Hotmart. 2) Em caso positivo, recupere o comprador através do email e bloquei-o em sua base. 3) Mantenha o serial eliminado, ou se preferir atualize-o para o status Reembolsado. Isto poderá lhe servir de estatísticas mais adiante. 20
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 2) Gere os Códigos Seriais para seu produto 3) Importe os Códigos Seriais em seu banco de dados 4) 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. 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: suporte@hotmart.com.br www.hotmart.com.br 23