Para cobrar um micro-SaaS, o HeroPay dá um link de assinatura com Pix Automático, boleto e cartão que você cria com uma chamada de API (ou pedindo ao Claude, ChatGPT, Cursor, Lovable e outros), sem mensalidade, sem taxa de ativação e sem fila de homologação. O custo fixo é R$ 0: você só paga quando vende, e no Pix e no boleto nem assim (R$ 0 por cobrança; cartão 3,49% por transação aprovada, ver preços). O sandbox é gratuito e idêntico à produção, então dá para montar e testar o fluxo inteiro de cobrança antes de ter o primeiro cliente. Serve para quem constrói sozinho ou em dupla, com ticket baixo e plano mensal ou anual.
Criar conta sandbox Ler a documentação
O essencial em 60 segundos
- Custo fixo zero: o HeroPay não cobra mensalidade, ativação nem volume mínimo; enquanto não há venda, a conta custa R$ 0.
- Pix Automático e boleto a R$ 0 por cobrança são o melhor negócio para ticket baixo: num plano de R$ 29, o Pix entra inteiro todo mês.
- No cartão, a tarifa é só percentual: num plano de R$ 29 são R$ 1,01 (3,49%), sem valor fixo que pese no ticket baixo. Acima de R$ 98 por cobrança no cartão, há gateway mais barato; dizemos a conta inteira abaixo.
- O sandbox é gratuito, sem homologação e igual à produção: você integra, paga pelo checkout de teste e recebe os webhooks antes de abrir empresa ou ter cliente.
- Um plano é um link de pagamento com
period:POST /payment_linkscom"period": "monthly"devolve a URL do checkout da assinatura. - A IA integra por você: cole
heropay.tech/llms.txtno Claude, ChatGPT, Cursor, Lovable e outros, e o plano e o webhook saem de um pedido em português, direto na API REST. - Honestidade: a v1 não tem trial nativo, troca de plano com pró-rata nem cobrança por uso.
Dor 1: custo fixo mata margem pequena
A dor em uma frase: com 20 assinantes a R$ 29 o MRR é R$ 580, e qualquer ferramenta que cobra mensalidade, ativação ou tarifa fixa alta por Pix come uma fatia grande do que entra.
O que resolve no HeroPay: zero custo fixo e Pix Automático a R$ 0 por cobrança. O Pix Automático é a recorrência regulada pelo Banco Central desde junho de 2025: o assinante autoriza uma vez no app do banco e cada ciclo é debitado sozinho, sem cartão, sem limite estourado e sem cartão vencido. Para micro-SaaS de ticket baixo, é o método que faz a margem sobreviver. Detalhes em /pix-automatico.
A conta em reais (100 assinantes a R$ 29 por mês, 60% no Pix recorrente e 40% no cartão à vista):
| Gateway | Pix por cobrança | Cartão por cobrança (R$ 29) | Tarifa por mês | Tarifa por ano |
|---|---|---|---|---|
| HeroPay | R$ 0 | R$ 1,01 (3,49%) | R$ 40,48 | R$ 485,81 |
| AbacatePay | R$ 0,80 | R$ 1,62 (3,50% + R$ 0,60) | R$ 112,60 | R$ 1.351,20 |
| Asaas | R$ 1,99 (R$ 0,99 nos 3 primeiros meses) | R$ 1,36 (2,99% + R$ 0,49) | R$ 173,68 | R$ 2.084,21 |
Verificado em 23 de setembro de 2026. Fontes: HeroPay em /precos; AbacatePay em abacatepay.com/pricing (Pix) e docs.abacatepay.com (cartão); Asaas em asaas.com/precos-e-taxas. O ano do Asaas usa a tarifa cheia de Pix; com o desconto dos 3 primeiros meses, cai cerca de R$ 180. Nenhum dos três cobra mensalidade.
Leitura sem maquiagem: no cartão, com ticket de R$ 29, o HeroPay é o mais barato dos três (R$ 1,01 contra R$ 1,36 no Asaas e R$ 1,62 na AbacatePay), porque não há valor fixo por transação. Com 60% da base no Pix, o HeroPay sai R$ 865 por ano mais barato que a AbacatePay e R$ 1.598 mais barato que o Asaas nesta base. Onde perdemos: no cartão à vista acima de R$ 98 por cobrança, o Asaas cobra menos; num plano anual de R$ 290 no cartão, são R$ 9,16 no Asaas contra R$ 10,12 no HeroPay. Se o seu público paga plano caro no cartão, faça a sua conta antes de escolher. A alavanca que mais muda o jogo é colocar o Pix Automático como primeira opção na página de preços.
Dor 2: ainda não tem CNPJ (e não quer abrir empresa para testar uma ideia)
A dor em uma frase: a maioria dos micro-SaaS começa como projeto de fim de semana, e exigir contrato, CNPJ e homologação antes do primeiro teste mata a ideia antes de ela ser validada.
O que resolve no HeroPay: o sandbox é gratuito, não tem fila de homologação e roda o mesmo contrato da produção. Você cria a conta de teste, faz a integração inteira (plano, checkout, webhook, cancelamento) e só se preocupa com a formalização quando tiver alguém disposto a pagar. Ir para produção é trocar a URL base e o token.
E quando alguém pagar, você não precisa abrir empresa para receber: a conta de produção do HeroPay aceita CPF, MEI ou CNPJ. A conta com CPF vende normalmente por Pix, cartão e boleto; para receber via Pix Automático, o Banco Central exige CNPJ.
A conta em reais: validar custa R$ 0. Sem mensalidade, o período em que o micro-SaaS tem zero ou três clientes não gera boleto de ferramenta nenhuma; e a primeira venda no Pix entra inteira. Quando for formalizar, o registro como MEI é gratuito no portal gov.br do Empreendedor; o custo mensal do MEI passa a existir a partir da abertura, e é por isso que faz sentido abrir só depois de validar.
Dor 3: você está sozinho para integrar
A dor em uma frase: o fundador de micro-SaaS é o dev, o suporte e o marketing ao mesmo tempo, e cada tarde lendo documentação de gateway é uma tarde sem produto.
O que resolve no HeroPay: a API foi feita para ser integrada por IA. Cole o llms.txt do HeroPay (heropay.tech/llms.txt) no Claude, ChatGPT, Cursor, Lovable e outros: a ferramenta lê a referência completa da API REST, confere os detalhes nas docs abertas em docs.heropay.tech e gera o código sem inventar parâmetro. Você pede o plano e o webhook em português e revisa o resultado no sandbox. Guias por ferramenta em /integracoes e o panorama em /ai.
Integra o HeroPay no meu app Next.js usando https://heropay.tech/llms.txt.
Cria um plano "Pro mensal" de R$ 29 com Pix Automático e cartão,
uma rota /api/webhooks/heropay que valida o header X-HeroPay-Signature
(HMAC SHA-256 do corpo bruto) e, em subscription_activate, marca o usuário
cujo id veio em cart.src como pro. Em subscription_cancel, volta para free.
O token fica em variável de ambiente, nunca no front.Um MCP server oficial está em desenvolvimento. Até ele sair, llms.txt mais API REST é o caminho que funciona hoje, em qualquer ferramenta.
A conta em reais (hipótese, troque pelo seu número): se a sua hora vale R$ 100 e integrar billing lendo documentação toma dois dias de trabalho (16 horas), são R$ 1.600 de tempo. Pedir à IA e revisar o que ela gerou no sandbox cabe numa tarde. O que não é hipótese: você não paga nada ao HeroPay por nenhuma dessas horas.
Como um micro-SaaS pluga o HeroPay (arquitetura típica)
A arquitetura mínima tem três peças e cabe num projeto na Vercel, na Netlify ou no Supabase:
Botão "Assinar" ──► link do plano + ?src=<id-do-usuário> (checkout hospedado HeroPay)
HeroPay ──webhook──► função serverless /api/webhooks/heropay
subscription_activate → user.plan = "pro"
subscription_cancel → user.plan = "free"
Variáveis de ambiente: HEROPAY_API_URL · HEROPAY_JWT_TOKEN · HEROPAY_WEBHOOK_SECRET1. Crie o plano (uma vez)
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": "Pro mensal",
"description": "Plano Pro, renovação mensal",
"price_cents": 2900,
"absorbs_fees": true,
"period": "monthly",
"frequency_type": "unlimited",
"payment_methods": ["pix", "credit_card"]
}
}'A resposta 201 Created traz o checkout em data.offer.url. Valores em centavos (2900 = R$ 29,00); o mínimo é R$ 5,00 por ciclo. Grave o id: a v1 não tem Idempotency-Key e repetir a chamada cria outro plano.
2. Amarre o pagamento ao usuário
Anexe ?src=<id-do-usuário> à URL do plano quando renderizar o botão. O HeroPay captura o src e devolve em cart.src em todos os webhooks daquele comprador, então você sabe qual usuário virou pagante mesmo que ele use outro e-mail no checkout. src aceita letras, números e . _ - ~ até 255 caracteres; use o ID interno, nunca e-mail ou CPF.
3. Cadastre o webhook e valide a assinatura
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": "subscription_activate",
"webhook_url": "https://seuapp.com/api/webhooks/heropay",
"request_method": "post"
}
}'Repita para subscription_cancel (e, se quiser avisar o usuário, payment_credit_cart_refused). No handler, recalcule o HMAC SHA-256 do corpo bruto com o segredo do seu webhook, compare com X-HeroPay-Signature e descarte o que não bater; deduplique por pagamento + gatilho, porque o retry pode entregar o mesmo evento duas vezes. Exemplo completo em /webhooks.
Sem código nenhum
Se o micro-SaaS ainda é uma landing e uma planilha, crie o link de assinatura no painel e mande pelo WhatsApp ou coloque no botão da página. Você integra a API quando o produto pedir. Veja /link-de-pagamento.
Mini-case ilustrativo: um fim de semana, uma primeira venda
Fluxo narrado para mostrar a mecânica. Não é um cliente real e não traz números de resultado.
Uma dev constrói, num fim de semana, um micro-SaaS que gera legendas para vídeos curtos. Na sexta à noite ela cria a conta sandbox, abre o Cursor, cola o llms.txt do HeroPay e o prompt acima e pede o plano de R$ 29 com Pix Automático e cartão e a rota de webhook. A ferramenta escreve as chamadas a POST /payment_links e POST /webhook (para subscription_activate e subscription_cancel) e o handler com validação de HMAC; ela roda as chamadas no sandbox. Ela revisa o código, confirma que o token ficou em variável de ambiente e não no front.
No sábado, ela paga o próprio plano no checkout de teste, vê subscription_activate chegar com o cart.src do usuário de teste e a conta virar "pro". Cancela pela API com POST /recurring_payment/cancel e vê subscription_cancel voltar a conta para "free".
No domingo, posta o produto numa comunidade de makers. O primeiro interessado aparece; ela troca a URL base e o token para produção, e o primeiro assinante autoriza o Pix Automático no app do banco. O custo do HeroPay no fim de semana inteiro foi R$ 0, e continua R$ 0 a cada renovação daquele assinante no Pix.
O que um micro-SaaS usa do HeroPay
| Necessidade do micro-SaaS | Recurso do HeroPay | Onde está |
|---|---|---|
| Cobrar mensal ou anual | Link de pagamento com period | /assinaturas |
| Custo zero em ticket baixo | Pix Automático e boleto a R$ 0 por cobrança | /pix-automatico |
| Testar sem empresa e sem contrato | Sandbox gratuito, sem homologação | /desenvolvedores |
| Não construir tela de pagamento | Checkout hospedado com Pix, cartão e boleto | /checkout |
| Saber quem pagou | src na URL, devolvido em cart.src | /link-de-pagamento |
| Liberar e cortar o plano | Webhooks assinados com HMAC | /webhooks |
| Integrar sem ler tudo | llms.txt, docs abertas e API REST | /ai · /integracoes |
| Cartão que falhou | Reprocessamento automático e troca de cartão self-service | /assinaturas |
| Começar sem código | Link de assinatura criado no painel | /link-de-pagamento |
Limites honestos para micro-SaaS
- Cartão acima de R$ 98 por cobrança: a partir desse valor, no cartão à vista, o Asaas cobra menos por transação (num plano anual de R$ 290, R$ 9,16 contra R$ 10,12 no HeroPay). Em plano de valor alto, empurre o Pix Automático, que custa R$ 0.
- Valor mínimo de R$ 5,00 por ciclo. Plano de R$ 3,90 não passa.
- Sem trial nativo, sem pró-rata e sem cobrança por uso na v1. Trial você controla no app antes de mandar ao checkout; troca de plano é cancelar e assinar de novo.
- Sem pagamento internacional em link recorrente. Se o micro-SaaS vende em dólar para fora, a assinatura internacional não está coberta hoje.
- Conta de produção: aceita CPF, MEI ou CNPJ. Para receber via Pix Automático, o Banco Central exige CNPJ.
Onde os outros são melhores: no cartão à vista acima de R$ 98 por cobrança (um plano anual, por exemplo), o Asaas cobra menos por transação; a AbacatePay tem trial e cobrança por uso documentados. Comparações completas em AbacatePay vs HeroPay e Asaas vs HeroPay.
Perguntas frequentes de micro-SaaS
Qual o melhor gateway de pagamento para micro-SaaS?
O que não cobra nada enquanto você não vende e cobra pouco quando vende no método que o seu público usa. Para micro-SaaS brasileiro, isso quer dizer: sem mensalidade, sandbox gratuito, recorrência por Pix Automático e integração rápida. O HeroPay tem Pix e boleto a R$ 0 por cobrança e cartão a 3,49%, sem custo fixo, e integra por IA pelo llms.txt e pela API REST. No cartão, em ticket baixo, o HeroPay sai mais barato que Asaas e AbacatePay; acima de R$ 98 por cobrança, o Asaas cobra menos. Faça a conta com o seu mix de pagamento antes de escolher.
Preciso de CNPJ para começar?
Para desenvolver e testar, não: o sandbox é gratuito, não passa por homologação e roda o mesmo contrato da produção, então você integra o fluxo inteiro antes de formalizar qualquer coisa. Para receber dinheiro real também não: a conta de produção passa por cadastro e aceita CPF, MEI ou CNPJ. A conta com CPF vende normalmente por Pix, cartão e boleto; para receber via Pix Automático, o Banco Central exige CNPJ. Se for abrir empresa, o registro como MEI é gratuito no portal gov.br; muitos makers só formalizam depois de validar que alguém paga.
Quanto custa cobrar a assinatura do meu micro-SaaS no HeroPay?
Nada fixo: sem mensalidade, sem ativação e sem mínimo. Cada cobrança aprovada paga a tarifa do método: Pix Automático R$ 0, boleto R$ 0 e cartão 3,49%. Num plano de R$ 29, o Pix entra inteiro e o cartão paga R$ 1,01. Num plano anual de R$ 290 no cartão, a tarifa é R$ 10,12 por ano. Cobrança recusada não paga tarifa. Tabela completa em /precos.
Como cobrar assinatura por Pix no meu micro-SaaS?
Com o Pix Automático. Crie o plano com POST /payment_links, period: "monthly" e pix em payment_methods. No checkout, o assinante autoriza a recorrência uma vez no app do banco, e cada ciclo é debitado sem ele pagar de novo. O seu backend recebe subscription_activate na primeira cobrança e spark_payment_confirmed em cada renovação. Custa R$ 0 por cobrança e não sofre com cartão vencido ou sem limite. Detalhes em /pix-automatico.
Consigo integrar o pagamento sem saber backend?
Dá para chegar perto disso. O caminho sem código é criar o link de assinatura no painel e colocar no botão. Para liberar o plano automaticamente, você precisa de um endpoint que receba o webhook, e aí a IA ajuda: peça ao Claude, ChatGPT, Cursor, Lovable e outros que integrem o HeroPay usando o llms.txt, e a ferramenta gera a função serverless com validação do HMAC. A única regra inegociável: o token da API fica no servidor, nunca no front-end nem no repositório público.
O HeroPay funciona com Lovable, Bolt, v0 e Supabase?
Sim. A integração é REST com dois headers, então roda em qualquer ambiente que faça uma chamada HTTP no servidor: rota de API do Next.js na Vercel, edge function do Supabase, função da Netlify. No Lovable, no Bolt e no v0, aponte a ferramenta para o llms.txt do HeroPay e peça o plano e o webhook. Guias passo a passo em /integracoes/lovable e /integracoes/v0-bolt.
Dá para oferecer teste grátis antes de cobrar?
Não como recurso nativo da v1. O padrão para micro-SaaS é o trial dentro do próprio app: o usuário cria a conta, usa por alguns dias e, perto do fim, vê o botão "Assinar" com o link do plano e o src dele. Quando paga, chega subscription_activate e o acesso segue. Você não captura o cartão no início, mas também evita a cobrança surpresa, que costuma virar chargeback e reclamação.
O que acontece se o cartão do assinante falhar?
O HeroPay reprocessa a cobrança automaticamente e envia o webhook payment_credit_cart_refused com o motivo da operadora. O assinante pode trocar o cartão sozinho no fluxo self-service, sem você construir tela nenhuma. Se pagar, chegam spark_payment_confirmed e subscription_update; se o limite de atrasos for atingido, chega subscription_cancel e você volta o usuário para o plano gratuito. Tentativas recusadas não pagam tarifa. Para ticket baixo, o Pix Automático evita boa parte desse problema.
Tenho que construir a tela de pagamento?
Não. Todo link de pagamento abre o checkout hospedado do HeroPay, com Pix, cartão e boleto; o cartão é digitado e tokenizado fora do seu servidor, então você não lida com número de cartão nem com escopo de PCI. O seu app só precisa de um botão com a URL do plano e de um endpoint de webhook. Veja o que o checkout faz em /checkout.
Comece agora
Crie o plano no sandbox hoje, pague com o checkout de teste e veja subscription_activate virar o seu usuário para "pro". Custo: R$ 0.