Integração Manual AvançadaBETA

Aprenda a conectar checkouts complexos, pop-ups formulários e redirecionamentos invisíveis (via AJAX ou Backend WordPress) com o sistema de rastreio de checkout do SPLITWAVE.

O Mecanismo Padrão

Por padrão, ao definir um experimento de Checkout Externo, o SPLITWAVE procura botões e links `<a>` que apontem para a plataforma de pagamento. Quando encontra o destino, anexa de forma invisível um identificador temporário assinado. Exemplo: ?sck=sw1_....

Quando a venda é confirmada na Hotmart, Kiwify ou Stripe, o webhook devolve esse identificador. O SPLITWAVE valida sua assinatura antes de associar a venda ao visitante e à variante.

Se o botão aponta primeiro para uma rota do seu próprio domínio, marque o link com data-splitwave-checkout e faça essa rota repassar o parâmetro sck para a URL final do checkout. Assim o endereço da plataforma pode continuar oculto no HTML sem perder a atribuição.

O Problema dos Redirecionamentos JS e Servidor

Em ferramentas de funil complexas (formulários do Elementor, ZapVoice, captação de chaves PIX, ou plugins tipo RPPC), o clique do usuário não vai diretamente para o checkout. O botão abre um pop-up ou apenas aciona o servidor enviando dados, e é o próprio JavaScript ou PHP quem força o redirecionamento.

Como o link verdadeiro só passa a existir milissegundos antes do redirecionamento, a interceptação automática do SPLITWAVE costuma falhar nesses cenários ultra-customizados.

A Solução: API Global window.SPLITWAVE

Para devolver o controle a você, criamos uma interface segura e pública exposta diretamente no navegador: o objeto window.SPLITWAVE. Através dele, no momento em que seu código for montar a URL de checkout, você mesmo puxa a nossa UTM de Rastreio do Visitante.

window.SPLITWAVE.getTrackingParam()

Essa função responde imediatamente com o identificador pronto para uso. Exemplo de retorno: sw1_.... O seu código precisa apenas colocar o valor em src ou sck na URL final do checkout.

Na Stripe, passe "stripe" para receber o formato aceito: window.SPLITWAVE.getTrackingParam("stripe"). Use o valor em client_reference_id ou metadata.splitwave_tracking. Em Payment Links de buy.stripe.com, a SPLITWAVE faz isso automaticamente quando client_reference_id está livre.

Cenário de Exemplo (Desenvolvimento Customizado)

Se você possui um formulário em JavaScript que avalia o plano selecionado e manda via redirecionamento base:

function concluirCompraECobrar(slugPlanoSelecionado) {
  let checkoutFinalURL = "https://pay.hotmart.com/" + slugPlanoSelecionado;
  let params = new URLSearchParams();
  
  // Magia do Rastreamento do SPLITWAVE
  if (typeof window.SPLITWAVE !== "undefined") {
    let abTracking = window.SPLITWAVE.getTrackingParam();
    if (abTracking) {
      params.append("src", abTracking); // "src" da Hotmart. Se for outra plataforma, veja qual UTM eles recebem
    }
  }

  // Redireciona o cliente instantaneamente
  window.location.href = checkoutFinalURL + "?" + params.toString();
}