Link de pagamento: crie por painel, API ou prompt e venda no WhatsApp

Um link de pagamento é uma URL de checkout que você manda para o cliente pagar com Pix, cartão ou boleto, sem site e sem maquininha. No HeroPay você gera o link de três jeitos: no painel em segundos, pela API com uma chamada POST /payment_links ou pedindo em português ao Claude, ChatGPT, Cursor, Lovable e outros. Serve para quem vende produto digital, serviço, mentoria ou assinatura pelo WhatsApp, pela DM ou pela bio. Criar o link é grátis; o Pix custa R$ 0 e cai na hora na sua conta, o boleto custa R$ 0 e o cartão, em até 12x, custa 3,49% por venda aprovada. Sem mensalidade.

Criar conta sandbox · Ler a documentação

Como funciona um link de pagamento, do ponto de vista do dinheiro?

1. Você cria o link com nome, valor em centavos, métodos aceitos, parcelas máximas e, se quiser, a periodicidade da assinatura. Criar não cobra ninguém e não custa nada.
2. O cliente abre a URL que você mandou no WhatsApp, na DM ou na bio. Nesse momento nasce um carrinho com a origem (src) daquele acesso.
3. Ele escolhe como pagar. No Pix, paga pelo QR Code ou copia e cola; no cartão, parcela em até 12x (você decide se absorve ou repassa os juros do parcelamento); no boleto, paga até o vencimento.
4. O pagamento confirma e o seu sistema fica sabendo. O HeroPay envia o webhook spark_payment_confirmed, assinado com HMAC, para a URL que você cadastrou. Libere o acesso ou marque o pedido como pago nesse evento.
5. O dinheiro entra no saldo. Pix cai na hora, disponível para saque para a sua chave Pix. O boleto fica disponível 2 dias após a aprovação e o cartão em 30 dias (D+30), aparecendo antes como saldo a receber; se precisar antes, você simula e pede a antecipação do cartão.

Quais são os 3 jeitos de gerar link de pagamento?

Na prática, por código

Os exemplos usam o sandbox (api.beta.heropay.tech). Para produção, troque a URL base e a chave. Referência completa em Criar link de pagamento.

Criar um link avulso com Pix, cartão e boleto

curl -X POST "https://api.beta.heropay.tech/payment_links" \
  -H "Authorization: Bearer $HEROPAY_JWT_TOKEN" \
  -H "Accept: application/vnd.herospark.com; version=1" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_link": {
      "name": "Mentoria individual - 1 sessão",
      "description": "Sessão de 60 minutos por videochamada",
      "price_cents": 35000,
      "absorbs_fees": true,
      "max_installments": 6,
      "payment_methods": ["pix", "credit_card", "bank_slip"],
      "src": "whatsapp"
    }
  }'

Resposta 201 Created:

{
  "message": "Payment link created successfully",
  "data": {
    "id": 136,
    "name": "Mentoria individual - 1 sessão",
    "description": "Sessão de 60 minutos por videochamada",
    "price_cents": 35000,
    "absorbs_fees": true,
    "max_installments": 6,
    "period": "unitary",
    "frequency_type": "unlimited",
    "frequency_limit": null,
    "overdue_type": "none",
    "overdue_limit": null,
    "public_id": "fc280e25-7cbd-446f-b34f-5b8824bb5124",
    "offer": {
      "id": 6094,
      "kind": "payment_link",
      "url": "https://pay.beta.herospark.com/fc280e25-7cbd-446f-b34f-5b8824bb5124-6094?src=whatsapp",
      "accepted_payment_methods": ["pix", "credit_card", "bank_slip"]
    },
    "created_at": "2026-09-23T10:07:01.929-03:00",
    "updated_at": "2026-09-23T10:07:01.929-03:00"
  }
}

O link que você manda para o cliente é data.offer.url. O src já vem anexado na URL, sem você concatenar nada. Três regras que evitam 422: valor sempre em centavos (35000 = R$ 350,00), mínimo de R$ 5,00 e parcela mínima de R$ 1,99.

Criar um link recorrente (assinatura)

Mande period e o link vira assinatura. frequency_type: "limited" com frequency_limit encerra sozinho depois de N cobranças; "unlimited" renova até o cancelamento.

curl -X POST "https://api.beta.heropay.tech/payment_links" \
  -H "Authorization: Bearer $HEROPAY_JWT_TOKEN" \
  -H "Accept: application/vnd.herospark.com; version=1" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_link": {
      "name": "Comunidade Pro - mensal",
      "price_cents": 4990,
      "absorbs_fees": true,
      "period": "monthly",
      "frequency_type": "unlimited",
      "payment_methods": ["pix", "credit_card", "bank_slip"],
      "src": "bio-instagram"
    }
  }'

A assinatura aceita cartão, boleto e Pix; no Pix, a recorrência usa o Pix Automático: o cliente autoriza uma vez e as cobranças seguintes caem sozinhas. Detalhes de ciclo, cancelamento e eventos em /assinaturas.

Receber o webhook quando o link for pago

Cadastre uma vez a URL que vai ouvir o pagamento confirmado:

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

Quando o cliente paga, sua URL recebe um POST JSON assinado no header X-HeroPay-Signature (HMAC SHA-256 do corpo bruto). Trecho do payload, com os campos do template padrão e valores ilustrativos:

{
  "buyer": { "name": "Ana Souza", "email": "ana@exemplo.com", "phone": "+55 11 99999-0000" },
  "payment": { "id": "98231", "method": "pix", "status": "paid", "net_value_cents": "35000" },
  "offer": { "title": "Mentoria individual - 1 sessão", "price": "350.00" },
  "product": { "name": "Mentoria individual - 1 sessão" },
  "cart": { "src": "whatsapp" },
  "installments": { "count": "1", "fees": "0" }
}

O cart.src diz de onde veio a venda. Confie no evento, não no polling: libere o acesso quando o webhook chegar, não quando o cliente voltar para a página de obrigado. Validação da assinatura e lista dos 9 gatilhos em /webhooks.

Por prompt, com a sua ferramenta de IA

Cole https://heropay.tech/llms.txt na conversa com Claude, ChatGPT, Cursor, Lovable e outros, e peça:

Com base em https://heropay.tech/llms.txt, escreva o código que cria um
link de pagamento de R$ 350 para "Mentoria individual - 1 sessão",
aceitando Pix, boleto e cartão em até 6x, com origem "whatsapp".
Depois me dá a mensagem pronta para eu mandar pro cliente.

O código gerado chama POST /payment_links com price_cents: 35000 (em centavos, não 350) e src: "whatsapp", e a URL volta pronta em data.offer.url. A chave fica no seu ambiente, nunca colada no chat, e criar link não mexe no seu saldo. Para o botão "Pagar" num app, o passo a passo está em /integracoes/lovable. Um MCP server oficial está em desenvolvimento; hoje o caminho é llms.txt, docs abertas e API REST. Mais em /ai.

Link de pagamento que cai na hora: é verdade?

No Pix, sim. O Pix pago pelo link do HeroPay cai na hora no seu saldo, disponível para saque para a chave Pix cadastrada no seu CPF ou CNPJ, e custa R$ 0 por transação. Numa venda de R$ 350 no Pix, entram R$ 350,00.

No cartão e no boleto, "cai na hora" não é verdade em nenhum gateway sem custo extra. No HeroPay, o cartão fica disponível em 30 dias (D+30) e o boleto 2 dias após a aprovação. Quando um concorrente anuncia "cartão que cai na hora", o que existe por trás é antecipação de recebíveis, e antecipação tem tarifa. No HeroPay, isso fica explícito: você consulta GET /financial/anticipation_simulation, vê quanto cai e quanto custa, e só então decide. Regras em /antecipacao.

Taxas do HeroPay verificadas em setembro de 2026. Tabela completa e comparação com outros gateways em /precos.

Como vender pelo WhatsApp, pela DM e pela bio com link de pagamento?

O link de pagamento é o checkout que cabe numa conversa. Três usos que funcionam:

• WhatsApp, cobrança um a um. Fechou no áudio, manda o link. O checkout tem widget de WhatsApp para o cliente tirar dúvida sem sair da página, e o cupom aplicado pela própria URL resolve o "consegue um desconto?" sem você criar outro link.
• DM do Instagram ou TikTok. Resposta automática com o link e ?src=dm-instagram. No fim do mês você sabe quanto a DM vendeu, separado do resto.
• Bio e grupos. O mesmo link aceita vendas ilimitadas, então ele pode ficar fixo na bio ou na descrição do grupo. Cada acesso gera um carrinho próprio.

Para ticket alto vendido no WhatsApp, o checkout traz os recursos que salvam venda de cartão: pagamento com 2 cartões, Parcelamento Inteligente que tenta de novo a venda recusada por limite, e compra 1-click para quem já comprou na rede.

Link avulso ou recorrente: qual usar?

Regra prática: se você vai cobrar o mesmo cliente de novo em 30 dias, é recorrente. Mandar link avulso todo mês é pedir para o cliente esquecer.

Como rastrear de onde veio cada venda do link?

Com o src. O mesmo link serve a todos os canais; o que muda é a origem no fim da URL:

https://pay.herospark.com/<public_id>-<offer_id>?src=whatsapp-lista
https://pay.herospark.com/<public_id>-<offer_id>?src=bio-instagram
https://pay.herospark.com/<public_id>-<offer_id>?src=email-lancamento

O valor é salvo no carrinho quando o cliente abre o checkout e chega em cart.src em todos os webhooks daquela compra: pagamento confirmado, recusa, estorno, chargeback. O src aceita letras, números e . _ - ~, até 255 caracteres. Se você cria o link pela API, mande src no corpo e a URL já volta montada.

Para mídia paga, o checkout preserva as UTMs de ponta a ponta e envia os eventos para Meta Pixel com CAPI e deduplicação, Google Ads, GA4 e outros pixels (TikTok, Kwai, Taboola, Outbrain), configurados por oferta. O src é o rastreamento que chega no seu sistema pelo webhook; as UTMs alimentam as suas ferramentas de anúncio.

Link reutilizável com várias ofertas

Um link HeroPay não é de uso único. Ele aceita quantas vendas você quiser, até ser excluído. Para vender o mesmo produto em condições diferentes, crie uma oferta por condição:

• Por preço: lançamento a R$ 297 e preço cheio a R$ 497, dois links, um só produto.
• Por método: um link só Pix para a lista quente, com preço especial à vista, e outro com cartão em 12x para o anúncio.
• Por canal: o mesmo link com src diferente, quando o preço é igual e você só quer medir a origem.

Pela API, cada POST /payment_links cria um link com uma oferta; GET /payment_links lista todos (paginado com page e items) e DELETE /payment_links/{id} tira um do ar. No painel, as ofertas ficam agrupadas no produto.

Como recuperar quem abriu o link e não pagou?

Todo cliente que abre o link, preenche e-mail ou telefone e não paga vira carrinho abandonado. A recuperação acontece em duas camadas:

1. Automática, no checkout. A recuperação de carrinho dispara em 15 minutos, com cerca de 25 variáveis para personalizar a mensagem, e leva o link de volta para o cliente terminar a compra de onde parou. Boleto não pago recebe recobrança depois de 4 dias; parcela recusada, até 3 tentativas.
2. No seu CRM, pela API. GET /reports/tracking/abandoned_carts?start_date=2026-09-22&end_date=2026-09-23 lista os abandonos do período para você disparar a sua própria sequência, pelo WhatsApp do vendedor ou pelo e-mail que já usa.

Para recusa de cartão, o webhook payment_credit_cart_refused traz o motivo da operadora em payment_methods.credit_card.refused_message. Limite estourado pede outra conversa que cartão bloqueado, e o relatório de recusadas mostra qual das duas é a sua maior perda.

Casos de uso, com a conta em reais

Mentora que vende sessão avulsa pelo WhatsApp. Sessão de R$ 350. No Pix, entram R$ 350,00 na hora. No cartão, a tarifa é 3,49%, ou R$ 12,22, e ficam R$ 337,78 (com absorbs_fees: true, os juros do parcelamento também saem do lado dela; com false, o cliente paga). Vinte sessões por mês no Pix são R$ 7.000,00 sem desconto nenhum.

Infoprodutor em lançamento, um link por canal. Curso de R$ 497 com ?src=whatsapp-lista, ?src=bio-instagram e ?src=email-lancamento. Cada venda no cartão custa R$ 17,35 de tarifa e líquida R$ 479,65; cada venda no Pix, R$ 0. No fim do carrinho aberto, o cart.src dos webhooks mostra qual canal pagou o lançamento, e os abandonos das últimas horas voltam pela recuperação automática com o link.

Comunidade paga ou micro-SaaS com link recorrente. Plano de R$ 49,90 por mês. No cartão, cada cobrança custa R$ 1,74 de tarifa; com 100 assinantes, R$ 174,00 por mês, ou R$ 2.088,00 por ano. Com a assinatura no Pix Automático, a tarifa por cobrança é R$ 0 e os R$ 4.990,00 mensais entram inteiros.

Limites e regras honestas

• Valor mínimo de R$ 5,00 por link (price_cents ≥ 500). Parcelas de 1 a 12, com parcela mínima de R$ 1,99.
• Valor fixo. Pela API, todo link tem preço definido; não existe link de valor livre, em que o cliente digita quanto quer pagar.
• Sem edição pela API. A v1 tem criar, listar, consultar e excluir (POST, GET, DELETE), mas não tem PUT. Para mudar o preço, crie um link novo e exclua o antigo.
• Sem validade ou limite de usos por campo. O link aceita vendas até ser excluído; para encerrar uma oferta, exclua o link.
• POST /payment_links não é idempotente. Duas chamadas iguais criam dois links; grave o id antes de repetir.
• Internacional só no avulso. enable_international_sales não vale para link recorrente.
• Pix pelo checkout. A v1 não cria cobrança Pix solta, fora do link; o QR Code sempre nasce no checkout. Se o Pix gerado expirar, o cliente abre o mesmo link e gera um novo.
• Split de pagamento não tem endpoint público na v1; acompanhe em /split-de-pagamentos.
• Conta: a conta de produção aceita CPF, MEI ou CNPJ. A exceção é regra do Banco Central, não do HeroPay: para receber via Pix Automático, o recebedor precisa ter CNPJ. A chave Pix de saque precisa estar no mesmo CPF ou CNPJ do titular.

Comece a vender com link de pagamento hoje

Crie a conta, gere o primeiro link no sandbox e pague você mesmo para ver o webhook chegar. Quando estiver certo, troque a chave e vá pro ar.

Criar conta sandbox · Ler a documentação

Continue por aqui: Preços · Checkout · Pix · Pix Automático · Assinaturas · Webhooks · API para devs · Pagamentos com IA · Lovable · Glossário