Antecipação de recebíveis: simule antes, antecipe só o que quiser

Antecipação de recebíveis é receber hoje o dinheiro de vendas no cartão que só cairiam na sua conta daqui a alguns dias ou semanas, pagando uma taxa por isso. No HeroPay ela é opcional, vale para vendas no cartão de crédito e o custo aparece antes de você decidir: o endpoint GET /financial/anticipation_simulation (e a mesma simulação no painel) devolve a taxa exata em centavos e o valor líquido que vai entrar. O saque não tem tarifa, então o custo de antecipar é só a taxa de antecipação. Você só efetiva se a conta fechar. Quem não antecipa não paga nada.

Criar conta sandbox · Ler a documentação

O que é antecipação de recebíveis e quando faz sentido?

Recebível é o dinheiro de uma venda já feita que ainda não está disponível. No cartão de crédito, o comprador paga à operadora ao longo das faturas, e o vendedor recebe depois: no HeroPay, a venda no cartão fica disponível em 30 dias após a aprovação (D+30), conforme a documentação. Antecipar é trocar esse prazo por uma taxa.

Não é empréstimo: você não contrata dívida nem paga parcela depois. O dinheiro já é seu; você só paga para ter antes. Por isso a pergunta certa nunca é "posso antecipar?", e sim "o que eu vou fazer com esse dinheiro rende mais do que ele custa?".

Faz sentido quando o caixa antecipado vira margem maior que a taxa:

• Tráfego que já provou retorno. Sua campanha devolve lucro de forma consistente e o limite é o caixa para pagar o anúncio antes de o cartão liquidar.
• Estoque com desconto à vista. O fornecedor dá 8% para pagar hoje e a simulação mostra um custo de antecipação menor que esses 8%. A diferença é margem.
• Janela que não volta. Lançamento, Black Friday, lote de matéria-prima com preço travado.

Não faz sentido quando o dinheiro vai tapar um buraco que se repete todo mês. Aí a antecipação só adia o problema e cobra por isso (mais na seção Antecipação ou empréstimo).

Quanto custa antecipar recebíveis no HeroPay?

O custo exato aparece antes de você decidir. Em vez de uma tabela genérica, o HeroPay calcula a taxa de antecipação para a sua conta, para aquele valor e para os prazos reais das suas vendas, e mostra o resultado na simulação: pela API, em GET /financial/anticipation_simulation, ou no painel. O saque para a sua conta não tem tarifa, então esse é o custo inteiro. Sem mensalidade e sem custo para quem não antecipa. Fonte: documentação de saques e antecipação, setembro de 2026.

Por que simular em vez de consultar uma tabela:

1. O prazo de cada venda muda a conta. Duas antecipações do mesmo valor custam diferente se uma adianta vendas que liberariam em poucos dias e a outra, vendas que ainda têm semanas pela frente. A simulação olha as vendas que de fato entram na composição.
2. A composição é feita por transações inteiras. O valor que você pede pode não ser o valor efetivado (veja limites); a simulação já devolve o máximo antecipável e calcula sobre ele.
3. Simular é grátis e não efetiva nada. Pode chamar quantas vezes quiser, comparar valores diferentes e só então decidir.

A regra de decisão que usamos em todos os exemplos desta página: só antecipe se o lucro (não o faturamento) que o dinheiro vai gerar for maior que a taxa de antecipação simulada. Vendeu parcelado? Não suponha quais parcelas entram na conta: a simulação mostra o máximo antecipável e o custo para a sua carteira real, naquele momento.

Como funciona a antecipação no HeroPay?

Do ponto de vista do dinheiro, em cinco passos:

1. A venda aprova no cartão. O valor líquido entra como saldo a receber (unavailable_balance_cents em GET /financial/balance) e só fica disponível para saque em 30 dias após a aprovação (D+30), conforme a documentação.
2. Você consulta quanto pode antecipar. GET /financial/balance mostra allow_anticipation (se a conta está habilitada) e anticipation_value_cents (quanto é antecipável agora).
3. Você simula. GET /financial/anticipation_simulation?amount_cents=1000000 calcula a taxa e o valor líquido sem efetivar nada. Se você pedir mais que o disponível, a resposta mostra o máximo (maximum_anticipation) e calcula sobre ele.
4. Você decide e efetiva. POST /financial/withdrawals com withdrawal_type: "anticipation", o valor e a chave Pix de destino. A composição é feita por transações inteiras, das de maior valor para as de menor, até o limite.
5. O dinheiro sai para a sua chave Pix. O saque nasce pending, passa a in_progress e termina complete, e a taxa cobrada fica registrada em anticipation_fees_cents.

Na prática, por código

Toda chamada leva o Bearer JWT e o header de versão. No sandbox, use https://api.beta.heropay.tech; em produção, https://api.heropay.tech (autenticação).

curl "$HEROPAY_API_URL/financial/balance" \
  -H "Authorization: Bearer $HEROPAY_JWT_TOKEN" \
  -H "Accept: application/vnd.herospark.com; version=1"

{
  "data": {
    "id": "783af578-5a09-4069-8fca-d37933f9d63f",
    "document_id": "41541121805",
    "document_type": "cpf",
    "available_balance_cents": 0,
    "available_balance_currency": "R$ 0,00",
    "unavailable_balance_cents": 0,
    "unavailable_balance_currency": "R$ 0,00",
    "available_balance_to_withdrawal": 0,
    "fix_withdrawal_fee": 0,
    "anticipation_value_cents": 0,
    "anticipation_value_currency": "R$ 0,00",
    "allow_anticipation": false,
    "absorbent_fees": false
  },
  "message": "Success"
}

curl -G "$HEROPAY_API_URL/financial/anticipation_simulation" \
  -H "Authorization: Bearer $HEROPAY_JWT_TOKEN" \
  -H "Accept: application/vnd.herospark.com; version=1" \
  --data-urlencode "amount_cents=100000"

{
  "data": {
    "fix_withdrawal_fee": 0,
    "anticipation_fees": 4436,
    "total_amount_of_anticipation": 828.09,
    "maximum_anticipation": 87245
  }
}

curl "$HEROPAY_API_URL/financial/pix_accounts" \
  -H "Authorization: Bearer $HEROPAY_JWT_TOKEN" \
  -H "Accept: application/vnd.herospark.com; version=1"

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": "649b20fd-2772-49b4-8cf1-e62805a0132e",
      "amount_cents": 87245,
      "withdrawal_type": "anticipation"
    }
  }'

{
  "message": "Withdrawal created successfully",
  "data": {
    "id": "16dfdeb4-b21e-4552-9851-36d4fa7f9e08",
    "created_at": "25/07/2025 - 22:05",
    "recipient_id": "efddfde9-6bbb-4bdf-b627-49350ccc937e",
    "bank_account_id": "649b20fd-2772-49b4-8cf1-e62805a0132e",
    "amount_cents": 87245,
    "amount_currency": "R$872,45",
    "fees_cents": 0,
    "fees_currency": "R$0,00",
    "anticipation_fees_cents": 4436,
    "anticipation_fees_currency": "R$44,36",
    "withdrawal_type": "anticipation",
    "responsible": null,
    "status": "pending",
    "confirmation_date": null
  }
}

curl "$HEROPAY_API_URL/financial/withdrawals" \
  -H "Authorization: Bearer $HEROPAY_JWT_TOKEN" \
  -H "Accept: application/vnd.herospark.com; version=1"

Por prompt, 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í a simulação vira pedido em português:

Com base em https://heropay.tech/llms.txt, escreva o script que consulta
quanto eu consigo antecipar hoje, simula antecipar R$ 10.000 e mostra a
taxa de antecipação e quanto entra líquido. Só chame o saque se a taxa
de antecipação ficar abaixo de R$ 650, e peça minha confirmação antes.

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.

Uma boa prática: deixe o código simular à vontade, mas exija sua confirmação antes de qualquer POST /financial/withdrawals. Simular é grátis; sacar movimenta dinheiro. Mais em /ai.

Como funcionam os saques no HeroPay?

Antecipação e saque usam o mesmo trilho: o dinheiro sai do seu saldo HeroPay para uma chave Pix aprovada no mesmo CPF/CNPJ da conta. As regras, segundo a documentação de saques (setembro/2026):

Para a antecipação, acompanhe o andamento pelo status e pela confirmation_date do saque em GET /financial/withdrawals, em vez de presumir o mesmo relógio do saque comum.

Um saque comum (withdrawal_type: "default") usa o saldo já disponível e não paga nada. A antecipação usa saldo a receber do cartão e paga só a taxa de antecipação. Pela API: POST /financial/withdrawals para pedir, GET /financial/withdrawals para listar o histórico. Pelo painel: app.heropay.tech.

Casos de uso, com a conta em reais

Infoprodutor: caixa para escalar tráfego no meio do lançamento

O lançamento vendeu R$ 40.000 no cartão na primeira semana e as campanhas estão devolvendo lucro. O caixa para pagar o anúncio acabou; o cartão ainda não liberou. Você simula antecipar R$ 10.000 e a API devolve a taxa exata e o valor líquido. A regra de decisão: se o valor líquido investido em mídia gera mais lucro (não faturamento) do que a taxa simulada antes do fim do carrinho, vale. Se a campanha está no limite do retorno, não vale: você paga taxa para comprar tráfego que empata.

E-commerce: estoque com desconto à vista

O fornecedor oferece 8% de desconto num lote de R$ 20.000 pago hoje: o desconto vale R$ 1.600. Simule antecipar R$ 20.000. Se a taxa de antecipação devolvida ficar abaixo de R$ 1.600, a diferença é margem a favor e o estoque chega antes da concorrência. Se ficar acima, a conta inverte e o melhor é pagar no prazo normal.

SaaS: quando a resposta é não antecipar

Um SaaS fatura R$ 30.000 por mês em assinatura no cartão e fecha a folha no dia 5, antes de o cartão liberar. Antecipar todo mês significa pagar a taxa de antecipação sobre boa parte do faturamento, doze vezes por ano, para resolver um descasamento que é estrutural. Simule uma vez e multiplique por 12: é esse o custo anual do atalho. O caminho mais barato: oferecer o plano anual no Pix com desconto, mover a data da folha ou migrar parte da base para Pix Automático, que custa R$ 0 e cai na hora. Veja /assinaturas.

Antecipação ou empréstimo: quando NÃO antecipar

Antecipação e empréstimo resolvem problemas diferentes. A antecipação adianta dinheiro que já é seu, sem dívida e sem análise longa, mas só até o limite das vendas feitas. O empréstimo de capital de giro não depende de vendas passadas, pode ter prazo longo e parcela diluída, mas cria dívida e passa por análise de crédito. Compare sempre o custo efetivo pelo mesmo prazo, não a taxa anunciada.

Não antecipe quando:

• O buraco se repete todo mês. Antecipação recorrente é pagar juros sobre o próprio faturamento para sempre. Resolva o descasamento (prazo, preço, método de pagamento) em vez de financiá-lo.
• O prazo é curto. Se a falta é de poucos dias, compare o custo que a simulação devolve com o custo de negociar o prazo do fornecedor; muitas vezes a negociação sai de graça.
• Você tem uma alternativa de crédito mais barata para o mesmo prazo. Se o custo efetivo do seu banco para o mesmo prazo for menor que o que a simulação devolve, use o banco. Pagamos essa honestidade de bom grado.
• O dinheiro vai para algo que não gera margem. Antecipar para pagar despesa fixa não aumenta o que entra; só antecipa o aperto do mês seguinte.
• Seu índice de chargeback está subindo. Com mais risco, a elegibilidade cai e o chargeback de uma venda já antecipada vira débito no saldo. Arrume a operação antes. Veja /antifraude.
• Dá para vender no Pix. Pix custa R$ 0 e cai na hora. Um desconto à vista no Pix costuma custar menos que vender no cartão e antecipar depois; compare com a simulação.

Limites e regras honestas

• Só cartão de crédito. Pix e boleto não têm antecipação: o Pix cai na hora e o boleto fica disponível 2 dias após a aprovação.
• Não antecipa 100%. O padrão é até 95% do valor líquido elegível, com 5% de reserva de segurança.
• Transações inteiras. O sistema escolhe vendas completas, das de maior valor para as de menor; uma venda que ultrapassa o limite fica de fora, e não existe antecipação parcial de uma única transação. Por isso o valor efetivado pode ser menor que o pedido.
• Elegibilidade por risco. O percentual máximo e a própria liberação variam com índice de estorno, chargeback e recusa, nicho do produto e histórico. A antecipação pode ser negada naquele momento se a composição não respeitar a reserva.
• O custo varia por conta, prazo e momento. Não há tabela fixa de antecipação: a resposta da simulação é a fonte da verdade para cada operação.
• Não há antecipação automática programada nem webhook de antecipação na v1. Você decide cada operação. Se quiser rotina, agende a simulação no seu código e defina o teto de custo.

Comece pela simulação

Crie a conta, faça uma venda de teste no cartão e chame a simulação. Você vê o custo em reais antes de mexer em um centavo.

Criar conta sandbox · Ler a documentação

Continue por aqui: Preços · Pix · Checkout · Assinaturas · Webhooks · API para desenvolvedores · HeroPay com IA · Guia de taxas de pagamento · Calculadora de taxas · Asaas vs HeroPay · Glossário