Conecte o HeroPay a mais de 10 mil apps via Zapier

Para conectar o HeroPay ao Zapier hoje, você usa o Webhooks by Zapier nos dois sentidos: o trigger Catch Hook recebe os eventos do HeroPay (venda confirmada, Pix gerado, estorno, assinatura cancelada) e dispara qualquer app do catálogo; a action Custom Request chama POST /payment_links e devolve um link de checkout com Pix, boleto e cartão. Não existe app oficial do HeroPay no Zapier, então a integração é por webhook e API REST, e isso exige um plano pago do Zapier. Em minutos, cada venda vira linha no Google Sheets e aviso no Slack.

Criar conta sandbox · Ler a documentação

Como conectar o HeroPay ao Zapier?

O fluxo tem duas metades independentes. Use só a que precisa.

Antes de começar, tenha três coisas: conta sandbox no HeroPay com o token de API copiado do painel (app.heropay.tech), um plano pago do Zapier (Professional ou acima, que já libera o teste gratuito deles) e um terminal para rodar um curl.

Zap 1: venda confirmada vira linha no Google Sheets e aviso no Slack

É o Zap que quase todo mundo monta primeiro: controle de vendas numa planilha que o financeiro já usa, e o time comemorando no canal.

curl -X POST https://api.beta.heropay.tech/webhook \
  -H "Authorization: Bearer $HEROPAY_API_KEY" \
  -H "Accept: application/vnd.herospark.com; version=1" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook": {
      "trigger": "spark_payment_confirmed",
      "webhook_url": "https://hooks.zapier.com/hooks/catch/123456/abcdef/",
      "request_method": "post"
    }
  }'

{
  "buyer": { "name": "...", "email": "..." },
  "payment": { "id": "...", "value": "...", "method": "...", "status": "..." },
  "offer": { "...": "..." },
  "product": { "...": "..." },
  "cart": { "src": "instagram" }
}

Zap 2: formulário vira link de pagamento e e-mail com o link

O caso de quem vende serviço, mentoria ou inscrição: a pessoa preenche um Typeform ou Google Forms e recebe na hora um link para pagar com Pix, boleto ou cartão.

{
  "payment_link": {
    "name": "Mentoria de 1 hora",
    "description": "Sessão para {nome do formulário}",
    "price_cents": 29700,
    "absorbs_fees": true,
    "max_installments": 6,
    "payment_methods": ["pix", "credit_card", "bank_slip"],
    "src": "{id da resposta do formulário}"
  }
}

Variação mais barata: um link só, com ?src= na URL

Criar um link por resposta gasta uma task a mais por lead e enche o painel de links. Se o produto e o preço são sempre os mesmos, crie o link uma vez no painel e, no Zap, monte a URL com Formatter by Zapier (que não consome task): URL_DO_LINK?src={id da resposta}. O src da URL chega em cart.src do mesmo jeito. O Zap cai de duas tasks por lead para uma.

Descreva o Zap para o assistente de IA

O editor do Zapier tem um assistente de IA que monta o rascunho do Zap a partir de uma descrição. Cole o texto abaixo, troque o que está entre colchetes e revise campo a campo antes de publicar: o assistente não conhece a API do HeroPay, então os headers e o JSON vêm desta página.

Crie um Zap com estes passos:
1. Trigger: Webhooks by Zapier, evento Catch Hook.
2. Action: Google Sheets, Lookup Spreadsheet Row na planilha [Vendas HeroPay], aba [2026], buscando a coluna payment_id pelo campo "payment id" do trigger; se não encontrar, crie a linha com as colunas data, nome (buyer name), email (buyer email), produto (product name), valor (payment value), metodo (payment method), origem (cart src) e payment_id (payment id).
3. Action: Slack, Send Channel Message no canal [#vendas] com o texto "Venda confirmada: {product name}, R$ {payment value} via {payment method}. Origem: {cart src}."
Não adicione passos além desses.

Para o Zap com validação de assinatura, peça o código do passo Code by Zapier ao Claude, ChatGPT, Cursor ou outra IA de sua preferência com o prompt da seção seguinte, ou copie o código pronto.

O Zapier valida a assinatura dos webhooks do HeroPay?

Não nativamente. O HeroPay assina cada evento com o header X-HeroPay-Signature, um HMAC SHA-256 do corpo calculado com o segredo de assinatura exibido no painel. O trigger Catch Hook do Zapier não confere assinatura nenhuma, e ainda faz o parse do corpo e não entrega os headers. Qualquer pessoa que descobrir a URL do Zap consegue mandar um evento falso.

O que isso significa na prática:

• Zap de registro e aviso (planilha, Slack, CRM): o risco é uma linha falsa na planilha. Aceitável para muita gente, desde que ninguém tome decisão financeira só por ela.
• Zap que libera acesso, emite nota ou manda produto: valide a assinatura. Sempre.

Workaround: Catch Raw Hook + Code by Zapier

Troque o trigger por Catch Raw Hook, que entrega o corpo sem parse e os headers da requisição. Depois adicione Code by Zapier > Run JavaScript e mapeie três campos em Input Data: corpo (o raw body do trigger), assinatura (o header da assinatura, que aparece nos dados de teste com o nome normalizado pelo Zapier) e segredo (o segredo do webhook, colado como texto).

const crypto = require('crypto');

const hmac = () => crypto.createHmac('sha256', inputData.segredo).update(inputData.corpo, 'utf8');
// confira o formato da assinatura (hex ou base64) na documentação e mantenha só o certo
const esperadas = [hmac().digest('hex'), hmac().digest('base64')];
const recebida = Buffer.from((inputData.assinatura || '').trim());

const valido = esperadas.some((e) => {
  const b = Buffer.from(e);
  return recebida.length === b.length && crypto.timingSafeEqual(recebida, b);
});

let evento = {};
if (valido) evento = JSON.parse(inputData.corpo);
const buyer = evento.buyer || {};
const payment = evento.payment || {};

output = {
  valido: valido,
  payment_id: payment.id || '',
  valor: payment.value || '',
  metodo: payment.method || '',
  nome: buyer.name || '',
  email: buyer.email || '',
  origem: (evento.cart || {}).src || '',
};

Em seguida, um passo Filter by Zapier com "Only continue if valido is true" (o Filter não consome task). Tudo depois dele só roda com evento autêntico. O Code by Zapier aceita apenas a biblioteca padrão do Node.js, o que inclui o módulo crypto, e está disponível nos mesmos planos pagos que liberam o Webhooks.

Limites honestos desse workaround:

• O segredo fica no campo de Input Data do Zap, visível para quem edita o Zap na sua conta. O Zapier não tem um cofre de segredos para passos de código.
• O Catch Raw Hook aceita corpo de até 2 MB (o Catch Hook, 10 MB); os eventos do HeroPay ficam muito abaixo disso.
• O passo de código consome uma task por evento.

Se o fluxo mexe em dinheiro ou acesso e você não quer manter código dentro do Zapier, o caminho mais sólido é um endpoint seu (ou um fluxo no n8n) que valida o HMAC e só então repassa ao Zap.

Zapier ou n8n: qual usar com o HeroPay?

Os dois recebem o mesmo webhook e chamam a mesma API. A diferença é o modelo de cobrança e onde o fluxo roda.

Verificado em set/2026. Fontes: zapier.com/pricing, zapier.com/apps, n8n.io/pricing.

Resumo honesto: use o Zapier se o seu time já vive nele, precisa de um app de nicho que só ele tem e o volume é de dezenas a poucas centenas de vendas por mês. Passou disso, ou o fluxo mexe em dinheiro e precisa de validação robusta, o n8n sai mais barato e dá mais controle, principalmente hospedado por você.

Quais são as armadilhas mais comuns com Zapier e pagamento?

Token no lugar errado

O token vai no header Authorization da Custom Request, dentro da sua conta do Zapier. Nunca cole o token em formulário, planilha compartilhada ou mensagem do Slack. Se vazar, regenere o token no painel do HeroPay e atualize o Zap.

Esquecer o header Accept

Sem Accept: application/vnd.herospark.com; version=1, a API usa a versão mais recente disponível. Funciona no teste e pode mudar sozinho em produção. Fixe a versão.

Reais onde a API espera centavos

price_cents: 297 cria um link de R$ 2,97, que a API recusa porque o mínimo é R$ 5,00. Em R$ 297,00, mande 29700. No sentido contrário, confira no teste do trigger o formato do valor que chega no payload e, se preciso, converta com o Formatter antes de somar na planilha.

Tratar o redirect como pagamento

Quem confirma pagamento é o evento spark_payment_confirmed, não a página de obrigado. O Pix pode ser pago minutos depois no celular. Confie no evento, não na volta do navegador.

Contar com a retentativa do HeroPay para erros dentro do Zap

O Zapier responde 200 assim que recebe o evento. A partir daí, a retentativa automática do HeroPay já considerou a entrega feita. Se o passo do Sheets falhar, quem reexecuta é o Zapier (histórico de Zaps e reexecução de passos com erro), não o HeroPay. Olhe o histórico do Zap depois de publicar.

Um Zap para todos os eventos sem saber qual chegou

Cada POST /webhook registra um gatilho. Se você apontar vários gatilhos para a mesma URL, acrescente um parâmetro na URL de cada registro, como ?evento=refunded: o Catch Hook costuma expor parâmetros da query string como campos, o que permite separar com Paths ou Filter. Confira no teste do trigger. O caminho mais simples continua sendo um Zap por gatilho.

Dá para cobrar sem Zapier nem código?

Dá. Crie um link de pagamento no painel, com nome, preço e métodos, e mande a URL por WhatsApp, e-mail ou bio. As vendas aparecem no painel e nos relatórios. O Zapier só entra quando você quer que outra ferramenta reaja à venda sozinha. Se o que você quer é colocar pagamento dentro de um app, veja Lovable ou a página de desenvolvedores; se quer que a IA escreva a integração, veja HeroPay para IA.

Comece agora

Crie a conta sandbox, registre a URL do seu Zap e veja a primeira venda de teste cair na planilha em minutos. Sem fila de homologação: quando funcionar no sandbox, registre o webhook em produção e pronto.

Criar conta sandbox · Ler a documentação

Leia também: n8n · Lovable · Webhooks · Link de pagamento · Preços · Desenvolvedores · HeroPay para IA · Glossário