Pagamentos na Prática

Procure conteúdo sério sobre pagamentos em Rails no contexto brasileiro e você não vai achar quase nada.

A documentação dos gateways te mostra o caminho feliz. Mas o que ninguém te conta é o que acontece quando o dinheiro começa a circular de verdade: a assinatura que entra em past_due, o webhook que chega duplicado, e a NF-e que virou problema seu. É exatamente disso que esta edição do Offstack trata.

Esse não é um tutorial de “como usar a gem Pay”. Você vai pensar pagamentos desde o modelo de domínio — Customer, Subscription, Charge, Plan — até escolher gateway com critério e montar o pipeline de eventos que aguenta o uso real de produção. A Pay aparece, mas só depois que você entender o que ela está abstraindo. No dia em que algo der errado, você saberá como consertar.

Você passa por quatro aulas, nessa ordem: os conceitos que se repetem em todo gateway, independente da implementação; a arquitetura gem-agnóstica (modelos de domínio, abstração de gateway, recebimento de eventos com HMAC e idempotência, PCI sem virar especialista em compliance); a tradução disso tudo com Pay + Stripe; e o que o mercado brasileiro tem de próprio.

A parte brasileira é onde mora a escassez, e é onde você vai gastar tempo: comparação real entre os players brasileiros, parcelamento, MDR e antecipação; Pix à vista e recorrente; boleto, que insiste em não morrer; antifraude no contexto BR; e o motivo de tanto SaaS brasileiro sofrer com pagamentos — a NFS-e como responsabilidade sua.

E você implementa tudo isso num projeto prático que a gente constrói no decorrer das aulas: o Cronos, um time tracker para freelancers. Nada de exemplo de slide! O que você vê é integração real, incluindo o tipo de bug que dá muita dor de cabeça, que a documentação descreve de um jeito e no mundo real o gateway entrega de outro.

No fim, você saberá como pensar e implementar pagamentos em qualquer projeto Rails. Isso é tudo que uma documentação técnica não te mostra.