--- title: Hotmart slug: hotmart docTags: createdAt: 2026-03-10T20:16:59.262Z --- ## Objetivo Integração com a API da Hotmart para consulta de produtos e participantes de vendas (clientes). Permite listar produtos do catálogo do creator, filtrar por status e formato, além de consultar informações detalhadas sobre compradores, afiliados e produtores envolvidos nas vendas. *** ## Criando um fluxo Acesse **Fluxos** na plataforma Fluid, clique em **Criar Fluxo** e selecione o conector **Hotmart**. Nomeie o fluxo e clique em **Avançar**. *** ## Criando conexão Para autenticar com a API da Hotmart, você precisará das credenciais obtidas no painel da Hotmart (Ferramentas > Credenciais Hotmart). | Campo | Obrigatório | Descrição | | ---------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------- | | **ID do Cliente** | Sim | Client ID fornecido pela Hotmart nas credenciais da API. | | **Chave Secreta do Cliente** | Sim | Client Secret fornecido pela Hotmart nas credenciais da API. | | **Token Basic** | Sim | Token Basic fornecido pela Hotmart nas credenciais da API. Enviado no header Authorization para obter o access\_token. | :::hint{type="info"} Como obter as credenciais: - Faça login na sua conta Hotmart. - No menu lateral, acesse Ferramentas > Mostrar todas. - Clique em Credenciais Hotmart. - Clique em Criar credencial, selecione API Hotmart e clique em Criar credencial. - Copie os valores de Client ID, Client Secret e Basic exibidos. ::: *** ## Configurando fluxo Escolha um dos recursos disponíveis e selecione a operação desejada. Cada operação exige parâmetros específicos. Abaixo, listamos os recursos disponíveis. *** ## Recursos e Operações ### Recurso: Produto ### Listar Produtos Retorna informações dos produtos do creator, como identificador único, nome, status, data de criação, formato, indicação de assinatura e período de garantia. ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/cQTDJAYKWlUtHPEa-7hgu_image-6.png) | Campo | Obrigatório | Tipo | Descrição | | ------------------------------------- | ----------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Número máximo de itens por página** | Não | string | O número máximo de itens por página que podem ser retornados. O valor padrão é 50. | | **Token de paginação** | Não | string | Cursor usado na paginação. Utilize o valor de `next_page_token` ou `prev_page_token` retornado na resposta anterior. | | **ID do Produto** | Não | string | Identificador único (ID) do produto (número de 7 dígitos). | | **Status do Produto** | Não | string | A situação do produto. Valores possíveis: `DRAFT`, `ACTIVE`, `PAUSED`, `NOT_APPROVED`, `IN_REVIEW`, `DELETED`, `CHANGES_PENDING_ON_PRODUCT`. | | **Formato do Produto** | Não | string | O formato do produto criado. Valores possíveis: `EBOOK`, `SOFTWARE`, `MOBILE_APPS`, `VIDEOS`, `AUDIOS`, `TEMPLATES`, `IMAGES`, `ONLINE_COURSE`, `SERIAL_CODES`, `ETICKET`, `ONLINE_SERVICE`, `ONLINE_EVENT`, `BUNDLE`, `COMMUNITY`, `AGENT`. | *** ### Recurso: Clientes ### Listar Participantes de Vendas Exibe informações sobre os participantes das vendas. O participante pode ser o comprador, produtor, afiliado ou co-produtor que tenha participação na produção ou venda do produto. Retorna dados como nome, endereço, telefone, entre outros. :::hint{type="info"} Importante: Você precisa adicionar na query os filtros `transaction `e `transaction_status` para retornar todos os status desejados. Caso esses filtros não sejam informados, serão retornados apenas os status `APPROVED `e `COMPLETE`. ::: ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/uXx3a2yt0wwQ0c5w04962_image-7.png) | Campo | Obrigatório | Tipo | Descrição | | ------------------------------------- | ----------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Número máximo de itens por página** | Não | string | O número máximo de itens por página que podem ser retornados. | | **Token de paginação** | Não | string | Cursor usado na paginação. Utilize o valor de `next_page_token` ou `prev_page_token` retornado na resposta anterior. | | **ID do Produto** | Não | string | Identificador único (ID) do produto vendido (número de 7 dígitos). | | **Data Inicial** | Não | string | Data inicial do período para o filtro. A data deve estar em milissegundos, a partir de 1970-01-01 00:00:00 UTC. | | **Data Final** | Não | string | Data final do período para o filtro. A data deve estar em milissegundos, a partir de 1970-01-01 00:00:00 UTC. | | **E-mail do Comprador** | Não | string | E-mail da pessoa compradora. Utilize para buscar compras de pessoas específicas. | | **Nome do Comprador** | Não | string | Nome da pessoa compradora. | | **Origem da Venda (SRC)** | Não | string | Código SRC utilizado no link da página de pagamento do produto para identificar a origem. Exemplo: `pay.hotmart.com/B00000000T?src=nomedacampanha`. | | **Código da Transação** | Não | string | Código único de referência para uma transação. Exemplo: `HP17715690036014`. | | **Nome do Afiliado** | Não | string | Nome da pessoa Afiliada responsável pela venda (quando a venda for realizada por um Afiliado do seu produto). | | **Tipo de Comissão** | Não | string | Como o usuário da conta foi comissionado pela venda. Valores possíveis: `PRODUCER`, `COPRODUCER`, `AFFILIATE`. | | **Status da Transação** | Não | string | Status de compra da transação. Valores possíveis: `APPROVED`, `BLOCKED`, `CANCELLED`, `CHARGEBACK`, `COMPLETE`, `EXPIRED`, `NO_FUNDS`, `OVERDUE`, `PARTIALLY_REFUNDED`, `PRE_ORDER`, `PRINTED_BILLET`, `PROCESSING_TRANSACTION`, `PROTESTED`, `REFUNDED`, `STARTED`, `UNDER_ANALISYS`, `WAITING_PAYMENT`. | *** ## Conclusão O conector Hotmart na plataforma Fluid permite consultar produtos e participantes de vendas de forma automatizada. Utilize os filtros disponíveis para refinar as consultas conforme a necessidade do seu fluxo de integração.