Este simulador de antecipação mostra quanto você paga para receber hoje as vendas do cartão que ainda não liberaram, quanto entra líquido na conta e quanto isso custa em taxa ao mês. Ele não usa uma tabela genérica: a ferramenta monta o comando curl pronto da simulação real do HeroPay (GET /financial/anticipation_simulation), que calcula a taxa exata para a sua conta, sobre as vendas que de fato entram na composição. O saque é sem tarifa. Você roda o comando no seu terminal (a sua chave de API nunca entra nesta página), cola a resposta de volta e a ferramenta traduz tudo em reais. Nada é efetivado. Com o número na mão, o simulador compara com esperar e avisa quando antecipar não vale a pena.
Criar conta sandbox Ler a documentação
O essencial em 60 segundos
- O custo da antecipação no HeroPay aparece na simulação, antes de você decidir. Não há tabela fixa publicada: a taxa depende das vendas que entram na composição e do prazo de cada uma (documentação, setembro de 2026).
- Esta ferramenta monta o curl da simulação real da sua conta e lê a resposta que você cola de volta. Ela nunca pede a sua chave de API: o comando usa a variável
$HEROPAY_JWT_TOKENdo seu terminal. - O custo real de antecipar é só a taxa de antecipação, porque o saque no HeroPay é sem tarifa, antecipando ou esperando.
- O simulador converte a taxa simulada em custo efetivo ao mês, o número certo para comparar com empréstimo, desconto de fornecedor ou crédito do seu banco.
- O limite padrão é até 95% do valor líquido elegível no cartão (5% ficam de reserva), e a elegibilidade depende do risco da conta.
- Prefere não usar o terminal? O mesmo cálculo está no painel em app.heropay.tech.
A ferramenta
1. Rode no terminal
O comando usa a variável $HEROPAY_JWT_TOKEN do seu terminal: a sua chave nunca é digitada nesta página e nada é efetivado (a simulação é somente leitura).
curl -G "https://api.beta.heropay.tech/financial/anticipation_simulation" \
-H "Authorization: Bearer $HEROPAY_JWT_TOKEN" \
-H "Accept: application/vnd.herospark.com; version=1" \
--data-urlencode "amount_cents=1000000"Conta não habilitada? Confira o saldo
Se allow_anticipation vier false, a conta não está habilitada para antecipar naquele momento.
curl "https://api.beta.heropay.tech/financial/balance" \
-H "Authorization: Bearer $HEROPAY_JWT_TOKEN" \
-H "Accept: application/vnd.herospark.com; version=1"Prefere ver no painel? O mesmo cálculo está em app.heropay.tech.
2. Cole a resposta
Nenhum número de taxa aparece aqui antes da resposta colada: a taxa é a que a API devolve para a sua conta.
Metodologia: de onde vem cada número
| Item | Valor usado | Fonte | Verificado em |
|---|---|---|---|
| Taxa de antecipação HeroPay | a que a API devolve para a sua conta, naquele momento (anticipation_fees); nenhuma taxa embutida na ferramenta | GET /financial/anticipation_simulation, docs.heropay.tech/withdrawals | a cada simulação |
| Saque HeroPay | sem tarifa de saque | /precos | setembro de 2026 |
| Limite antecipável | até 95% do valor líquido elegível (5% de reserva), por transações inteiras | docs.heropay.tech/withdrawals | setembro de 2026 |
| Prazo do cartão sem antecipar | D+30 no cartão | docs.heropay.tech/withdrawals | setembro de 2026 |
Três escolhas de método que você deve conhecer:
- A fonte da verdade é a simulação da API, e a ferramenta só a lê. Na conta real, cada venda tem o seu prazo e a composição é feita por transações inteiras, das maiores para as menores, até o limite. Por isso o valor efetivado pode ser um pouco menor que o pedido, e a ferramenta mostra o máximo que a API devolveu.
- O custo efetivo é só a taxa de antecipação. O saque no HeroPay é sem tarifa, então antecipar e esperar só diferem pela taxa que a simulação devolve. O líquido mostrado é o que entra na conta.
- O prazo em dias é seu, não da API. A simulação não recebe prazo; você informa em quantos dias o dinheiro cairia para a ferramenta converter a taxa simulada em custo ao mês. Se as vendas da composição tiverem prazos diferentes, use o prazo médio.
Como calcular o custo efetivo de uma antecipação?
Uma taxa em reais, sozinha, não diz se a antecipação é cara ou barata: depende de quantos dias ela adianta. Para comparar antecipação com qualquer outra fonte de dinheiro, converta tudo para custo ao mês.
A conta tem três passos, a partir do que a simulação devolveu:
- Taxa em reais: o
anticipation_feesda resposta, convertido de centavos. - Custo no período: taxa ÷ (valor − taxa). Você recebe o valor menos a taxa hoje e "devolve" o valor cheio quando as vendas liberariam.
- Equivalente mensal: (1 + custo no período)^(30 ÷ dias) − 1.
Exemplo com os números ilustrativos da referência da API (não uma tabela de preço): taxa de R$ 44,36 sobre R$ 872,45. Custo no período: 44,36 ÷ 828,09 = 5,36%. Se essas vendas liberariam em 30 dias, o equivalente mensal é 5,36%; se liberariam em 15 dias, é (1,0536)² − 1 = 11,00% ao mês. O mesmo valor em reais pesa o dobro quando adianta metade do prazo.
Com o número mensal na mão, a comparação fica honesta: se o seu banco empresta mais barato pelo mesmo prazo, use o banco; se o fornecedor dá um desconto à vista maior que a taxa simulada, a diferença é margem. Mais contexto em antecipação de recebíveis e no guia de taxas de pagamento.
Quando não antecipar?
O simulador dispara estes avisos sozinho, mas vale ter a regra na cabeça:
- Quando o buraco se repete todo mês. Antecipar todo mês é pagar a taxa doze vezes por ano sobre o próprio faturamento. Um descasamento estrutural se resolve com prazo, preço ou método de pagamento: plano anual no Pix, data de vencimento diferente, migração da base para Pix Automático.
- Quando o prazo é curto. Adiantar poucos dias pode sair caro em custo mensal. Se a falta é de uma semana, negocie o prazo.
- Quando existe crédito mais barato pelo mesmo prazo. Compare o equivalente mensal com a taxa do seu banco. Se o banco ganhar, use o banco.
- Quando o dinheiro não gera margem. Antecipar para pagar despesa fixa só antecipa o aperto do mês seguinte. A pergunta é "quanto de lucro esse dinheiro gera?", não "quanto de faturamento".
- Quando o seu chargeback está subindo. Com mais risco, a elegibilidade cai, e o chargeback de uma venda já antecipada vira débito no saldo. Veja a calculadora de chargeback.
- Quando dá para vender no Pix. Pix custa R$ 0 no HeroPay e cai na hora. Um desconto à vista no Pix costuma custar menos que antecipar o cartão. O checkout tem preço especial à vista no Pix por oferta.
Antecipação ou empréstimo: qual sai mais barato?
São coisas diferentes. A antecipação adianta dinheiro de vendas já feitas: não cria dívida e o limite é o que você vendeu. O empréstimo de capital de giro é dinheiro novo, com análise de crédito, prazo e parcelas. A antecipação é mais simples e rápida para valores dentro do seu recebível; o empréstimo pode ser melhor para necessidade grande e longa.
A forma certa de escolher é a que o simulador faz: colocar os dois no mesmo prazo e no mesmo tipo de taxa (equivalente ao mês). Preencha o campo "taxa do crédito que você tem hoje" e a ferramenta diz qual custa menos em reais para o valor e os dias que você informou.
Guias e ferramentas relacionados
- Antecipação de recebíveis no HeroPay: regras, limites e a API completa (saldo, simulação, saque).
- Calculadora de taxas: o custo por transação no seu mix de Pix, cartão e boleto.
- Calculadora de chargeback: o risco que também reduz a sua elegibilidade para antecipar.
- Preços · Pix · Assinaturas · HeroPay vs Asaas
- Glossário: antecipação, recebíveis, reserva de segurança.
Criar conta sandbox Ler a documentação
Perguntas frequentes sobre o simulador de antecipação
Como simular a antecipação de recebíveis do cartão?
Informe o valor que quer antecipar e copie o curl pronto que a ferramenta monta para GET /financial/anticipation_simulation. Rode no seu terminal com a sua chave na variável de ambiente, cole a resposta JSON de volta na página, e a ferramenta mostra a taxa exata da sua conta, o máximo antecipável e o valor líquido em reais. Se você informar em quantos dias o dinheiro cairia, ela converte a taxa em custo ao mês. Nada é efetivado, e a sua chave nunca passa pela página.
Quanto custa antecipar R$ 10.000 no HeroPay?
O valor exato é o que a simulação devolve para a sua conta, naquele momento. O HeroPay não publica tabela fixa de antecipação porque o custo depende das vendas que entram na composição e de quantos dias falta para cada uma liberar. Simule R$ 10.000 aqui, pelo curl ou no painel: a resposta traz a taxa de antecipação e o líquido, e o saque é sem tarifa. Só antecipe se o lucro que esse dinheiro gera superar a taxa.
Preciso colocar a minha chave de API no site?
Não, e é de propósito: a página nunca pede nem recebe a sua chave. Ela monta o comando curl com a variável de ambiente $HEROPAY_JWT_TOKEN, você roda no seu terminal, onde a chave já vive, e cola só a resposta JSON de volta. Assim a chave não trafega pelo site, não vai para URL, analytics nem armazenamento local. E a simulação é somente leitura: nenhuma operação que movimente dinheiro é feita. Prefira uma chave do sandbox para testar.
O que é o custo efetivo da antecipação?
É a taxa convertida para o mesmo padrão de comparação, geralmente ao mês. Você divide a taxa em reais pelo valor que recebe hoje e ajusta para 30 dias. A mesma taxa em reais pesa muito mais quando adianta poucos dias: por isso antecipar para cobrir uma semana costuma ser a forma mais cara de usar a antecipação. É esse número que você compara com empréstimo, crédito do banco ou desconto de fornecedor.
Qual é o custo de não antecipar?
Financeiramente, zero: você espera o prazo e recebe o valor cheio, e o saque é sem tarifa. A diferença entre o líquido de esperar e o líquido de antecipar é exatamente a taxa de antecipação que a simulação mostra. O custo de não antecipar só existe se o dinheiro, na sua mão hoje, gerar mais lucro do que essa taxa.
Antecipar vale a pena?
Vale quando o uso é pontual e o dinheiro gera mais lucro do que a taxa: tráfego com retorno comprovado, estoque com desconto à vista maior que a taxa, janela sazonal que não volta. Não vale para cobrir um déficit que se repete todo mês, para prazos muito curtos ou quando existe crédito mais barato pelo mesmo prazo. Preencha o campo de lucro esperado no simulador: ele compara com a taxa simulada e diz "vale" ou "não vale" em reais.
Quanto posso antecipar no HeroPay?
Até 95% do valor líquido elegível das suas vendas no cartão; os outros 5% ficam como reserva de segurança. A elegibilidade e o percentual dependem do risco da conta: índice de estorno, chargeback e recusa, nicho e histórico. Se GET /financial/balance retornar allow_anticipation: false, a conta não está habilitada naquele momento; o simulador mostra o curl desse endpoint e avisa quando você cola uma resposta assim.
Dá para antecipar Pix ou boleto?
Não, e não precisa. A antecipação do HeroPay vale só para vendas no cartão de crédito. Pix e boleto custam R$ 0 por transação; o Pix cai na hora e o boleto fica disponível 2 dias após a aprovação. Se o problema é caixa rápido, incentivar o Pix, por exemplo com preço especial à vista no checkout, costuma sair mais barato do que vender no cartão e antecipar depois.
O simulador considera vendas parceladas?
A simulação da API calcula sobre as vendas a receber no cartão que entram na composição da sua conta, e o simulador mostra exatamente o que ela devolver, sem estimar nada por fora. Para o custo mensal, informe o prazo médio das vendas que você quer adiantar.