Integração com API Pix é ligar o seu sistema ao banco ou a um gateway de pagamento pra que cada cobrança seja gerada e baixada sozinha. O sistema cria o Pix (ou o boleto, ou o pagamento no cartão) já amarrado ao pedido, o cliente paga, e o banco ou o gateway avisa o sistema. O pedido muda pra pago sem ninguém abrir extrato, procurar comprovante no WhatsApp ou conferir valor por valor.
O problema da chave Pix solta
Muita empresa recebe Pix assim: manda a chave no WhatsApp, o cliente paga, manda o comprovante, alguém confere no app do banco e marca o pedido como pago. Com dez pedidos por dia, dá. Com cem, vira trabalho de meio expediente e fonte de erro: comprovante falso, valor diferente do combinado, dois clientes pagando o mesmo valor no mesmo minuto.
A chave solta não diz de qual pedido é aquele dinheiro. A cobrança Pix gerada pela API resolve isso: cada QR Code (ou código copia e cola) é único, tem valor definido e um identificador que liga o pagamento ao pedido. Quando o dinheiro cai, o sistema sabe exatamente o que foi pago.
Gateway ou API Pix do banco
Existem dois caminhos pra gerar e receber essas cobranças:
| Ponto | API Pix do banco | Gateway de pagamento |
|---|---|---|
| O que oferece | Pix (e, em vários bancos, boleto) direto na conta da empresa | Pix, boleto e cartão no mesmo lugar |
| Integração | Uma por meio de pagamento, com o cadastro e os certificados que o banco exige | Uma integração pra todos os meios |
| Cartão | Precisa de outra solução | Incluído, com parcelamento |
| Split entre recebedores | Depende do banco | Recurso comum, como no Pagar.me |
| Quando faz sentido | Muito Pix e pouca venda no cartão | Loja, marketplace, assinatura, quem vende nos três meios |
As taxas variam por fornecedor, por meio de pagamento e por volume, então a conta vale ser feita no seu caso, com a proposta de cada um na mão. A gente integra Pix, boleto e cartão, inclusive pelo Pagar.me, e escolhe o caminho junto com você.
Baixa automática com webhook de pagamento
Baixa automática é o sistema marcar a cobrança como paga sozinho. Quem dispara isso é o webhook: quando o pagamento é confirmado, o banco ou o gateway chama um endereço do seu sistema e avisa. O sistema confere, muda o status e segue o fluxo: libera o pedido pra separação, manda a confirmação no WhatsApp, emite a nota, gera a etiqueta.
Cada meio de pagamento tem o seu tempo:
- Pix cai na hora, inclusive à noite e no fim de semana, e o aviso costuma chegar logo em seguida.
- Boleto leva alguns dias úteis pra compensar depois que o cliente paga. O sistema precisa mostrar "aguardando compensação", e não "não pago", pra ninguém cobrar quem já pagou.
- Cartão é aprovado ou recusado na hora, mas o dinheiro entra na conta no prazo combinado com o gateway. E pode voltar: a contestação (o chargeback) é um evento que o sistema também precisa receber e tratar.
Os cuidados que separam uma integração boa de uma frágil
- Não dar baixa duas vezes. Webhook pode chegar repetido. Se o sistema não reconhece o aviso que já processou, o cliente recebe dois e-mails, o estoque sai em dobro, a comissão é paga duas vezes.
- Não acreditar no aviso sem conferir. Qualquer um pode tentar chamar o endereço do webhook. O sistema valida a assinatura do aviso ou consulta o gateway antes de marcar como pago.
- Não depender só do aviso. Se um webhook se perder, uma rotina de conferência periódica pega o que ficou pra trás.
- Tratar o caminho de volta. Estorno, cancelamento, boleto vencido, cobrança paga depois do prazo. A integração cobre o pagamento que deu certo e também esses casos.
- Guardar registro. Cada aviso recebido fica salvo, pra resolver qualquer "paguei e não baixou" em minutos.
Esses cuidados valem pra qualquer integração, não só de pagamento. A explicação geral de REST, webhook e do que costuma dar errado está em integração de API.
Split de pagamento: quando o dinheiro tem mais de um dono
Em marketplace, plataforma com parceiros ou venda com comissão, o valor de uma venda pertence a mais de uma pessoa. Sem split, tudo cai na conta da plataforma, e alguém calcula e repassa no fim do mês, com planilha e transferência uma por uma.
Com split, o gateway divide o pagamento conforme a regra que o sistema manda junto com a cobrança: uma parte pro vendedor, outra pra plataforma. O Forja, marketplace de venda local que a gente desenvolveu, usa split de pagamento via Pagar.me. Quando o modelo do negócio não permite split, o próprio sistema pode calcular comissão e repasse, como no LogMoney, que controla comissões e repasses de produtores.
Onde a integração de pagamento faz mais diferença
- Loja virtual. Pedido pago vai direto pra separação. Mais em criação de loja virtual.
- Cobrança recorrente. Mensalidade de escola, academia, contrato de serviço. O sistema gera a cobrança do mês, manda pelo WhatsApp e baixa sozinho.
- Aluguel. A imobiliária cobra o inquilino e repassa ao proprietário. O passo a passo está em sistema para imobiliária de locação.
Um aviso honesto: se você vende pouco, um link de pagamento gerado no painel do gateway e mandado no WhatsApp resolve sem integração nenhuma. A integração começa a se pagar quando a conferência manual toma o tempo de alguém todo dia.
Se hoje alguém da sua equipe passa a manhã conferindo comprovante, chama no WhatsApp contando como você cobra e por quais meios. A gente responde com o orçamento fechado em até 24h.