• Primeiros Passos
    • Autenticação
    • Ambientes
    • Cartões de Teste
    • Pagamento de Fatura Checkout
    • Pagamento de Faturas de uma Venda
    • Webhooks
    • Captação de Leads e Venda por LP Externa
    • Erros
    • Limites de Requisição
    • Autenticação
      • Troca clientId/clientSecret por um token de acesso
        POST
    • Leads
      • Cria um lead
        POST
      • Atualiza um lead
        PATCH
    • Contatos
      • Consulta um contato por e-mail
        GET
      • Consulta um contato por id
        GET
      • Atualiza um contato
        PATCH
    • Links de Pagamento Personalizados
      • Lista links de pagamento
        GET
      • Cria um link de pagamento personalizado
        POST
      • Simula o cronograma de cobrança de um link de pagamento
        POST
      • Consulta um link de pagamento
        GET
      • Cancela um link de pagamento
        POST
      • Atualiza a expiração de um link de pagamento
        PATCH

    Captação de Leads e Venda por LP Externa

    Este guia descreve como capturar leads e vendas a partir de uma landing page (LP) externa ao Mercury, hospedada pelo próprio parceiro.

    Host#

    O host da sua landing page/checkout externo (ex.: pay.mrcy.io).

    Parâmetros Principais#

    1. Oferta (ID do Plano)#

    Parâmetro: oferta
    Tipo: String
    Descrição: ID único do plano que será adquirido
    Exemplo: ?oferta=12345

    2. Seller (Tipo do Vendedor)#

    Parâmetro: seller
    Tipo: String
    Valor Padrão: performance
    Descrição: Identifica o tipo/canal de vendedor responsável pela venda (ex.: performance, atendimento) — a categoria, não uma pessoa específica.

    3. Source (Código do Vendedor)#

    Parâmetro: source
    Tipo: String
    Valor Padrão: direto
    Descrição: Identifica a origem específica dentro do canal indicado por seller — pode ser o código de um vendedor individual, uma campanha, ou direto quando não há uma origem específica.
    Exemplo: ?source=vendedor123
    Resumo: seller é o tipo/canal (a categoria); source é o identificador específico dentro daquele canal. Essa distinção vale em qualquer endpoint da API que use os dois parâmetros (ex.: criação de lead, checkout, links de pagamento).

    4. Dados do Cliente#

    Parâmetros:
    name - Nome completo do cliente
    email - Email do cliente
    phone - Telefone do cliente

    5. UTMs (Códigos de Rastreamento)#

    Parâmetros:
    utmSource - Origem da campanha
    utmMedium - Meio de divulgação
    utmCampaign - Nome da campanha
    utmTerm - Termos de busca
    utmContent - Conteúdo específico
    utmId - ID da campanha

    Exemplo de URL Completa#

    https://pay.mrcy.io/pagar?oferta=12345&seller=performance&source=direto&name=João Silva&email=joao@email.com&phone=11999999999&utmSource=google&utmMedium=cpc&utmCampaign=blackfriday

    Fluxo de Funcionamento#

    1.
    Identificação do Plano: Campo oferta é obrigatório para busca dos dados daquela oferta em questão
    2.
    Dados do Cliente: Os parâmetros name, email e phone são utilizados para o pagamento
    3.
    Configuração do Vendedor: Os parâmetros seller e source definem o contexto de venda
    4.
    Rastreamento: Os parâmetros UTM são utilizados para analytics e rastreamento de campanhas

    Observações Importantes#

    Os parâmetros seller e source têm valores padrão caso não sejam fornecidos
    O parâmetro oferta é necessário para busca da oferta específica da venda
    Os parâmetros name, email e phone são obrigatórios
    O parâmetro name precisa contar nome e sobrenome separados por espaço (Joao Silva)
    Todos os parâmetros UTM são opcionais mas recomendados para rastreamento
    Previous
    Webhooks
    Next
    Erros
    Built with