Pagamentos para apps de IA: venda créditos e assinatura sem a taxa comer o custo de token

Para cobrar por um app, chat ou agente de IA no Brasil hoje, o padrão que funciona é combinar dois produtos: pacotes de créditos vendidos como pagamento único (o usuário compra 500 créditos, gasta, compra de novo) e uma assinatura de plano que devolve uma cota de créditos a cada ciclo. No HeroPay, cada pacote é um link de pagamento, o webhook spark_payment_confirmed credita o saldo do usuário no seu banco e o seu app debita a cada uso. Pix custa R$ 0 por transação, o que importa quando a margem já está apertada pelo custo de token. Cobrança por uso nativa (medir o consumo e faturar no fim do ciclo) o HeroPay ainda não tem, e esta página diz como contornar.

Criar conta sandbox · Ler a documentação

Assinatura ou créditos: como monetizar um chat ou agente de IA?

A dor em uma frase: você não sabe se cobra mensalidade (receita previsível, mas o usuário pesado dá prejuízo) ou créditos (custo sob controle, mas receita que oscila), e o provedor de pagamento que você escolhe define o que é possível.

Os três modelos que aparecem em apps de IA, e o que cada um pede do gateway:

A feature que resolve: o HeroPay cobre as três primeiras linhas com o que já existe na API. Pacotes são links de pagamento unitários, a cota mensal é uma assinatura, e os dois conversam com o seu banco pelo mesmo webhook. A quarta linha, cobrança por uso pós-paga com fatura variável, não existe no HeroPay hoje.

Na prática, o combinado que mais protege a margem é assinatura com cota + pacote avulso para quem estoura. O usuário previsível paga o plano; o pesado compra mais créditos, e cada crédito vendido já tem o custo de token coberto.

A conta em reais (exemplo ilustrativo, troque pelos seus números): um plano de R$ 49,90 por mês "ilimitado", num app em que cada geração custa R$ 0,03 em tokens. Um usuário que faz 5.000 gerações no mês custa R$ 150 e paga R$ 49,90: prejuízo de R$ 100,10 nesse usuário. O mesmo plano com cota de 1.000 gerações custa no máximo R$ 30 em tokens e deixa R$ 19,90 de margem antes do gateway. Os 4.000 extras, vendidos em pacotes de 500 por R$ 29,90, viram R$ 239,20 de receita e R$ 120 de custo.

Quanto do preço do crédito vai para o gateway?

A dor em uma frase: crédito é produto de ticket baixo, e taxa fixa por transação come uma fatia enorme de uma venda de R$ 19,90, justamente onde o custo de token já levou metade.

Vender créditos significa muitas compras pequenas e repetidas. Um gateway que cobra R$ 0,80 ou R$ 1,99 por Pix, ou percentual mais fixo no cartão, transforma cada recarga em margem perdida. E como o custo do modelo costuma ser cobrado em dólar pelo provedor de IA, a margem ainda oscila com o câmbio.

A feature que resolve: Pix a R$ 0 por transação, sem convite e sem volume mínimo. Para o usuário que recompra toda semana, o checkout tem compra 1-click e Pix com QR Code na hora. Você empurra o Pix como método principal e deixa o cartão para quem precisa parcelar um pacote grande.

A conta em reais: 1.000 pacotes de R$ 29,90 por mês.

Verificado em setembro/2026. Fontes: heropay.tech/precos, abacatepay.com e documentação pública da AbacatePay, asaas.com/precos-e-taxas (Asaas cobra R$ 0,99 por Pix nos 3 primeiros meses; cartão R$ 0,49 + 2,99% à vista), stripe.com/br/pricing.

A leitura honesta: como o cartão do HeroPay não tem parte fixa, no cartão à vista de R$ 29,90 ele também é o mais barato da tabela (3,49% da venda, R$ 1,04 por pacote). Isso muda com ticket maior: acima de R$ 98 por venda no cartão à vista, o Asaas (R$ 0,49 + 2,99%) passa a cobrar menos; num pacote de R$ 99,90, são R$ 3,48 no Asaas contra R$ 3,49 no HeroPay. Onde o HeroPay ganha com folga é no Pix, e em app de IA brasileiro o Pix tende a ser o método dominante de recarga. A decisão que mais protege a margem: dê um bônus de créditos no Pix (o checkout tem preço especial à vista no Pix).

Dá para cobrar por uso num app de IA?

A dor em uma frase: o jeito mais justo de cobrar IA é pelo que o usuário consome, mas faturar consumo no fim do mês exige medição, fatura variável e cobrança pós-paga, e poucos gateways no Brasil entregam isso pronto.

A resposta honesta: no HeroPay, cobrança por uso pós-paga nativa não existe hoje. Não há endpoint para reportar consumo medido nem fatura de valor variável por ciclo. Quem tem isso pronto: a Stripe tem cobrança por uso com medidores no Stripe Billing (docs.stripe.com) e a documentação da AbacatePay lista cobrança por uso nas assinaturas (verificado em setembro/2026). Se o seu modelo depende de fatura pós-paga, compare antes de escolher.

A feature que resolve hoje: crédito pré-pago é cobrança por uso com o pagamento na frente. O usuário compra, o app mede e debita, e quando o saldo acaba ele recompra. Para você, é até melhor que o pós-pago: o custo de token já está pago antes de acontecer, não existe inadimplência de consumo e não há fatura surpresa para o usuário contestar.

A conta em reais (ilustrativa): no pós-pago, um usuário que consome R$ 80 em tokens no mês e não paga a fatura é prejuízo de R$ 80, mais o custo de cobrança. No pré-pago, ele consumiu só o que comprou. Com mil usuários e 3% de inadimplência numa fatura média de R$ 80, o pós-pago perde R$ 2.400 por mês que o pré-pago nunca perde.

Como fica a arquitetura de créditos com a API do HeroPay?

A arquitetura tem cinco peças. Nenhuma exige recurso que não esteja na OpenAPI pública.

curl -s -X POST https://api.beta.heropay.tech/payment_links \
  -H "Authorization: Bearer $HEROPAY_API_KEY" \
  -H "Accept: application/vnd.herospark.com; version=1" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_link": {
      "name": "500 créditos",
      "description": "Pacote de 500 créditos para gerar imagens",
      "price_cents": 2990,
      "max_installments": 1,
      "absorbs_fees": true,
      "payment_methods": ["pix", "credit_card"]
    }
  }'

for trigger in spark_payment_confirmed refunded chargeback_request subscription_activate subscription_cancel; do
  curl -s -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\":\"$trigger\",\"webhook_url\":\"https://SEU-APP/api/heropay-webhook/$trigger\",\"request_method\":\"post\"}}"
done

// POST /api/heropay-webhook/[gatilho]
// assinaturaValida é a mesma função de /solucoes/vibe-coding: o formato
// exato do valor de X-HeroPay-Signature está na documentação de webhooks.
export async function POST(req: Request, { params }: { params: { gatilho: string } }) {
  const corpoBruto = await req.text();
  const assinatura = req.headers.get("X-HeroPay-Signature");
  if (!assinaturaValida(corpoBruto, assinatura, CODIFICACAO_DA_DOC)) {
    return new Response("assinatura inválida", { status: 401 });
  }
  const evento = JSON.parse(corpoBruto);
  const gatilho = params.gatilho;          // veio do caminho registrado em POST /webhook
  const pagamentoId = evento.payment?.id;  // id do pagamento, chave de idempotência
  const pedido = await db.orders.find(evento.cart?.src);
  if (!pedido) return new Response("ok");  // evento de outra origem: registra e ignora

  if (gatilho === "spark_payment_confirmed") {
    // índice único (payment_id, kind) no ledger: o retry não credita em dobro
    await db.creditLedger.insertIgnoreDuplicate({
      user_id: pedido.user_id, payment_id: pagamentoId, kind: "purchase",
      amount: pedido.credits,
    });
    await db.orders.markPaid(pedido.id);
  }
  if (gatilho === "refunded" || gatilho === "chargeback_request") {
    await db.creditLedger.insertIgnoreDuplicate({
      user_id: pedido.user_id, payment_id: pagamentoId, kind: "reversal",
      amount: -pedido.credits,
    });
  }
  return new Response("ok");
}

Mini-case: um chat de IA que vende créditos e plano

Fluxo ilustrativo, sem cliente real por trás. Um dev lança um chat que revisa contratos com IA. Cada revisão consome 10 créditos.

1. Lançamento. Ele cria três links no sandbox: 100 créditos por R$ 19,90, 500 por R$ 79,90 e o plano Pro de R$ 49,90 por mês com 400 créditos. Guarda as URLs na tabela credit_packs.
2. Primeira compra. Uma advogada compra 100 créditos no Pix. O webhook chega com cart.src igual ao id do pedido, o handler lança +100 no razão e o chat libera dez revisões. Ela pagou R$ 19,90 e o gateway ficou com R$ 0.
3. Retry. O mesmo evento chega de novo por causa do retry automático. O índice único (payment_id, kind) descarta a segunda linha. Nada de crédito em dobro.
4. Assinatura. No mês seguinte, ela assina o Pro no Pix Automático. A cada ciclo pago, +400 créditos. Quando estoura a cota antes do fim do mês, o chat oferece o pacote avulso, já com a URL e o src prontos.
5. Estorno. Um cliente pede estorno de um pacote que não usou. O dev chama POST /refund; o refunded chega e o handler lança −100 no razão.

O que um app de IA usa do HeroPay

Comece agora

Crie a conta sandbox, cadastre dois pacotes e um plano, registre o webhook e faça a primeira compra de créditos de teste hoje. Quando o razão fechar certo no sandbox, troque a chave e vá pro ar.

Criar conta sandbox · Ler a documentação

Continue por aqui: Link de pagamento · Assinaturas · Webhooks · Pix · Preços · HeroPay para IA · Vibe coding · Guia de vibe coding · Stripe vs HeroPay · AbacatePay vs HeroPay · Glossário