Guia
33 min de leitura · 6.627 palavras

Pix para negócios: o guia completo de quem recebe

Guia do Pix para quem recebe: como funciona por dentro, taxa Pix para CNPJ e PF, Pix Automático, parcelamento via Pix, MED, golpes e integração por API.

A taxa Pix para quem recebe depende de quem é você e de onde você recebe: pessoa física tem Pix gratuito por regra do Banco Central, mas o banco pode cobrar quando o recebimento é comercial; empresa com CNPJ paga o que o banco ou o gateway cobrar, que em setembro de 2026 ia de R$ 0 a 1,19% por Pix entre os provedores com preço público. Este guia explica o Pix por dentro (SPI, DICT e participantes), o que muda para quem recebe, as modalidades para negócio (cobrança avulsa, Pix Automático, parcelamento via Pix, Pix Saque e Troco), uma tabela de tarifas datada, como usar o Pix no checkout sem perder a venda no cartão, como se proteger do MED e dos golpes contra lojista e como integrar por API Pix com webhook. No HeroPay, receber Pix custa R$ 0 por transação.

Resumo

O essencial em 60 segundos

  • O Pix é operado pelo Banco Central: o SPI liquida as transações entre instituições em segundos, 24 horas por dia, e o DICT guarda as chaves Pix e os dados da conta de quem recebe (BC, Sobre o Pix).
  • Para pessoa física, MEI e empresário individual, enviar Pix e receber transferência é gratuito; o banco pode cobrar quando o Pix recebido é pagamento de venda, como acima de 30 recebimentos no mês ou por QR Code dinâmico (Resolução BCB nº 19/2020).
  • Para CNPJ não há gratuidade obrigatória: a tarifa é a do provedor. Em 23/09/2026: HeroPay R$ 0, AbacatePay R$ 0,80, Asaas R$ 1,99 e Stripe 1,19% (só por convite) por Pix recebido.
  • O negócio tem quatro formas de cobrar no Pix: cobrança avulsa (QR Code ou copia e cola), Pix Automático para recorrência, parcelamento via Pix concedido pelo vendedor e, na loja física, Pix Saque e Pix Troco.
  • O Pix não tem chargeback. O MED devolve dinheiro só em fraude, golpe, coerção ou falha operacional, com prazo de até 80 dias para contestar; desacordo comercial fica fora (BC, Segurança no Pix).
  • Os golpes mais comuns contra lojista são comprovante falso, comprovante de Pix agendado e pedido de "devolução" para outra conta. A defesa é a mesma: libere o pedido pelo evento de pagamento confirmado, nunca pelo print.
  • Para integrar, você não precisa ser participante do Pix: um gateway entrega o link de pagamento com QR Code e avisa por webhook. No HeroPay, payment_pix_created chega quando o Pix é gerado e spark_payment_confirmed quando é pago.

Parte 1: como o Pix funciona por dentro

O que é o Pix, do ponto de vista de quem recebe?

É um arranjo de pagamento instantâneo criado e operado pelo Banco Central, em que o dinheiro sai de uma conta e chega em outra em poucos segundos, a qualquer hora e em qualquer dia, inclusive feriados (BC). Para quem vende, três propriedades mudam a operação: a liquidação é imediata (não existe "aguardando compensação" como no boleto), o pagamento é final (não há chargeback como no cartão) e o custo é baixo porque não há bandeira nem adquirente no meio.

O Banco Central tem dois papéis no Pix: é o regulador, que define as regras, e o gestor das plataformas, que opera a infraestrutura tecnológica (BC). Essa infraestrutura tem duas peças.

O que é o SPI?

O SPI (Sistema de Pagamentos Instantâneos) é a infraestrutura centralizada de liquidação do Pix: quando um cliente do banco A paga um cliente do banco B, é no SPI que o dinheiro passa de uma instituição para a outra, em tempo real, todos os dias do ano. Participantes diretos liquidam no próprio SPI, com conta no BC (bancos comerciais são obrigatoriamente diretos); participantes indiretos liquidam por intermédio de um direto (BC, Participantes). Pix entre clientes da mesma instituição pode ser liquidado nos sistemas dela, fora do SPI.

O que é o DICT e o que a chave Pix tem a ver com ele?

O DICT (Diretório de Identificadores de Contas Transacionais) é a base de dados, gerida pelo Banco Central, que liga cada chave Pix aos dados de quem recebe: nome, CPF ou CNPJ, instituição, agência, conta, tipo de conta e datas de criação (BC, DICT). Quando o comprador digita sua chave, o banco dele consulta o DICT e mostra seu nome antes de confirmar. É por isso que um Pix para chave errada costuma ser pego na tela de confirmação.

Regras de chave que importam para empresa, segundo o Manual Operacional do DICT, versão 8.5 (atualizado em julho/2026):

  • CNPJ pode vincular até 20 chaves por conta; CPF, até 5 (CPF, CNPJ, e-mail, celular ou chave aleatória).
  • A chave CNPJ já é armazenada no formato alfanumérico, com 14 caracteres. Se o seu sistema valida CNPJ como "só números", ele vai quebrar com os CNPJs novos.
  • O DICT guarda as marcações de fraude: se uma chave, um CPF ou um CNPJ esteve em fraude confirmada, os bancos veem o alerta quando alguém tenta pagar para ele.

Quem são os participantes do Pix?

O BC define quatro papéis: provedor de conta transacional (banco, cooperativa, fintech ou instituição de pagamento que oferece a conta), iniciador de transação de pagamento (inicia o Pix de dentro do site onde a pessoa compra), liquidante especial (só liquida para outras instituições) e ente governamental (Tesouro Nacional). A participação é obrigatória para instituições autorizadas pelo BC com mais de 500 mil contas ativas, e há mais de 900 participantes (BC, Participantes; BC, Sobre).

A consequência para o seu negócio: você não precisa virar participante para receber Pix. Você recebe por um participante (seu banco) ou por um gateway que opera com um e entrega a camada de produto: checkout, QR Code, webhook, conciliação e relatório. E o público já está lá: mais de 170 milhões de pessoas físicas usaram Pix, 80% da população, com recorde de 313.339.828 transações num dia, em 5/12/2025 (BC, Pix em números, consultado em 23/09/2026).

O Pix tem limite de valor?

Não há mínimo; o máximo é do banco de quem paga, e três limites do comprador afetam o seu ticket alto (BC, Sobre; BC, Segurança): depois das 20h, R$ 1.000 para pessoa física (um curso de R$ 1.997 numa live às 21h pode travar); dispositivo não cadastrado, R$ 200 por transação e R$ 1.000 por dia; e aumento de limite leva 24 a 48 horas. Para ticket acima de R$ 1.000, mantenha cartão parcelado e parcelamento via Pix no mesmo checkout.

Parte 2: o que muda para quem recebe

O Pix é gratuito para quem paga?

Para pessoa física, sim. A Resolução BCB nº 19/2020 veda tarifa de pessoa natural, incluindo empresário individual, no envio de Pix e no recebimento de transferência (Resolução BCB nº 19/2020); no Pix Automático, a gratuidade do pagador é regra expressa (FAQ Pix Automático, item 1.10). Consequência comercial: o comprador nunca vê tarifa no Pix. O custo, quando existe, é de quem recebe.

Vendo como pessoa física (CPF): pago taxa Pix?

Pode pagar. A gratuidade da pessoa física cobre transferência, não venda. O banco está autorizado a cobrar quando o Pix recebido tem finalidade de compra, por exemplo (Resolução BCB nº 19/2020; explicação em CNN Brasil):

  • a partir do 31º Pix recebido no mês;
  • no recebimento por QR Code dinâmico;
  • no recebimento por QR Code (estático ou dinâmico) pago por pessoa jurídica;
  • em conta contratada como de uso exclusivamente comercial.

O banco precisa avisar antes de cobrar. E há um problema que não é tarifa: misturar receita de venda com a conta pessoal complica imposto e conciliação; alinhe com o seu contador antes de escalar.

E o MEI?

O MEI é empresário individual, então tem a mesma gratuidade da pessoa física no envio e no recebimento de transferência, e as mesmas exceções quando recebe venda. Ao mesmo tempo, o MEI tem CNPJ ativo e por isso pode receber Pix Automático, que o BC reserva a pessoa jurídica (FAQ Pix Automático, item 1.4). É o melhor dos dois mundos para quem está começando.

Qual é a taxa Pix para CNPJ?

Não existe tarifa oficial: para pessoa jurídica, o BC não impõe gratuidade e cada instituição define a sua. A "taxa Pix para empresas" aparece em três formatos:

  1. Percentual por Pix recebido (ex.: 1,19% no Stripe). Pesa mais no ticket alto.
  2. Valor fixo por Pix recebido (ex.: R$ 0,80 na AbacatePay, R$ 1,99 no Asaas). Pesa mais no ticket baixo.
  3. Zero por transação, com custo em outro lugar (tarifa de saque, mensalidade de conta ou pacote). Vale conferir onde o custo foi parar. No HeroPay, não foi para lugar nenhum: R$ 0 por Pix recebido, valor liberado na hora no saldo e saque sem tarifa.

A pergunta certa não é "quanto é a taxa", é quanto sai por mês no seu mix. A Parte 4 faz a conta.

Banco ou gateway: onde receber o Pix do negócio?

Você precisa deConta PJ em bancoGateway de pagamento
Receber Pix por chave, no balcão ou por WhatsAppResolveResolve
Checkout com Pix, cartão e boleto lado a ladoNão costuma terÉ o produto
Saber por webhook que o pedido X foi pagoDepende da API do bancoNativo
Pagar boletos, folha e fornecedoresResolveGeralmente não

Se você só recebe no balcão e paga contas da mesma conta, uma conta PJ digital serve. O gateway de pagamento entra quando o Pix precisa conversar com o seu sistema: pedido, acesso, assinatura, nota fiscal.

Parte 3: as modalidades de Pix para negócio

Cobrança avulsa: QR Code estático, dinâmico e copia e cola

É o Pix de uma venda. O QR Code estático carrega só a chave (e, se quiser, um valor fixo) e serve para vários pagamentos iguais, como o QR impresso no caixa, mas não identifica o pedido. O dinâmico é gerado para uma cobrança específica, com valor, identificador e validade, e sua geração exige certificados digitais, o que protege contra adulteração (BC, Segurança). O Pix copia e cola é o mesmo conteúdo em texto, para quem compra no próprio celular.

Quando usar: toda venda única, online ou por WhatsApp, com QR dinâmico e copia e cola lado a lado. No HeroPay, sai de um link de pagamento ou do checkout, a R$ 0. O BC também padroniza o QR com vencimento, juros e multa (Pix Cobrança); no HeroPay a v1 não tem QR solto com vencimento, e quem paga depois usa boleto (R$ 0) ou parcelamento via Pix.

Pix Automático: a assinatura sem cartão

É a modalidade para cobrança recorrente, no ar desde 16 de junho de 2025: o cliente autoriza uma vez no app do banco e as cobranças seguintes são debitadas sozinhas, dentro da autorização, com aviso prévio de 2 a 10 dias e cancelamento pelo próprio cliente (FAQ Pix Automático). Toda instituição que oferece Pix para pessoa física é obrigada a oferecer o Pix Automático do lado de quem paga. Do lado de quem recebe, é exclusivo de CNPJ ativo.

Quando usar: SaaS, escola, academia, clube, mentoria mensal: tudo o que você perde no cartão recorrente por cartão vencido, bloqueado ou sem limite, o churn involuntário. Quando não usar: cobrança avulsa (o BC não permite) e plano que muda de valor sem aviso, porque reajuste exige nova autorização.

Custo no HeroPay: R$ 0 por cobrança, contra 3,49% no cartão recorrente; numa mensalidade de R$ 97, são R$ 3,39 por renovação que deixam de sair. Regras completas, jornada do comprador e código em /pix-automatico.

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

Muita gente procura "Pix parcelado" querendo saber isso. Primeiro, o contexto: em 4 de dezembro de 2025, o Banco Central desistiu de criar um "Pix Parcelado" oficial e vetou o uso desse nome pelas instituições; "Parcele no Pix" e "Pix no crédito" continuam permitidos (Agência Brasil). Atrás dessa busca há dois produtos diferentes. No "Pix no crédito" do banco do comprador, o banco empresta com juros e você recebe à vista um Pix comum (R$ 0 no HeroPay). No parcelamento via Pix do vendedor, é você quem parcela, sem financeira e sem análise de crédito, e recebe uma parcela por mês, cada uma a R$ 0.

No checkout HeroPay, o comprador paga a primeira parcela na hora e recebe o produto; as seguintes vêm por um novo código Pix enviado por e-mail ou, na modalidade recomendada, pelo Pix Automático autorizado uma vez. Parcela vencida bloqueia o acesso até a regularização. A tabela completa (quem financia, quem assume o risco, quando você recebe) está em /pix.

Quando usar: produto digital ou serviço de ticket médio e alto (R$ 500 a R$ 3.000) vendido para quem não tem cartão ou não tem limite. Uma mentoria de R$ 1.200 em 6 parcelas de R$ 200 no Pix custa R$ 0 de tarifa; no cartão, seriam R$ 41,88 (3,49%), e a venda só aconteceria se o comprador tivesse R$ 1.200 de limite.

Quando não usar: produto físico que sai do estoque no dia (você não tem como "bloquear o acesso" a uma caixa entregue) e vendas em que você precisa do dinheiro todo agora. Aí a escolha é cartão parcelado com antecipação.

Pix Saque, Pix Troco e Pix por aproximação: para quem tem caixa físico

No Pix Saque, a pessoa faz um Pix para a loja e recebe dinheiro vivo; no Pix Troco, paga a compra com um valor a mais e leva a diferença em espécie. Nas regras de lançamento, o limite era de R$ 500 por transação de dia e R$ 100 entre 20h e 6h (Agência Brasil, nov/2021). O estabelecimento que atua como agente de saque recebe no mínimo R$ 0,25 por transação, repassado pelo facilitador (FAQ Participantes do Pix, item 5); o ganho maior é trazer gente para a loja e ter menos dinheiro em caixa.

Quando usar: mercado, farmácia, posto, padaria. O mesmo vale para o Pix por aproximação, pago encostando o celular na maquininha, disponível desde 28 de fevereiro de 2025 (Secom). Honestidade: o HeroPay é infraestrutura para vender online e não oferece Pix Saque, Pix Troco nem Pix por aproximação; no checkout, o Pix sai por QR Code e copia e cola, e Apple Pay e Google Pay atendem o cartão.

Qual modalidade usar em cada caso?

SituaçãoModalidadePor quê
Venda única online, qualquer ticketCobrança avulsa (QR dinâmico + copia e cola)Liga o pagamento ao pedido e confirma em segundos
Assinatura mensal, anual, mensalidadePix AutomáticoRenova sem ação do cliente e sem cartão vencido
Ticket alto para quem não tem cartãoParcelamento via PixVende hoje, recebe por mês, sem financeira
Ticket alto à noite (acima de R$ 1.000)Cartão parcelado ou parcelamento via PixContorna o limite noturno do comprador
Venda por WhatsApp ou InstagramLink de pagamento com PixUm link por produto ou por conversa
Balcão de loja físicaQR estático, Pix por aproximação, Pix Saque e TrocoRapidez no caixa e fluxo de pessoas

Parte 4: quanto custa receber Pix? Tabela de tarifas de 2026

Tabela de tarifas de Pix do mercado

Tarifa por Pix recebido nos provedores com preço público, mais a regra do Banco Central para pessoa física:

Provedor ou regraTarifa por Pix recebidoObservaçãoFonte
HeroPayR$ 0Qualquer valor, à vista, parcela ou Pix Automático; saque sem tarifaheropay.ai/precos
AbacatePayR$ 0,80Valor fixoabacatepay.com/pricing
AsaasR$ 1,99R$ 0,99 nos 3 primeiros mesesasaas.com/precos-e-taxas
Stripe Brasil1,19%Pix só por convite e só em pagamento únicostripe.com/br/pricing
Iugu, MalgaSob consultaNão publicam preçoSites oficiais
Conta PF em banco (regra do BC)R$ 0 em transferênciaBanco pode cobrar em recebimento de venda (31º Pix do mês, QR dinâmico, QR pago por PJ, conta comercial)Resolução BCB nº 19/2020
Conta PJ em bancoTabela de cada bancoSem gratuidade obrigatóriaTabela de tarifas do seu banco

Verificado em 23 de setembro de 2026 nas páginas oficiais. Taxas mudam: confira a fonte antes de decidir. Blogs de mercado citam faixas percentuais para contas PJ de bancos; não reproduzimos porque não verificamos nas tabelas oficiais de cada banco.

A mesma tabela, em reais por Pix

Pix deHeroPayAbacatePay (R$ 0,80)Asaas (R$ 1,99)Stripe (1,19%)
R$ 50R$ 0R$ 0,80R$ 1,99R$ 0,60
R$ 150R$ 0R$ 0,80R$ 1,99R$ 1,79
R$ 500R$ 0R$ 0,80R$ 1,99R$ 5,95
R$ 1.000R$ 0R$ 0,80R$ 1,99R$ 11,90
R$ 2.000R$ 0R$ 0,80R$ 1,99R$ 23,80

Uma regra de bolso para comparar tarifa fixa com percentual: 1,19% empata com R$ 0,80 num Pix de R$ 67,23 e com R$ 1,99 num Pix de R$ 167,23. Abaixo desses valores o percentual sai mais barato; acima, a tarifa fixa ganha. Quem vende ticket baixo sofre com tarifa fixa; quem vende ticket alto, com percentual. A tarifa zero não tem ponto de empate.

A conta do mês: 800 Pix de R$ 150

Uma loja ou infoproduto com ticket médio de R$ 150 e 800 vendas por mês no Pix (R$ 120.000):

HeroPayAbacatePayStripeAsaas
Tarifa por mêsR$ 0R$ 640,00R$ 1.428,00R$ 1.592,00
Tarifa por anoR$ 0R$ 7.680,00R$ 17.136,00R$ 19.104,00

Com as tarifas verificadas em 23/09/2026; não inclui tarifa de saque de nenhum provedor. Refaça com os seus números: tarifa por Pix × Pix por mês × 12.

Ressalva honesta: outros players também anunciam Pix sem tarifa, e a linha do Pix não é a conta inteira. Some cartão, boleto, saque e o que o checkout recupera (/precos; guia de taxas de pagamento).

Parte 5: Pix no checkout, conversão e preço especial à vista

O Pix converte mais que o cartão?

Depende do que você mede. Os dois métodos perdem vendas em lugares diferentes, e é por isso que o checkout que vende mais oferece os dois.

Onde a venda se perdePixCartão
Recusa do emissorNão existe: com saldo e limite de Pix, o pagamento saiExiste; no HeroPay a aprovação é de 93%+
Troca de telaO comprador sai do checkout para o app do banco e pode não voltarPaga sem sair da página
LimiteLimite noturno de R$ 1.000 e de dispositivo novoLimite do cartão
ParcelamentoSó com parcelamento via Pix ou Pix no crédito do bancoNativo, até 12x
Estorno forçado depoisSó MED em fraudeChargeback, inclusive por desacordo

O ponto fraco do Pix é o intervalo entre gerar e pagar: o comprador copia o código, abre o banco, é interrompido e esquece. No HeroPay, payment_pix_created chega quando o Pix é gerado e spark_payment_confirmed quando é pago; o que ficou no meio vira lembrete no seu CRM, além do carrinho abandonado com gatilho de 15 minutos. Meça o seu caso nos relatórios de funil e de distribuição por método da API, não em benchmark de terceiro.

Vale dar desconto no Pix?

Vale, até um limite que você consegue calcular: o desconto que não reduz sua margem é a tarifa que você deixaria de pagar no cartão. No HeroPay, o Pix custa R$ 0 e o cartão 3,49%, sem tarifa fixa, então o desconto neutro é o mesmo 3,49% em qualquer ticket. Em reais:

Ticket no cartãoTarifa no cartãoDesconto neutro no Pix (em % do ticket)Preço no Pix com desconto neutro
R$ 97R$ 3,393,49%R$ 93,61
R$ 297R$ 10,373,49%R$ 286,63
R$ 497R$ 17,353,49%R$ 479,65
R$ 997R$ 34,803,49%R$ 962,20
R$ 1.997R$ 69,703,49%R$ 1.927,30

Não inclui juros de parcelamento: se você absorve os juros do cartão parcelado na oferta, o desconto neutro no Pix é maior.

Descontos acima dessa linha custam margem e só se pagam se aumentarem a conversão ou empurrarem para o Pix quem teria o cartão recusado. O checkout HeroPay tem preço especial à vista no Pix configurado por oferta: o comprador vê o valor menor quando escolhe Pix e o cheio no cartão. Mostre o desconto em reais ("R$ 35 a menos no Pix"), não só em porcentagem.

Checklist de Pix no checkout

  1. QR Code e copia e cola visíveis sem rolar, no celular.
  2. Aviso de que a confirmação é automática ("não precisa mandar comprovante").
  3. Preço especial à vista no Pix, em reais.
  4. Cartão e parcelamento lado a lado, para o ticket que bate no limite noturno.
  5. Lembrete para quem gerou o Pix e não pagou.
  6. Liberação do acesso pelo evento de pagamento, nunca pela página de obrigado.

Mais sobre os recursos de conversão do checkout em /checkout.

Parte 6: segurança, MED, golpes e devolução

O Pix tem chargeback?

Não. O Pix é pagamento final. O que existe é o MED (Mecanismo Especial de Devolução), um conjunto de regras que permite ao banco de quem recebeu debitar a conta do cliente e devolver o dinheiro ao pagador, sem pedir autorização a cada devolução (FAQ Participantes do Pix, item 1). O próprio BC diz que o MED "não é um mecanismo de chargeback" como o dos cartões (item 3).

O MED se aplica a fundada suspeita de fraude, golpe ou coerção e a falha operacional de uma instituição. Não se aplica a desacordo comercial, a dinheiro enviado a terceiro de boa-fé que não participou do golpe nem a Pix errado por falta de conferência (BC, Segurança no Pix).

Como o MED funciona e o que ele faz com o seu saldo?

  1. O pagador contesta pelo botão de contestação do app do banco, obrigatório em todos os bancos desde 1º de outubro de 2025 (Agência Brasil), em até 80 dias da transação (BC).
  2. A instituição de quem recebeu bloqueia o valor (ou o saldo que houver) e tem até 7 dias para analisar.
  3. Confirmada a fraude, o banco do pagador tem 72 horas para pedir a devolução e o do recebedor, 24 horas para devolver (FAQ Participantes, item 11): até 11 dias da contestação, no total.
  4. Com o MED 2.0, obrigatório desde 2 de fevereiro de 2026, o rastreio segue o dinheiro além da primeira conta (Agência Brasil). Motivo: em 2025, o MED recuperou em média só 9,3% do valor contestado (BC, MED 2.0).

Há ainda o bloqueio cautelar: a instituição de quem recebe pode segurar um crédito suspeito por até 72 horas, no momento em que ele entra (BC).

O que isso significa para quem vende de boa-fé: um MED aberto contra uma venda sua pode bloquear saldo enquanto a análise corre, mesmo que no fim a contestação seja rejeitada. Guarde as provas da entrega (log de acesso, rastreio, conversa) para responder rápido quando o seu provedor pedir. No HeroPay, se um Pix seu for contestado, fale com o suporte pela central de ajuda com essas provas em mãos.

Quais são os golpes mais comuns contra o lojista no Pix?

GolpeComo funcionaDefesa
Comprovante falsoPrint editado de um Pix que nunca aconteceuLibere pelo evento de pagamento assinado, nunca pelo print. No HeroPay, spark_payment_confirmed com HMAC em X-HeroPay-Signature
Comprovante de agendamentoAgenda um Pix, manda o comprovante e cancela antes da dataA mesma: se o dinheiro não entrou, o evento não chega
"Paguei a mais, devolve a diferença"Chega um Pix (às vezes dinheiro de golpe) e o pedido de devolver parte para outra chaveDevolva só pela função de devolução, que volta à conta de origem; nunca por Pix novo para a chave indicada
Contestação indevidaRecebe o produto e contesta alegando golpeMED não cobre desacordo, mas bloqueia saldo: evidência de entrega por pedido e política de reembolso clara
Checkout ou QR falsificadoCópia da sua página com o QR do golpistaDomínio próprio, QR dinâmico do seu provedor e orientação para conferir o nome do recebedor, como o BC recomenda

Como devolver um Pix do jeito certo?

A devolução é um tipo próprio de transação no Pix, que volta para a conta de origem. Use-a para reembolso, arrependimento (os 7 dias da compra online valem igual no Pix) e cobrança em duplicidade. No HeroPay, POST /refund estorna um Pix em até 90 dias (data exata em refund_limit_date), com saldo disponível, e o webhook refunded avisa sua aplicação para revogar o acesso (/pix; guia de chargeback).

Parte 7: integração por API Pix

O que é API Pix?

"API Pix" quer dizer duas coisas, e confundir as duas custa semanas. A API Pix do Banco Central é uma especificação pública (bacen/pix-api) que os participantes implementam: cobrança imediata, com vencimento, webhooks e recorrência; para usá-la, você integra com um participante, com certificado, e monta as jornadas. A API de um gateway embrulha o Pix em produto: cria a cobrança, entrega o checkout com QR Code e copia e cola, avisa por webhook e soma o Pix a cartão, boleto e assinatura. Banco ou ERP financeiro pode querer a primeira; quem vende produto ou serviço põe o Pix no ar no mesmo dia com a segunda.

Como integrar Pix no seu sistema, passo a passo

O fluxo auditável, do ponto de vista do seu código, no HeroPay:

  1. Crie a conta sandbox em app.heropay.tech e gere o token. O sandbox (https://api.beta.heropay.tech) é gratuito e idêntico à produção.
  2. Cadastre o webhook de pagamento confirmado com POST /webhook e "trigger": "spark_payment_confirmed". Repita com payment_pix_created se quiser lembrar quem gerou e não pagou.
  3. Crie a cobrança com POST /payment_links e "payment_methods": ["pix"] (valor em centavos, mínimo 500):
curl -X POST "https://api.beta.heropay.tech/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",
      "price_cents": 49700,
      "absorbs_fees": true,
      "payment_methods": ["pix"],
      "src": "whatsapp"
    }
  }'
  1. Mande o comprador para data.offer.url, o checkout com QR Code e copia e cola, por redirecionamento, WhatsApp ou e-mail.
  2. Receba o evento, valide e deduplique. Recalcule o HMAC SHA-256 do corpo bruto com o segredo do painel e compare com X-HeroPay-Signature; descarte o que não bater; deduplique por pagamento e gatilho, porque há retentativa automática quando você não responde 2xx. Confie no evento, não no polling.
  3. Libere o pedido e grave o ID do pagamento para conciliação e para um eventual POST /refund.
  4. Vá para produção trocando a chave e a URL base (https://api.heropay.tech). Sem fila de homologação.

Resposta completa, payload, chave Pix para saque e validação do webhook em Node estão em /pix e em /webhooks; o mesmo fluxo com Pix Automático, em /pix-automatico.

E sem escrever código?

Duas saídas. O link de pagamento criado no painel já entrega QR Code e copia e cola para mandar no WhatsApp. E, se você usa IA para construir, cole o llms.txt e o link da documentação no Claude, ChatGPT, Cursor, Lovable e outros, e o pedido cabe numa frase ("escreve a rota que cria um link de R$ 497 só com Pix e o endpoint do webhook de pagamento confirmado"): a ferramenta gera o código que chama a API REST. O MCP server do HeroPay está em desenvolvimento; o caminho atual está em /ai.

Limites honestos da integração no HeroPay

Sem QR Code solto na v1 (a cobrança sai sempre pelo checkout do link), sem Idempotency-Key (duas chamadas iguais criam dois links) e sem split na v1.

Coloque em prática

Mitos e verdades sobre Pix para negócios

"Pix é de graça para todo mundo." Mito. É gratuito para pessoa física em transferência. Recebimento de venda pode ser tarifado, e para CNPJ a tarifa é livre.

"Pix não tem estorno." Mito. Não tem chargeback, mas tem devolução: você devolve quando quer, e o MED devolve em fraude, golpe, coerção ou falha operacional.

"Comprovante de Pix é prova de pagamento." Mito, para quem vende. Print se edita e agendamento se cancela. Prova é o crédito na conta, que chega pelo evento de pagamento confirmado.

"Pix Automático é igual a débito automático." Mito. O débito automático exige convênio com cada banco; o Pix Automático funciona com qualquer banco que ofereça Pix, e o cliente controla valor máximo e cancelamento no app.

"Pix Parcelado é um produto oficial do Banco Central." Mito. O BC desistiu de regulamentar e vetou o nome em dezembro de 2025. Existem o crédito do banco do comprador e o parcelamento concedido pelo vendedor, como o parcelamento via Pix do HeroPay.

"Para ter API Pix, preciso ser participante do Pix." Mito. Seu negócio integra com a API de um provedor que já opera no Pix.

"O Pix sempre converte mais que o cartão." Nem sempre. Não tem recusa de emissor, mas tem troca de tela e limite noturno. Ofereça os dois e meça no seu funil.

Glossário do tema

  • Pix: pagamento instantâneo criado e operado pelo Banco Central, liquidado em segundos, 24 horas por dia.
  • SPI: Sistema de Pagamentos Instantâneos, a infraestrutura do BC que liquida o Pix entre instituições.
  • DICT: diretório do BC que liga chaves Pix a contas e guarda marcações de fraude.
  • QR Code dinâmico: QR gerado para uma cobrança específica, com valor e identificador.
  • Pix copia e cola: o conteúdo do QR Code em texto, para quem paga no próprio celular.
  • Pix Automático: cobrança recorrente autorizada uma vez no app do banco, exclusiva de recebedor com CNPJ.
  • Parcelamento via Pix: no HeroPay, compra única dividida em parcelas pagas por Pix, concedida pelo vendedor.
  • MED: Mecanismo Especial de Devolução, que devolve Pix em fraude, golpe, coerção ou falha operacional.
  • Bloqueio cautelar: retenção de até 72 horas de um crédito suspeito pela instituição de quem recebe.
  • Webhook: chamada HTTP que o provedor faz ao seu sistema quando algo acontece, como um Pix pago.

Perguntas frequentes sobre Pix para negócios

Qual é a taxa do Pix para empresas?

Não existe taxa oficial: para pessoa jurídica, o Banco Central não impõe gratuidade e cada banco ou gateway define a sua. Em 23 de setembro de 2026, entre os provedores com preço público, o HeroPay cobrava R$ 0 por Pix recebido, a AbacatePay R$ 0,80, o Asaas R$ 1,99 (R$ 0,99 nos três primeiros meses) e o Stripe 1,19%, com Pix só por convite. Contas PJ de bancos seguem a tabela de cada instituição. Compare pelo custo mensal: 800 Pix de R$ 150 custam de R$ 0 a R$ 1.592 por mês, conforme o provedor.

O Pix é gratuito para pessoa física que vende?

Para transferir, sim; para vender, nem sempre. A Resolução BCB nº 19/2020 veda tarifa para pessoa física no envio e no recebimento de transferência, mas autoriza o banco a cobrar quando o Pix recebido é pagamento de compra: a partir do 31º recebimento no mês, por QR Code dinâmico, por QR Code pago por pessoa jurídica ou em conta contratada como comercial. O banco precisa avisar antes de cobrar.

MEI paga taxa no Pix?

O MEI é empresário individual e tem a mesma gratuidade da pessoa física: não paga para enviar Pix nem para receber transferência, e valem as mesmas exceções quando recebe venda. Como tem CNPJ ativo, também pode receber Pix Automático, que o Banco Central reserva a pessoa jurídica. Em um gateway, vale a tarifa do gateway: no HeroPay, R$ 0 por Pix recebido.

O que é API Pix?

São duas coisas. A API Pix do Banco Central é a especificação pública que bancos e instituições participantes implementam, com cobrança imediata, com vencimento, webhooks e recorrência. A API Pix de um gateway embrulha isso em produto: você cria uma cobrança, recebe a URL de um checkout com QR Code e copia e cola e é avisado por webhook. No HeroPay, POST /payment_links com "payment_methods": ["pix"] cria a cobrança e spark_payment_confirmed confirma o pagamento.

Preciso ser banco para ter API Pix?

Não. Participar do Pix é coisa de instituição financeira ou de pagamento, obrigatório só para as autorizadas pelo Banco Central com mais de 500 mil contas ativas. Um SaaS, e-commerce ou infoprodutor integra com a API de um provedor que já opera no Pix, que gera o QR Code, liquida o pagamento e avisa por webhook. No HeroPay, o sandbox é gratuito e idêntico à produção: você testa hoje e vai ao ar trocando a chave.

"Pix parcelado" existe?

Não como produto oficial: em 4 de dezembro de 2025, o Banco Central desistiu de regulamentar o "Pix Parcelado" e vetou o nome. No "Pix no crédito" dos bancos, o banco do comprador empresta e você recebe à vista um Pix comum. No parcelamento via Pix do vendedor, como o do checkout HeroPay, você concede as parcelas, sem financeira nem análise de crédito, recebe uma por mês a R$ 0 cada, e o acesso é bloqueado se uma parcela atrasar.

Qual a diferença entre QR Code estático e dinâmico?

O estático carrega a chave Pix e, se você quiser, um valor fixo; serve para muitos pagamentos iguais, como o QR do caixa, mas não identifica o pedido. O dinâmico é gerado para uma cobrança específica, com valor, identificador e validade, e exige certificados digitais para ser gerado. Para vender online, use o dinâmico: ele liga o pagamento ao pedido e permite confirmação automática por webhook.

Pix Automático serve para qualquer negócio?

Serve para negócio com CNPJ ativo que cobra algo periódico: semanal, mensal, trimestral, semestral ou anual. Não vale para cobrança avulsa nem entre pessoas físicas. O cliente autoriza uma vez no app do banco, é avisado de 2 a 10 dias antes de cada débito e cancela quando quiser. No HeroPay, custa R$ 0 por cobrança e nasce do mesmo link de pagamento, com period e "pix" em payment_methods.

O Pix tem chargeback?

Não. O Pix é pagamento final, e o próprio Banco Central diz que o MED não é um mecanismo de chargeback. O MED devolve dinheiro só em fundada suspeita de fraude, golpe ou coerção e em falha operacional. Desacordo comercial, arrependimento e Pix errado ficam fora: nesses casos, a devolução é sua. Mesmo assim, um MED aberto contra uma venda pode bloquear saldo durante a análise.

O que é o MED e como ele afeta o lojista?

É o Mecanismo Especial de Devolução. O pagador contesta no app do banco em até 80 dias; a instituição de quem recebeu bloqueia o valor e analisa em até 7 dias; confirmada a fraude, a devolução sai em até 11 dias da contestação. Desde fevereiro de 2026, o MED 2.0 rastreia o dinheiro além da primeira conta. Para o lojista de boa-fé, o efeito é saldo bloqueado durante a análise: guarde provas de entrega por pedido.

Como evitar golpe de comprovante falso de Pix?

Não libere pedido por comprovante: print se edita e Pix agendado se cancela antes da data. Libere pela confirmação do provedor. No HeroPay, o webhook spark_payment_confirmed chega quando o Pix é pago, assinado com HMAC SHA-256 no header X-HeroPay-Signature, e você descarta qualquer chamada cuja assinatura não bata. Diga no checkout que a confirmação é automática e que ninguém precisa mandar comprovante.

Posso dar desconto para quem paga no Pix?

Pode, e o limite se calcula: o desconto que não reduz sua margem é a tarifa que você deixaria de pagar no cartão. No HeroPay, com Pix a R$ 0 e cartão a 3,49%, uma venda de R$ 997 paga R$ 34,80 de tarifa no cartão, então R$ 962,20 no Pix mantém a margem. Acima disso, o desconto só compensa se aumentar a conversão. Mostre a diferença em reais.

Existe limite de valor para o comprador pagar no Pix?

Não há mínimo, e o máximo é definido pelo banco de quem paga. Depois das 20h, o limite padrão de pessoa física é R$ 1.000, e dispositivo não cadastrado fica em R$ 200 por transação e R$ 1.000 por dia. Aumentar leva de 24 a 48 horas. Para ticket acima de R$ 1.000, mantenha cartão parcelado e parcelamento via Pix no mesmo checkout.

Pix Saque e Pix Troco valem a pena para a minha loja?

Para loja física com balcão, podem valer: o cliente saca ou leva troco em espécie, e o estabelecimento que atua como agente de saque recebe no mínimo R$ 0,25 por transação, repassado pelo facilitador. O ganho maior é fluxo de pessoas e menos dinheiro em caixa. Para vender online não se aplica, e o HeroPay não oferece esse serviço: contrate com seu banco ou com um facilitador.

Continue aprendendo

Fontes e verificação

Consultadas em 23 de setembro de 2026.

Aplique o guia com uma conta grátis

Teste tudo no sandbox antes de colocar em produção.

Pix e boleto R$ 0 · cartão 3,49% em até 12x · saque sem tarifa