Integração · REST · gRPC · Pagamentos
APIs e Gateways de Pagamento
Fazer dois sistemas conversarem quando um deles não quer. É o trabalho que ninguém quer pegar e que eu gosto.
O problema nunca é o caminho feliz
Integração funciona bem no teste. O problema aparece quando o provedor responde diferente do que documentou, quando a chamada dá timeout depois de já ter cobrado, quando o webhook chega duas vezes, ou quando chega fora de ordem. Integração séria é sobre o que acontece quando dá errado — porque vai dar.
O que está incluso
-
Cobrança que não duplica
Chave de idempotência em cada operação. Reenvio do provedor nunca vira segunda cobrança no cartão do cliente.
-
Webhook confiável
Recebimento, validação de assinatura, tolerância a entrega repetida e fora de ordem, e fila para reprocessar o que falhou.
-
Conciliação
O que o gateway diz que aconteceu bate com o que o seu sistema registrou. Quando não bate, o relatório mostra.
-
Retry com critério
Nem toda falha deve ser repetida. Erro de rede sim; recusa do banco não. A diferença evita cobrança indevida.
-
APIs REST e gRPC próprias
Quando é você quem precisa expor. Versionamento, autenticação, limite de uso e documentação.
-
Conexão com ERP e legado
Inclusive sistema antigo que só fala por arquivo ou banco. Já vi de tudo.
Por que comigo
Trabalho com APIs de saque e depósito, gateways de pagamento, split, emissão de nota fiscal e verificação de identidade em sistemas onde o dinheiro é de verdade. Idempotência, log de auditoria e tratamento de falha parcial não são enfeite nesse contexto — são o que impede prejuízo.
Perguntas frequentes
Trabalham com qual gateway?
Com o que fizer sentido para o seu caso. Já integrei vários e o padrão é parecido; o que muda é a documentação e as peculiaridades de cada um.
E se o provedor não tiver documentação decente?
Acontece bastante. A saída é testar contra o ambiente de homologação e mapear o comportamento real, que às vezes difere do papel.
Dá para integrar sistema antigo que não tem API?
Quase sempre. Banco de dados, arquivo, e-mail automatizado ou até tela — existe caminho. Alguns são feios, mas funcionam e são honestos sobre o custo de manutenção.
Quem cuida quando o provedor muda a API?
Se houver contrato de manutenção, eu. Senão, entrego documentado para o seu time conseguir ajustar.
Descreva o que você precisa
Briefing de dois minutos. Respondo em até um dia útil, eu mesmo.