Hotmart

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

  1. Faça login na sua conta do Hotmart e, no ícone de nove pontos na barra superior à direita clique em Ferramentas/Tools
  2. Na página de ferramentas, (1) selecione "Para Produtor", pesquise por "credenciais" e (2) selecione a opção "Credenciais Hotmart"
    1. 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
  3. Na página de credenciais clique em "Criar credencial"
  4. 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"
  5. 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)
  6. Faça login na Kondado > clique em CRIAR + > Conector > Hotmart
  7. 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

subscriber_code

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

subscriber_ucode

text

[pt] Mostra a identificacao externa do assinante. E o que você vai usar em seu sistema para identificar seu produto

subscriber_name

text

[pt] Mostra o nome do assinante

subscriber_email

text

[pt] Mostra o email do assinante

status

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

trial

boolean

[pt] Indica se assinatura tem ou teve um periodo de teste. O valor 'true' significa que sim, 'false' que nao

product_ucode

text

[pt] Identificacao externa de um produto. E o que você vai usar em seu sistema para identificar seu produto

product_id

text

[pt] ID do produto

    Produtos > > id

product__name

text

[pt] Nome do produto

request_date

timestamp

[pt] data da criacao da assinatura

accession_date

timestamp

[pt] data inicial de liberacao para acesso ao conteudo da assinatura

plan_name

text

[pt] nome do plano de assinatura

subscription_id

text

[pt] identificacao da assinatura na Hotmart

price_currencycode

text

[pt] identificacao da assinatura na Hotmart

price_value

float

[pt] Preco de cada recorrencia da assinatura

Comissões das vendas

Campo Tipo

transaction

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.

    Histórico das vendas > > purchase_transaction

product_id

text

[pt] Identificador unico (ID) do produto vendido (numero de 7 digitos)

    Produtos > > id

product_name

text

[pt] Nome do produto

exchange_rate_currency_payout

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

source

text

[pt] Indica qual a fonte da comissao, podendo ser um dos seguintes valores: PRODUCER, COPRODUCER, AFFILIATE ou ADDON

user_name

text

[pt] Nome do participante da comissao

user_ucode

text

[pt] Identificador unico do participante da comissao

commission_currency_code

text

[pt] Moeda utilizada para comissionamento, no padrao internacional de tres letras. Por exemplo: BRL, USD, EUR, MXN e mais

commission_value

float

[pt] Valor da comissao

Compras de assinantes

Campo Tipo

subscriber_code

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

    Assinantes > > subscriber_code

transaction

text

[pt] Codigo de referencia da transacao

    Histórico das vendas > > purchase_transaction

payment_engine

text

[pt] Plataforma de pagamento. Por exemplo, se foi feito usando HotPay ou HotPay Internacional

payment_method

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

payment_type

text

[pt] Tipo de pagamento, que sao: BILLET, CREDIT_CARD, PAYPAL, BANK_DEBT, HOTMART_BALANCE, CASH_PAYMENT, SAMSUNG_PAY e GOOGLE_PAY

price_currency_code

text

[pt] Qual moeda foi usada, no padrão internacional de três letras. Por exemplo: BRL, USD, EUR, MXN, etc...

price_value

float

[pt] Valor da transacao

recurrency_number

float

[pt] Mostra o numero da recorrencia correspondente

status

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

under_warranty

boolean

[pt] Se a transacao esta dentro do prazo de garantia

Detalhamento de preços de vendas

Campo Tipo

transaction

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.

    Histórico das vendas > > purchase_transaction

product_id

text

[pt] Identificador unico (ID) do produto vendido (numero de 7 digitos)

    Produtos > > id

product_name

text

[pt] Nome do produto

real_conversion_rate

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

total_currency_code

text

[pt] Moeda referente ao valor total, no padrao internacional de tres letras. Por exemplo: BRL, USD, EUR, MXN e mais

total_value

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

fee_currency_code

text

[pt] Moeda referente aos juros, no padrao internacional de tres letras. Por exemplo: BRL, USD, EUR, MXN e mais

fee_value

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

vat_currency_code

text

[pt] Moeda referente ao VAT, no padrao internacional de tres letras. Por exemplo: BRL, USD, EUR, MXN e mais

vat_value

float

[pt] VAT (Value Added Tax) representa o imposto sobre o valor agregado do produto

base_currency_code

text

[pt] Moeda referente ao valor base, no padrao internacional de tres letras. Por exemplo: BRL, USD, EUR, MXN e mais

base_value

float

[pt] Utilizado para a divisao de comissionamento entre produtores, afiliados e coprodutores. Alem disso, e dele retirado as taxas dos addons

coupon_code

text

[pt] Codigo identificador de um cupom

coupon_value

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

purchase_transaction

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.

purchase_approved_date

timestamp

[pt] Data em que o pedido foi aprovado

purchase_commission_as

text

purchase_hotmart_fee_base

float

[pt] Valor base utilizado para a cobranca da taxa da Hotmart

purchase_hotmart_fee_total

float

[pt] Taxa total cobrada pela Hotmart sobre a transacao

purchase_hotmart_fee_currency_code

text

[pt] Moeda referente aos valores das tarifas, no padrao internacional de tres letras. Por exemplo: BRL, USD, EUR, MXN e mais

purchase_hotmart_fee_fixed

float

[pt] Taxa fixa cobrada pelo Hotmart sobre toda transacao

purchase_is_subscription

boolean

purchase_offer_code

text

[pt] Codigo identificador da oferta

purchase_offer_payment_mode

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

purchase_order_date

timestamp

[pt] Data em que o pedido foi realizado

purchase_payment_method

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

purchase_payment_type

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

purchase_payment_installments_number

float

[pt] Número total de parcelas, no caso de uma compra parcelada em BRL, MXN ou COP

purchase_price_currency_code

text

[pt] Moeda referente ao valor base, no padrao internacional de tres letras. Por exemplo: BRL, USD, EUR, MXN e mais

purchase_price_value

float

[pt] Valor total pago pelo comprador, incluindo taxas e juros

purchase_recurrency_number

float

[pt] Numero da recorrencia correspondente para compras parceledas no cartao ou via Parcelamento Inteligente.

purchase_status

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

purchase_tracking_source_sck

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

purchase_tracking_source

text

[pt] Codigo de rastreamento referente ao campo src que o vendedor cadastra pra saber a origem da venda

purchase_tracking_external_code

text

[pt] Codigo de rastreamento referente ao campo xcod passado como parametro na URL da pagina de checkout

purchase_warranty_expire_date

timestamp

[pt] Data de vencimento da garantia. o periodo no qual o comprador pode solicitar o reembolso do pedido.

buyer_name

text

[pt] Nome do comprador

buyer_ucode

text

[pt] Identificador nico do comprador

buyer_email

text

[pt] E-mail da pessoa compradora. Você pode utilizar este dado para buscar compras de pessoas específicas

producer_name

text

[pt] Nome do produtor

producer_ucode

text

[pt] Identificador unico do produtor

product_id

text

[pt] Identificador unico (ID) do produto vendido

    Produtos > > id

product_name

text

[pt] Nome do produto

Hotmart Club: alunos

Campo Tipo

user_id

text

[pt] Identificador único do aluno no Club.

subdomain

text

[pt] Nome do subdomínio.

access_count

int

[pt] Número de acessos realizados na Área de Membros.

class_id

text

[pt] Identificador da turma em que o aluno está associado.

is_deletable

boolean

[pt] Indica se o aluno poderá ou não ser bloqueado. O valor true significa que sim, false que não.

progress_completed_percentage

float

[pt] Indica o percentual de páginas concluídas.

progress_completed

float

[pt] Indica número de páginas concluídas.

progress_total

float

[pt] Número total de páginas da Área de Membros.

engagement

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 é

locale

text

[pt] Idioma no qual o usuário realizou a compra, ou idioma que foi utilizado para importar o usuário.

first_access_date

timestamp

[pt] Data do primeiro acesso do aluno à Área de Membros, representada como timestamp em milissegundos.

purchase_date

timestamp

[pt] Data da compra do curso pelo aluno, representada como timestamp em milissegundos.

last_access_date

timestamp

[pt] Data do último acesso do aluno à Área de Membros, representada como timestamp em milissegundos.

email

text

[pt] Endereço de e-mail do aluno.

name

text

[pt] Nome completo do aluno.

role

text

[pt] Função do aluno na plataforma (ex: ALUNO, MODERATOR).

status

text

[pt] Status atual do aluno na Área de Membros.

plus_access

text

[pt] Indica se o aluno possui acesso Plus na plataforma.

type

text

[pt] Tipo do aluno no sistema (ex: IMPORTADO, CADASTRADO).

Hotmart Club: módulos

Campo Tipo

module_id

text

[pt] Identificador único do módulo.

subdomain

text

[pt] Nome do subdomínio.

name

text

[pt] Nome do módulo definido pelo produtor dentro do Club.

sequence

int

[pt] Ordenação sequencial em que o módulo será exibido para os alunos.

is_public

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.

is_extra

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.

is_extra_paid

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.

classes

text

[pt] Mostra as aulas do módulo.

total_pages

int

[pt] Indica a quantidade total de páginas relacionadas ao módulo.

Hotmart Club: progresso dos alunos

Campo Tipo

student_id

text

[pt] Identificador único do aluno no Club.

    Hotmart Club: alunos > > user_id

page_id

text

[pt] Identificador único da página.

    Hotmart Club: páginas > > page_id

subdomain

text

[pt] Nome do subdomínio.

student_email

text

[pt] Email do aluno no Club.

page_name

text

[pt] Nome da página definida pelo produtor dentro do Club.

is_module_extra

boolean

[pt] Indica se é um módulo extra. O valor true significa que sim, false que não.

is_completed

boolean

[pt] Indica se a página já foi concluída pelo aluno. O valor true significa que sim, false que não.

module_name

text

[pt] Nome do módulo definido pelo produtor no Club.

completed_date

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

page_id

text

[pt] Identificador único da página.

subdomain

text

[pt] Nome do subdomínio.

product_id

text

[pt] Nome do subdomínio.

    Produtos > > id

module_id

text

[pt] Identificador único do módulo.

    Hotmart Club: módulos > > module_id

name

text

[pt] Nome da página definida pelo produtor dentro do Club.

type

text

[pt] Mostra o tipo da página. Estes tipos podem ser.

page_order

text

[pt] Ordenação sequencial da página dentro do módulo.

total_comments

int

[pt] Ordenação sequencial da página dentro do módulo.

rates_average

float

[pt] Média de avaliações dos usuários na página.

published

boolean

[pt] Indica se a página está publicada para os usuários. O valor true significa que sim, false que não.

has_media

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

page_id

text

[pt] Identificador único da página.

subdomain

text

[pt] Nome do subdomínio.

product_id

text

[pt] Nome do subdomínio.

    Produtos > > id

rates_rate

text

[pt] Nota atribuída à página em uma avaliação individual.

rates_total

text

[pt] Quantidade de usuários que atribuíram uma determinada nota à página.

hotmart_members_area_pages_dripping_configs

Campo Tipo

page_id

text

[pt] Identificador único da página.

subdomain

text

[pt] Nome do subdomínio.

product_id

text

[pt] Nome do subdomínio.

    Produtos > > id

_dripping_configs_type

text

[pt] Identificador único da página.

_dripping_configs_liberation_date

timestamp

[pt] Data de liberação

_dripping_configs_id

text

[pt] Identificador da classe.

_dripping_configs_name

text

[pt] Nome da classe.

_dripping_configs_default_class

boolean

[pt] Indica se é a classe padrão (true) ou não (false).

Produtos

Campo Tipo

id

text

[pt] Identificador único do módulo.

ucode

text

[pt] Um identificador único global (UUID) associado ao produto, usado para identificação em diferentes contextos ou integrações.

created_at

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).

name

text

[pt] Nome do produto conforme definido pelo usuário, neste caso, 'Palestra teste'.

status

text

[pt] Similar a situation, indica que o produto está em DRAFT (Rascunho) ou APPROVE_PRODUCT (Aprovado para publicação).

format

text

[pt] Formato do produto (ex ONLINE_COURSE, EBOOK, EVENT, ONLINE_EVENT)

is_subscription

boolean

[pt] Indica se o produto é uma assinatura

warranty_period

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

  1. Na barra lateral, selecione Produtos > Área de membros
  2. Selecione o Club que deseja utilizar
  3. Uma vez no Club, na barra esquerda, selecione Produtos e acesse o produto que deseja integrar
  4. No seu produto, selecione a opção de Configurações
  5. Na página de configurações do produto do club, role até o final e você encontrará seu subdomínio. Copie-o