Pix para negócios no HeroPay: R$ 0 por transação

O HeroPay recebe Pix com R$ 0 por transação, sem mensalidade e sem volume mínimo. Pela API Pix do HeroPay, você cria um link de pagamento com "pix" em payment_methods, o comprador paga com QR Code ou Pix copia e cola no checkout, e sua aplicação recebe a confirmação por webhook assinado em tempo real. No mesmo checkout dá para vender à vista com preço especial no Pix ou parcelado via Pix, sem cartão de crédito. Serve para SaaS, infoprodutos, serviços e qualquer negócio que vende online no Brasil.

Criar conta sandbox · Ler a documentação

Como funciona o Pix no HeroPay?

Do ponto de vista do dinheiro, são cinco passos:

1. Você cria a cobrança. Um link de pagamento com Pix habilitado, pela API, pelo painel ou com código gerado por Claude, ChatGPT, Cursor, Lovable e outros a partir do llms.txt. O valor vai em centavos (9700 = R$ 97,00), com mínimo de R$ 5,00.
2. O comprador escolhe Pix no checkout. O checkout gera o QR Code e o código Pix copia e cola. Nesse momento sua URL recebe o evento payment_pix_created.
3. O comprador paga no app do banco. O Pix é liquidado pelo sistema do Banco Central em segundos, 24 horas por dia, inclusive fim de semana.
4. Sua aplicação recebe spark_payment_confirmed. Você valida a assinatura HMAC, deduplica o evento e libera o acesso, o pedido ou o serviço. Confie no evento, não no polling.
5. O valor integral entra no seu saldo. Sem desconto de tarifa por transação, e o Pix cai na hora: o valor fica disponível assim que o pagamento é confirmado. Você consulta com GET /financial/balance e saca para uma chave Pix sua com POST /financial/withdrawals, sem tarifa de saque.

Na prática, por código: como receber Pix pela API?

Três chamadas: cadastre o webhook, crie o link, cadastre a chave de saque. Todos os exemplos usam o sandbox (https://api.beta.heropay.tech), gratuito e idêntico à produção.

curl -X POST "$HEROPAY_API_URL/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"
    }
  }'

{
  "message": "Webhook created successfully",
  "data": {
    "id": 201738,
    "name": "Pagamento confirmado",
    "active": true,
    "integration": "HeroWebhook",
    "scope": "Integration",
    "created_at": "2026-09-23T10:02:11.464Z",
    "updated_at": "2026-09-23T10:02:11.464Z",
    "can_update": true,
    "configurations": {
      "url": "https://seuapp.com/webhooks/heropay",
      "request_method": "post",
      "body": {}
    },
    "event": {
      "id": 122758,
      "trigger": "spark_payment_confirmed"
    }
  }
}

curl -X POST "$HEROPAY_API_URL/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": "Consultoria avulsa",
      "description": "Sessão de 1 hora",
      "price_cents": 49700,
      "absorbs_fees": true,
      "payment_methods": ["pix"],
      "src": "whatsapp"
    }
  }'

{
  "message": "Payment link created successfully",
  "data": {
    "id": 137,
    "name": "Consultoria avulsa",
    "description": "Sessão de 1 hora",
    "price_cents": 49700,
    "absorbs_fees": true,
    "max_installments": 1,
    "period": "unitary",
    "frequency_type": "unlimited",
    "frequency_limit": null,
    "overdue_type": "none",
    "overdue_limit": null,
    "public_id": "fc280e25-7cbd-446f-b34f-5b8824bb5124",
    "offer": {
      "id": 6095,
      "kind": "payment_link",
      "url": "https://pay.beta.herospark.com/fc280e25-7cbd-446f-b34f-5b8824bb5124-6095?src=whatsapp",
      "accepted_payment_methods": ["pix"]
    },
    "created_at": "2026-09-23T10:07:01.929-03:00",
    "updated_at": "2026-09-23T10:07:01.929-03:00"
  }
}

{
  "cart": {
    "src": "whatsapp"
  }
}

curl -X POST "$HEROPAY_API_URL/financial/pix_accounts" \
  -H "Authorization: Bearer $HEROPAY_JWT_TOKEN" \
  -H "Accept: application/vnd.herospark.com; version=1" \
  -H "Content-Type: application/json" \
  -d '{
    "pix_account": {
      "pix_type": "cnpj",
      "pix_key": "12.345.678/0001-90"
    }
  }'

{
  "message": "PIX account created and under verification",
  "data": {
    "id": "3f54733b-f1f7-4a0d-aeeb-2b3e05373a97",
    "account_type": "pix",
    "bank_account_type": "pix",
    "pix_type": "cnpj",
    "pix_key": "12.345.678/0001-90",
    "status": "waiting",
    "recipient_id": "3a30653c-2c40-45ad-b2d7-18c8fa355a5c",
    "principal": false,
    "error": ""
  }
}

curl -X POST "$HEROPAY_API_URL/financial/withdrawals" \
  -H "Authorization: Bearer $HEROPAY_JWT_TOKEN" \
  -H "Accept: application/vnd.herospark.com; version=1" \
  -H "Content-Type: application/json" \
  -d '{
    "withdrawal": {
      "pix_account_id": "3f54733b-f1f7-4a0d-aeeb-2b3e05373a97",
      "amount_cents": 20000
    }
  }'

Por prompt: como ativar Pix com a sua ferramenta de IA?

Cole https://heropay.tech/llms.txt na conversa com Claude, ChatGPT, Cursor, Lovable e outros, e a ferramenta passa a conhecer a API do HeroPay a partir das docs abertas. Aí o pedido cabe em uma frase:

Com base em https://heropay.tech/llms.txt, escreva o código que cria um
link de pagamento de R$ 497 só com Pix, nome "Consultoria avulsa",
src "whatsapp", e cadastra um webhook de pagamento confirmado para
https://seuapp.com/webhooks/heropay.

O código gerado usa as mesmas chamadas desta página: POST /payment_links e POST /webhook. A chave de API fica no seu ambiente (variável HEROPAY_JWT_TOKEN), nunca colada no chat. Um MCP server oficial está em desenvolvimento; até lá, llms.txt, docs e API REST são o caminho que funciona hoje.

Quanto custa receber Pix?

No HeroPay, R$ 0 por transação, em qualquer valor. A tabela mostra a tarifa por Pix recebido nos gateways que publicam preço:

Verificado em 23 de setembro de 2026 nas páginas oficiais. O Asaas cobra R$ 0,99 por Pix nos 3 primeiros meses de conta. Taxas mudam: confira a fonte antes de decidir. Iugu e Malga não publicam preço e ficam fora da tabela.

Duas observações honestas. Primeira: outros players também anunciam Pix sem tarifa; compare o pacote (checkout, parcelamento, webhooks, recorrência), não só a linha do Pix. Segunda: o saque do saldo para a sua chave também não tem tarifa. Tabela completa com cartão e boleto em /precos.

Pix parcelado: dá para parcelar no Pix sem cartão?

Dá. No checkout HeroPay, uma compra única pode ser dividida em parcelas pagas por Pix. É o recurso para o comprador que tem o dinheiro por mês, mas não tem cartão de crédito ou não tem limite: ele leva o produto agora e paga uma parcela por mês no Pix.

Como funciona para o comprador:

1. Escolhe Pix no checkout e o número de parcelas.
2. Paga a 1ª parcela na hora, por QR Code ou copia e cola. A compra é confirmada e o acesso é liberado.
3. Paga as parcelas seguintes de um de dois jeitos, conforme você configurar na oferta:
4. Pix a cada parcela: antes de cada vencimento ele recebe por e-mail um novo código Pix e paga manualmente.
5. Parcelamento por Pix Automático (recomendado): ele autoriza uma única vez no app do banco e as próximas parcelas são debitadas sozinhas, no mesmo dia de cada mês. Sem código para lembrar, menos atraso por esquecimento.

Como funciona para você:

• Cada parcela é uma transação Pix e custa R$ 0. Uma compra de R$ 300 em 3x vira 1 compra com 3 transações nos relatórios (transações vs compras).
• Cada parcela entra no saldo quando é paga. Não é antecipação: você recebe mês a mês, no ritmo do comprador.
• O risco de atraso é seu, e é contido. Se uma parcela vence e não é paga, a compra fica inadimplente e o acesso ao produto é bloqueado automaticamente até o comprador regularizar. Pago o atraso, o acesso volta sem perda de progresso.
• A configuração é por oferta, no painel. A API v1 ainda não documenta um parâmetro para ligar o parcelamento via Pix no POST /payment_links.

Qual a diferença para o "Pix no crédito" dos bancos?

Quando o banco do comprador oferece "Pix no crédito" ou "Parcele no Pix", é o banco que empresta: ele paga você à vista e cobra juros do cliente. Para o seu checkout, isso é um Pix comum, que no HeroPay custa R$ 0. O parcelamento via Pix do HeroPay é outra coisa: é você quem parcela, sem banco no meio, sem juros para o comprador e sem análise de crédito. Em dezembro de 2025 o Banco Central desistiu de criar um "Pix Parcelado" oficial e deixou cada instituição oferecer o seu (Agência Brasil).

Fontes: Agência Brasil, 4/dez/2025 sobre a decisão do Banco Central; demais linhas conforme /precos e /checkout. Verificado em setembro/2026.

O que mais o checkout faz com o Pix?

O Pix não é só um botão no checkout HeroPay:

• Preço especial à vista no Pix: desconto só para quem paga no Pix, configurado por oferta.
• Parcelamento via Pix e boleto na mesma compra, lado a lado com o cartão em até 12x.
• Recuperação: carrinho abandonado com gatilho em 15 minutos e o evento payment_pix_created para lembrar quem gerou o Pix e não pagou.
• Rastreamento de ponta a ponta: src do link, UTMs, Meta Pixel + CAPI com deduplicação, Google Ads e GA4 contam a venda no Pix como qualquer outra.
• Relatórios por API: distribuição por método de pagamento e receita por método em /reports/transaction/paid/*, para saber quanto do seu faturamento já é Pix (relatórios).

E o Pix Automático?

É o Pix para assinatura: o cliente autoriza uma vez no app do banco e as mensalidades são cobradas sem ação dele, sem cartão e sem cartão vencido derrubando a renovação. No HeroPay ele está no checkout. No Stripe, contas brasileiras aceitam Pix só em pagamento único (docs do Stripe, verificado em setembro/2026). Tudo sobre prazos, autorização e casos de uso em /pix-automatico.

Casos de uso: quanto sobra com Pix a R$ 0?

Infoprodutor: curso de R$ 997 vendido no Pix

100 vendas por mês no Pix. No HeroPay, tarifa de Pix: R$ 0, e os R$ 99.700 entram inteiros no saldo. A mesma operação custaria R$ 1.186,43 por mês no Stripe (1,19%), R$ 199,00 no Asaas e R$ 80,00 na AbacatePay. Em 12 meses: R$ 14.237,16 a mais no caixa em relação ao Stripe, R$ 2.388,00 em relação ao Asaas e R$ 960,00 em relação à AbacatePay. Com preço especial à vista no Pix, você ainda empurra o mix para o método que não tem tarifa.

Serviço ou mentoria: R$ 1.200 em 6 parcelas no Pix, sem cartão

O cliente não tem limite no cartão para R$ 1.200, mas paga R$ 200 por mês. Com o parcelamento via Pix, ele fecha hoje, paga a 1ª parcela no QR Code e autoriza o Pix Automático para as outras cinco. Você recebe R$ 200 por mês, R$ 0 de tarifa em cada parcela, R$ 1.200 no total. A mesma venda no cartão custaria R$ 41,88 de tarifa (3,49%), e só aconteceria se o cliente tivesse limite. Se uma parcela atrasar, o acesso é bloqueado até o pagamento.

E-commerce ou SaaS de ticket baixo: 1.000 Pix de R$ 89 por mês

Tarifa fixa por Pix pesa mais quanto menor o ticket. Em 1.000 Pix de R$ 89 por mês: HeroPay R$ 0; Stripe R$ 1.059,10; Asaas R$ 1.990,00; AbacatePay R$ 800,00. Por ano, são R$ 23.880,00 que ficam no caixa em vez de ir para tarifa, na comparação com o Asaas. A integração é a mesma dos exemplos acima: um link por produto ou por pedido, e o webhook spark_payment_confirmed baixando o pedido.

Contas com as tarifas verificadas em 23/set/2026 (tabela acima); não incluem tarifas de saque dos outros gateways; no HeroPay, o saque não tem tarifa.

Limites e regras do Pix no HeroPay

Dito com clareza, para você não descobrir em produção:

• Valor mínimo: R$ 5,00 por link (price_cents a partir de 500).
• Sem QR Code solto na v1: a cobrança Pix sempre sai pelo checkout do link de pagamento. Não há endpoint que devolva o QR Code ou o copia e cola para você desenhar na sua própria tela (Pix transparente).
• Validade do QR Code: o Pix gerado no checkout tem prazo de validade. Oriente o comprador a pagar logo depois de gerar o código.
• Chaves Pix só do titular: toda chave cadastrada precisa ser do mesmo CPF/CNPJ da conta. A verificação no DICT é assíncrona (waiting → approved ou disapproved).
• Saque exige chave Pix aprovada e saldo disponível; não tem tarifa.
• Estorno de Pix: até 90 dias depois do pagamento (confira refund_limit_date no POST /refund) e com saldo suficiente na conta.
• Parcelamento via Pix: o risco de atraso é do vendedor; o bloqueio automático de acesso contém o prejuízo, mas não cobra por você. Para reduzir atraso, prefira a modalidade com Pix Automático.
• Sem Idempotency-Key: duas chamadas iguais a POST /payment_links criam dois links. Grave o id antes de repetir.
• Sem split na v1: o Pix entra inteiro no saldo de uma conta. Status em /split-de-pagamentos.

Comece a receber Pix hoje

Crie a conta, gere o token e faça o primeiro Pix de teste no sandbox em minutos, sem homologação. Quando estiver pronto, troque a chave e vá pro ar.

Criar conta sandbox · Ler a documentação

Continue por aqui: Preços · Pix Automático · Link de pagamento · Checkout · Webhooks · Saques e antecipação · Desenvolvedores · Como aceitar Pix via API · HeroPay vs Asaas · Glossário