Como funciona
O parâmetro é injetado como hp1_...
O parâmetro que você escolher na integração é injetado nas suas páginas carregando a chave
hp1_.... Use o mesmo nome de parâmetro no checkout do gateway, para que o valor hp1_... seja gravado no pedido.O N8N recebe a venda do gateway
Crie um workflow no N8N que receba o webhook/IPN do seu gateway quando houver uma venda.
O N8N faz um POST para o HidePages
Adicione um nó HTTP Request com POST para a URL de webhook da tabela de integrações (o token de autenticação já vem na URL).
A requisição
- Método:
POST - Autenticação: o
?token=...fica na URL do webhook — não envie no JSON. - Content-Type:
application/json
Corpo (JSON) — exemplo
Campos
| Campo | Obrigatório | Descrição |
|---|---|---|
conversion_key | ✅ | O valor hp1_... capturado do parâmetro do gateway. Sempre enviado como conversion_key no JSON (não com o nome do parâmetro do gateway). É o que atribui campanha e página. |
amount_cents | ⬜ | Valor em centavos (ex.: 4990 = US$ 49,90). |
amount | ⬜ | Alternativa a amount_cents. ⚠️ Sem o sufixo _cents, o valor é interpretado em dólares, não em centavos. |
category | ⬜ | Use initial_sale ou sale. Outros valores (refund, upsell…) são ignorados. Se omitido, é aceito como venda. |
order_id | ⬜ | ID do pedido (alternativa: transaction_id). Recomendado para evitar duplicatas. |
currency | ⬜ | Padrão USD. |
product_name, product_id | ⬜ | Informações do produto. |
email / customer_email | ⬜ | E-mail do comprador. |
Template pronto
No painel de Conversions, ao configurar a integração N8N, você pode:- Baixar o template N8N já com a URL e o parâmetro preenchidos, e importá-lo no N8N em ⋮ → Import from file.
- Ver o botão “Ver instruções do webhook N8N” com o payload de exemplo e o passo a passo.
Testando
Dispare uma venda de teste no seu gateway (ou execute o workflow manualmente no N8N com umconversion_key real). Se o POST retornar sucesso, a integração passa a “Integrado” e a conversão aparece no painel.