Pagamentos em sistemas web: o guia

O que aprendi integrando gateways como Stripe, Pagar.me e Asaas: webhooks que não cobram duas vezes, split entre recebedores, estornos, conciliação e as armadilhas que só aparecem em produção.

7 textos neste guia

1. 01 nov 2026 · 11 min Estorno parcial com split de pagamento no Laravel: quem devolve quanto e quando Como modelar estorno parcial em vendas com split: alocação proporcional sem perder centavo, teto do valor estornável, taxa do gateway e recebedor que já sacou.
2. 30 out 2026 · 12 min Agenda de recebíveis no Laravel: como modelar parcelas do cartão, D+30 e antecipação Uma venda parcelada no cartão são N recebíveis com data, taxa e status próprios. Mostro como modelar a agenda no Laravel, calcular D+30 e antecipar.
3. 24 out 2026 · 10 min Chargeback no Laravel: como modelar disputas, reter saldo e não perder o prazo de defesa Chargeback não é estorno. Ele exige tabela própria, estados que só andam para frente, retenção de saldo no ledger e controle rígido do prazo para mandar a defesa.
4. 12 out 2026 · 9 min Timeout ao chamar o gateway de pagamento: como evitar cobrança duplicada com Idempotency-Key no Laravel Timeout numa cobrança não quer dizer falha, quer dizer estado desconhecido. Veja como usar chave de idempotência, tentativas persistidas e um job de resolução no Laravel.
5. 09 out 2026 · 8 min Conciliação de pagamentos no Laravel: como bater o extrato do provedor com o seu banco todo dia Webhook não garante que seu banco reflete o que o provedor processou. Veja como montar uma conciliação diária no Laravel com upsert, FULL OUTER JOIN e fila de divergências.
6. 09 out 2026 · 6 min Split de pagamento sem perder centavos: como dividir valores e estornos no Laravel Como dividir um pagamento entre vários recebedores sem perder nem criar centavos: inteiros, método do maior resto, regra explícita para o resto e estorno parcial rateado sobre o saldo.
7. 09 out 2026 · 7 min Webhooks de pagamento duplicados e fora de ordem: como processar cada evento uma única vez no Laravel Gateways reenviam webhooks e nem sempre na ordem certa. Veja como combinar chave única, lock por pagamento e máquina de estados para nunca creditar duas vezes.