Adicionando o conector
Requisitos
- Siga os passos abaixos com o usuário "master"/principal da conta, já que outros colaboradodes podem não ter as permissões necessárias
Instruções
- Faça login na sua conta do Hotmart e, no ícone de nove pontos na barra superior à direita clique em Ferramentas/Tools
- Na página de ferramentas, (1) selecione "Para Produtor", pesquise por "credenciais" e (2) selecione a opção "Credenciais Hotmart"
- Caso não consiga localizar a opção de credenciais, você pode acessá-las diretamente por este link: https://app.hotmart.com/tools/credentials - caso este link não esteja acessível, você não possui as permissões necessárias e deve utilizar o usuário master/principal para este passo a passo, conforme instruções anteriores
- Na página de credenciais clique em "Criar credencial"
- No popup que irá abrir, marque a opção "API Hotmart", dê um nome para sua credencial (por exemplo "kondado") e clique em "Criar credencial"
- Após clicar em "Criar credencial", você verá os dados dela. Bastará copiar, sem espaço, os valores exibidos para cada parâmetro (sem incluir os títulos "Client ID: ", "Client Secret: " ou o primeiro "Basic: " - o segundo "Basic" faz parte do parâmetro como pode ser visto na imagem)
- Faça login na Kondado > clique em CRIAR + > Conector > Hotmart
- Na página de adição do conector da Hotmart, preencha as informações com os valores obtidos no passo (5) conforme a figura abaixo:
Integrações
Índice
Gráfico de relacionamento
Clique para ampliar
Assinantes
Campo | Tipo | |
---|---|---|
text |
[pt] Traz o codigo daquele assinante. Este campo e usado pelo sistema externo para identificar um assinante de uma assinatura. Um mesmo comprador tera 2 subscribersCode diferentes se ele assinar dois produtos diferentes |
|
text |
[pt] Mostra a identificacao externa do assinante. E o que você vai usar em seu sistema para identificar seu produto |
|
text |
[pt] Mostra o nome do assinante |
|
text |
[pt] Mostra o email do assinante |
|
text |
[pt] Mostra os status do momento em que aquela assinatura se encontra. Estes status podem ser: ACTIVE, INACTIVE, DELAYED, CANCELLED_BY_CUSTOMER, CANCELLED_BY_SELLER, CANCELLED_BY_ADMIN, STARTED ou OVERDUE |
|
boolean |
[pt] Indica se assinatura tem ou teve um periodo de teste. O valor 'true' significa que sim, 'false' que nao |
|
text |
[pt] Identificacao externa de um produto. E o que você vai usar em seu sistema para identificar seu produto |
|
text |
[pt] ID do produto |
|
text |
[pt] Nome do produto |
|
timestamp |
[pt] data da criacao da assinatura |
|
timestamp |
[pt] data inicial de liberacao para acesso ao conteudo da assinatura |
|
text |
[pt] nome do plano de assinatura |
|
text |
[pt] identificacao da assinatura na Hotmart |
|
text |
[pt] identificacao da assinatura na Hotmart |
|
float |
[pt] Preco de cada recorrencia da assinatura |
Comissões das vendas
Campo | Tipo | |
---|---|---|
text |
[pt] Mostra o codigo unico de referencia para um transacao, por exemplo HP17715690036014. Uma transacao acontece quando um pedido e efetuado. Um pedido pode ser um boleto gerado, uma compra aprovada, uma recorrencia de compra e mais. |
|
text |
[pt] Identificador unico (ID) do produto vendido (numero de 7 digitos) |
|
text |
[pt] Nome do produto |
|
float |
[pt] Taxa de conversao utilizada para converter o valor de compra sem impostos no valor bruto da comissao (ainda sem divisao entre as partes envolvidas) em sua respectiva moeda. Quando nao acontece conversao, o valor retornado nesse campo e 1 |
|
text |
[pt] Indica qual a fonte da comissao, podendo ser um dos seguintes valores: PRODUCER, COPRODUCER, AFFILIATE ou ADDON |
|
text |
[pt] Nome do participante da comissao |
|
text |
[pt] Identificador unico do participante da comissao |
|
text |
[pt] Moeda utilizada para comissionamento, no padrao internacional de tres letras. Por exemplo: BRL, USD, EUR, MXN e mais |
|
float |
[pt] Valor da comissao |
Compras de assinantes
Campo | Tipo | |
---|---|---|
text |
[pt] Traz o codigo daquele assinante. Este campo e usado pelo sistema externo para identificar um assinante de uma assinatura. Um mesmo comprador tera 2 subscribersCode diferentes se ele assinar dois produtos diferentes |
|
text |
[pt] Codigo de referencia da transacao |
|
text |
[pt] Plataforma de pagamento. Por exemplo, se foi feito usando HotPay ou HotPay Internacional |
|
text |
[pt] Mostra o metodo de pagamento, que pode ser: BILLET, PAYPAL, BANCO_BRASIL_ONLINE_TRANSFER, BRADESCO_ONLINE_TRANSFER, ITAU_ONLINE_TRANSFER, VISA_CREDIT_CARD, MASTERCARD_CREDIT_CARD, AMERICAN_EXPRESS_CREDIT_CARD, AURA_CREDIT_CARD, DINERS_CREDIT_CARD, HIPERCARD_CREDIT_CARD, ELO_CREDIT_CARD, HOTMART, BANK_DEBT, DISCOVER_CREDIT_CARD, SEPA_DIRECT_DEBT ou MULTIBANK |
|
text |
[pt] Tipo de pagamento, que sao: BILLET, CREDIT_CARD, PAYPAL, BANK_DEBT, HOTMART_BALANCE, CASH_PAYMENT, SAMSUNG_PAY e GOOGLE_PAY |
|
text |
[pt] Qual moeda foi usada, no padrão internacional de três letras. Por exemplo: BRL, USD, EUR, MXN, etc... |
|
float |
[pt] Valor da transacao |
|
float |
[pt] Mostra o numero da recorrencia correspondente |
|
text |
[pt] Status de compra, que pode ser: STARTED, PROCESSING_TRANSACTION, COMPLETE, PRINTED_BILLET, WAITING_PAYMENT, APPROVED, UNDER_ANALISYS, CANCELLED, PROTESTED, REFUNDED, CHARGEBACK, BLOCKED, OVERDUE, PRE_ORDER, NO_FUNDS ou EXPIRED |
|
boolean |
[pt] Se a transacao esta dentro do prazo de garantia |
Detalhamento de preços de vendas
Campo | Tipo | |
---|---|---|
text |
[pt] Mostra o codigo unico de referencia para um transacao, por exemplo HP17715690036014. Uma transacao acontece quando um pedido e efetuado. Um pedido pode ser um boleto gerado, uma compra aprovada, uma recorrencia de compra e mais. |
|
text |
[pt] Identificador unico (ID) do produto vendido (numero de 7 digitos) |
|
text |
[pt] Nome do produto |
|
float |
[pt] Taxa de conversao utilizada para converter o valor original da oferta no valor a ser pago pela pessoa compradora em sua moeda local |
|
text |
[pt] Moeda referente ao valor total, no padrao internacional de tres letras. Por exemplo: BRL, USD, EUR, MXN e mais |
|
float |
[pt] Composicao dos valores base, VAT e juros. O valor vat somente sera cobrado caso a venda seja realizada em territorio europeu e mexicano |
|
text |
[pt] Moeda referente aos juros, no padrao internacional de tres letras. Por exemplo: BRL, USD, EUR, MXN e mais |
|
float |
[pt] Valor de juros que sera cobrado em uma compra parcelada em BRL ou MXN. Este valor pode ser pago pelo produtor ou pelo comprador, dependendo da configuracao de venda do produto |
|
text |
[pt] Moeda referente ao VAT, no padrao internacional de tres letras. Por exemplo: BRL, USD, EUR, MXN e mais |
|
float |
[pt] VAT (Value Added Tax) representa o imposto sobre o valor agregado do produto |
|
text |
[pt] Moeda referente ao valor base, no padrao internacional de tres letras. Por exemplo: BRL, USD, EUR, MXN e mais |
|
float |
[pt] Utilizado para a divisao de comissionamento entre produtores, afiliados e coprodutores. Alem disso, e dele retirado as taxas dos addons |
|
text |
[pt] Codigo identificador de um cupom |
|
float |
[pt] Caso tenha sido aplicado cupom de desconto, representa a porcentagem de desconto do cupom aplicado sobre o valor do produto. Seu valor esta entre 0 e 1 |
Histórico das vendas
Campo | Tipo | |
---|---|---|
text |
[pt] Mostra o codigo unico de referencia para um transacao, por exemplo HP17715690036014. Uma transacao acontece quando um pedido e efetuado. Um pedido pode ser um boleto gerado, uma compra aprovada, uma recorrencia de compra e mais. |
|
timestamp |
[pt] Data em que o pedido foi aprovado |
|
text |
||
float |
[pt] Valor base utilizado para a cobranca da taxa da Hotmart |
|
float |
[pt] Taxa total cobrada pela Hotmart sobre a transacao |
|
text |
[pt] Moeda referente aos valores das tarifas, no padrao internacional de tres letras. Por exemplo: BRL, USD, EUR, MXN e mais |
|
float |
[pt] Taxa fixa cobrada pelo Hotmart sobre toda transacao |
|
boolean |
||
text |
[pt] Codigo identificador da oferta |
|
text |
[pt] Modo de pagamento. Os valores possiveis para este campo sao: UNIQUE_PAYMENT, SUBSCRITPION, MULTIPLE_PAYMENTS, PAY_IN_FULL, NOT_DEFINED, INVOICE, SMART_INSTALLMENT |
|
timestamp |
[pt] Data em que o pedido foi realizado |
|
text |
[pt] Metodo de pagamento da compra. Os valores possiveis para este campo sao: BILLET, PAYPAL, BANK_TRANSFER_BB, BANK_TRANSFER_BRADESCO, BANK_TRANSFER_ITAU, CREDIT_CARD, CREDIT_CARD_MASTERCARD, CREDIT_CARD_AMERICAN_EXPRESS, CREDIT_CARD_AURA, CREDIT_CARD_DINERS, CREDIT_CARD_HIPERCARD, CREDIT_CARD_ELO, HOTMART, BANK_DEBIT, CREDIT_CARD_DISCOVER, SEPA_DIRECT_DEBIT, MULTIBANCO, GOOGLE_PAY, BALOTO, OXXO, CUPON_DE_PAGO, SAMSUNG_PAY, PAGO_EFECTIVO, BACS_DIRECT_DEBIT, PICPAY, FINANCED_INSTALLMENT_ADYEN_ONEY, DIRECT_BANK_TRANSFER_ADYEN_SOFORT, FINANCED_INSTALLMENT_ADYEN_ONEY_3X, FINANCED_INSTALLMENT_ADYEN_ONEY_4X, FINANCED_INSTALLMENT_ADYEN_ONEY_6X, FINANCED_INSTALLMENT_ADYEN_ONEY_10X, FINANCED_INSTALLMENT_ADYEN_ONEY_12X, PIX |
|
text |
[pt] Tipo de pagamento da compra, que pode ser: BILLET, CREDIT_CARD, PAYPAL, BANK_DEBT, HOTMART_BALANCE, CASH_PAYMENT, PIX, SAMSUNG_PAY ou GOOGLE_PAY |
|
float |
[pt] Número total de parcelas, no caso de uma compra parcelada em BRL, MXN ou COP |
|
text |
[pt] Moeda referente ao valor base, no padrao internacional de tres letras. Por exemplo: BRL, USD, EUR, MXN e mais |
|
float |
[pt] Valor total pago pelo comprador, incluindo taxas e juros |
|
float |
[pt] Numero da recorrencia correspondente para compras parceledas no cartao ou via Parcelamento Inteligente. |
|
text |
[pt] Mostra o status de compra, que pode ser: STARTED , PROCESSING_TRANSACTION , COMPLETE , PRINTED_BILLET , WAITING_PAYMENT , APPROVED , UNDER_ANALISYS , CANCELLED , PROTESTED , REFUNDED , CHARGEBACK , BLOCKED , OVERDUE , PRE_ORDER , NO_FUNDS ou EXPIRED. A descricao de cada status pode ser encontrado na pagina do suporte do Hotmart |
|
text |
[pt] Codigo de rastreamento que o produtor cadastra pra saber a origem da venda. Esse codigo e exclusivo do produtor e funciona para identificar uma pagina de checkout |
|
text |
[pt] Codigo de rastreamento referente ao campo src que o vendedor cadastra pra saber a origem da venda |
|
text |
[pt] Codigo de rastreamento referente ao campo xcod passado como parametro na URL da pagina de checkout |
|
timestamp |
[pt] Data de vencimento da garantia. o periodo no qual o comprador pode solicitar o reembolso do pedido. |
|
text |
[pt] Nome do comprador |
|
text |
[pt] Identificador nico do comprador |
|
text |
[pt] E-mail da pessoa compradora. Você pode utilizar este dado para buscar compras de pessoas específicas |
|
text |
[pt] Nome do produtor |
|
text |
[pt] Identificador unico do produtor |
|
text |
[pt] Identificador unico (ID) do produto vendido |
|
text |
[pt] Nome do produto |
Hotmart Club: alunos
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do aluno no Club. |
|
text |
[pt] Nome do subdomínio. |
|
int |
[pt] Número de acessos realizados na Área de Membros. |
|
text |
[pt] Identificador da turma em que o aluno está associado. |
|
boolean |
[pt] Indica se o aluno poderá ou não ser bloqueado. O valor true significa que sim, false que não. |
|
float |
[pt] Indica o percentual de páginas concluídas. |
|
float |
[pt] Indica número de páginas concluídas. |
|
float |
[pt] Número total de páginas da Área de Membros. |
|
text |
[pt] Engajamento do aluno dentro do curso. O engajamento é um índice que mede o quanto os seus usuários estão interagindo de forma geral com o seu produto. Cada usuário tem os seus pontos que determinam se o engajamento dele é |
|
text |
[pt] Idioma no qual o usuário realizou a compra, ou idioma que foi utilizado para importar o usuário. |
|
timestamp |
[pt] Data do primeiro acesso do aluno à Área de Membros, representada como timestamp em milissegundos. |
|
timestamp |
[pt] Data da compra do curso pelo aluno, representada como timestamp em milissegundos. |
|
timestamp |
[pt] Data do último acesso do aluno à Área de Membros, representada como timestamp em milissegundos. |
|
text |
[pt] Endereço de e-mail do aluno. |
|
text |
[pt] Nome completo do aluno. |
|
text |
[pt] Função do aluno na plataforma (ex: ALUNO, MODERATOR). |
|
text |
[pt] Status atual do aluno na Área de Membros. |
|
text |
[pt] Indica se o aluno possui acesso Plus na plataforma. |
|
text |
[pt] Tipo do aluno no sistema (ex: IMPORTADO, CADASTRADO). |
Hotmart Club: módulos
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do módulo. |
|
text |
[pt] Nome do subdomínio. |
|
text |
[pt] Nome do módulo definido pelo produtor dentro do Club. |
|
int |
[pt] Ordenação sequencial em que o módulo será exibido para os alunos. |
|
boolean |
[pt] Indica se o módulo é gratuito. Módulos gratuitos são disponibilizados para pessoas que ainda não compraram o seu curso. O valor true significa é gratuito, false que não. |
|
boolean |
[pt] Indica se o módulo é extra. Módulos extras são módulos com conteúdos adicionais que podem ser oferecidos para os alunos, os módulos extra podem ser gratuitos ou podem ser cobrado dos usuários que desejam ter acesso ao conteúdo adicional. O valor true significa que é um módulo extra, false que não. |
|
boolean |
[pt] Indica se o módulo extra é um módulo pago ou se é um módulo gratuito. O valor true significa que é pago, false que é gratuito. |
|
text |
[pt] Mostra as aulas do módulo. |
|
int |
[pt] Indica a quantidade total de páginas relacionadas ao módulo. |
Hotmart Club: progresso dos alunos
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do aluno no Club. |
|
text |
[pt] Identificador único da página. |
|
text |
[pt] Nome do subdomínio. |
|
text |
[pt] Email do aluno no Club. |
|
text |
[pt] Nome da página definida pelo produtor dentro do Club. |
|
boolean |
[pt] Indica se é um módulo extra. O valor true significa que sim, false que não. |
|
boolean |
[pt] Indica se a página já foi concluída pelo aluno. O valor true significa que sim, false que não. |
|
text |
[pt] Nome do módulo definido pelo produtor no Club. |
|
timestamp |
[pt] Data em que a página foi concluída. Esse valor só será retornado caso o parâmetro is_completed seja true. |
Hotmart Club: páginas
Objeto principal
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único da página. |
|
text |
[pt] Nome do subdomínio. |
|
text |
[pt] Nome do subdomínio. |
|
text |
[pt] Identificador único do módulo. |
|
text |
[pt] Nome da página definida pelo produtor dentro do Club. |
|
text |
[pt] Mostra o tipo da página. Estes tipos podem ser. |
|
text |
[pt] Ordenação sequencial da página dentro do módulo. |
|
int |
[pt] Ordenação sequencial da página dentro do módulo. |
|
float |
[pt] Média de avaliações dos usuários na página. |
|
boolean |
[pt] Indica se a página está publicada para os usuários. O valor true significa que sim, false que não. |
|
boolean |
[pt] Indica se a página está publicada para os usuários. O valor true significa que sim, false que não. |
hotmart_members_area_pages_rates
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único da página. |
|
text |
[pt] Nome do subdomínio. |
|
text |
[pt] Nome do subdomínio. |
|
text |
[pt] Nota atribuída à página em uma avaliação individual. |
|
text |
[pt] Quantidade de usuários que atribuíram uma determinada nota à página. |
hotmart_members_area_pages_dripping_configs
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único da página. |
|
text |
[pt] Nome do subdomínio. |
|
text |
[pt] Nome do subdomínio. |
|
text |
[pt] Identificador único da página. |
|
timestamp |
[pt] Data de liberação |
|
text |
[pt] Identificador da classe. |
|
text |
[pt] Nome da classe. |
|
boolean |
[pt] Indica se é a classe padrão (true) ou não (false). |
Produtos
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do módulo. |
|
text |
[pt] Um identificador único global (UUID) associado ao produto, usado para identificação em diferentes contextos ou integrações. |
|
timestamp |
[pt] Data e hora em que o produto foi criado na plataforma, representado como um timestamp em milissegundos desde o início da era Unix (01/01/1970). |
|
text |
[pt] Nome do produto conforme definido pelo usuário, neste caso, 'Palestra teste'. |
|
text |
[pt] Similar a situation, indica que o produto está em DRAFT (Rascunho) ou APPROVE_PRODUCT (Aprovado para publicação). |
|
text |
[pt] Formato do produto (ex ONLINE_COURSE, EBOOK, EVENT, ONLINE_EVENT) |
|
boolean |
[pt] Indica se o produto é uma assinatura |
|
int |
[pt] Garantia do produto |
Notas
Subdomínio do Club
Para obter o subdomínio de um club, siga os passos abaixo. Lembre-se que você pode incluir vários clubes em uma mesma integração ao separar os subdomínios por vírgula
- Na barra lateral, selecione Produtos > Área de membros
- Selecione o Club que deseja utilizar
- Uma vez no Club, na barra esquerda, selecione Produtos e acesse o produto que deseja integrar
- No seu produto, selecione a opção de Configurações
- Na página de configurações do produto do club, role até o final e você encontrará seu subdomínio. Copie-o