Voltar ao blog
Build in Public
Cobrança no Brasil: Pix, boleto e os gateways
Integrando Mercado Pago, PagBank e AbacatePay num SaaS — webhooks, conciliação e os detalhes chatos.
Gabriel Ditzel 9 min de leitura
Cobrar no Brasil é um esporte à parte. Pix instantâneo, boleto que compensa em dias, cartão com antecipação — e cada gateway com sua própria visão de mundo.
Webhooks são a verdade
Nunca confie no retorno síncrono de um pagamento. O estado real chega pelo webhook, e ele pode chegar duas vezes, fora de ordem ou nunca.
Conciliação
Todo dia o sistema compara o que ele acha que recebeu com o que o gateway diz ter repassado. Divergência vira alerta, não surpresa no fim do mês.
Múltiplos gateways
- Abstraia o gateway atrás de uma interface única
- Cada provedor implementa a mesma porta
- Trocar de provedor não pode tocar a regra de negócio
Pix matou o boleto para a maioria dos casos, mas o boleto ainda vende. Suporte os dois e deixe o cliente escolher.