← Todos os estudos de caso
PT

Estudo de caso · checkout e pagamentos

Um checkout headless na VTEX

Um checkout headless de alto volume na VTEX, para uma operação de e-commerce que já transacionou mais de R$3 bilhões na plataforma. Meu trabalho era no nível de feature, e a maior parte dele ficou no lado voltado ao cliente: evoluir o fluxo, guiar o cliente por ele e evoluir ou criar os endpoints que o fluxo precisava.

Contexto

Um checkout headless na VTEX. A vitrine é construída pelo time, o carrinho e o pedido vivem no orderForm da VTEX e são acessados pela Checkout API, e em volta desse núcleo ficam as partes que a plataforma é dona: fluxos de conversão, pagamentos, pedidos e autenticação para vários lojistas e lojas virtuais.

Essa divisão coloca boa parte do resultado no front-end. As regras de negócio do carrinho são da VTEX; como o cliente é guiado por elas, o que a tela diz quando algo falha e quantos passos e quanto ruído existem entre um carrinho cheio e um pedido pago são nossos. Em um checkout, essa diferença é receita.

Problema

Minha responsabilidade

Evoluir features e endpoints existentes, criar novos endpoints quando a feature exigia (seguindo os padrões arquiteturais já estabelecidos pelo time), consumir essas APIs no front-end e escrever testes. A maior parte do que eu fiz ficou no lado voltado ao cliente: guiar o cliente pelo fluxo, tirar passos e ruído, e manter as telas de pagamento e autenticação usáveis para todo mundo.

O que eu trabalhei

Como eu abordei

Antes de escrever qualquer coisa eu lia os outros endpoints do mesmo serviço e seguia as convenções deles (nomenclatura, formato de erro, validação), porque consistência é o que torna uma API aprendível. Em mudanças de contrato, eu tratava os consumidores existentes como restrição: estender em vez de redefinir, e manter o comportamento anterior válido. Como a mesma mudança costuma atravessar back-end e front-end, eu trabalhava dos dois lados do contrato em vez de entregar um formato que ninguém tinha validado. E para tudo que tocava dinheiro ou estado de pedido, os testes vinham antes de a mudança entrar.

Desafios

Decisões e trade-offs

Resultado

Features entregues em um caminho crítico de receita, a maior parte delas na camada de experiência do checkout. A escala em volta: mais de R$3 bilhões transacionados na plataforma.

O que aprendi